Pomoc:Znaczniki

Skrót: WP:ZN

Na tej stronie znajduje się lista znaczników, które są często spotykane w Wikipedii. Dzielą się one na znaczniki specyficzne tylko dla MediaWiki (nie są rozpoznawane przez przeglądarkę bez przetworzenia) i znaczniki (X)HTML. Znaczniki MediaWiki są wyróżnione grafiką .

Wiele znaczników XHTML, mimo że można je spotkać w artykułach Wikipedii, jest zdecydowanie niezalecanych i gdy się je zauważy należy je zmienić na wikikod. Oprócz tego wielu znaczników nie należy stosować w głównej przestrzeni nazw (tzn: w zwykłych artykułach encyklopedycznych). Przy tego rodzaju znacznikach umieszczony został znak: .

Znaczniki mają postać <xxx>. Warto pamiętać, że dla znacznej części z nich, gdy formatujemy tekst, należy też użyć "zamknięcia" poprzez użycie tego znacznika w postaci </xxx> na końcu formatowanego tekstu. Dla tego typu znaczników w poniższej tabelce przedstawiamy obie formy - otwierającą i zamykająca formatowanie.

Ta strona pełni przede wszystkim rolę szybkiej ściągi dla osób, które zapomniały jak wygląda znacznik, którego chciałby użyć w artykule, portalu czy na stronie meta.

Znaczniki Mediawiki

Znaczniki specyficzne dla MediaWiki

Znacznik	Zastosowanie / Przykład użycia / Efekt / Uwagi
<poem>	Zastosowanie: Formatuje tekst tak jakby w każdym wierszu wstawiony został znacznik nowej linii (<br />)
	<poem> To jest wiersz o znaczniku Co się poem nazywa Nie powstał by w Kórniku Ale i tak bywa... </poem>
	To jest wiersz o znaczniku Co się poem nazywa Nie powstał by w Kórniku Ale i tak bywa...
	Uwagi: Stosuje się go w przypadku wstawiania fragmentów wierszy i innych krótkich tekstów literackich opisywanych w artykułach.
<gallery>	Zastosowanie: Ułatwia stworzenie galerii obrazków
	<gallery> Plik:Eye iris.jpg Plik:Wild Boar Habbitat 2.jpg|Podpis pod obrazkiem Plik:Wikipedia-logo.png|Ogólne logo Wikipedii Plik:Wikipedia-logo-pl.png|Logo polskiej Wikipedii </gallery>
	Podpis pod obrazkiem Ogólne logo Wikipedii Logo polskiej Wikipedii
	Uwagi: Używane czasami w Wikipedii do tworzenia minigalerii. W większości wypadków lepiej jest dodać link do Commons, w którym można stworzyć osobną stronę na galerię.
<ref>	Zastosowanie: Stosowany przy tworzeniu przypisów w tekście
	''Przypisy wstawiamy w artykułach, używając znaczników i szablonu {{S|Przypisy}}''<ref>szablon wstawiamy na dole artykułu nad sekcją bibliografia</ref>. Używanie przypisów jest zalecane<ref>Zobacz na stronę [[Wikipedia:Weryfikowalność]]</ref> {{Przypisy}}
	Przypisy wstawiamy w artykułach, używając znaczników i szablonu {{Przypisy}}. Używanie przypisów jest zalecane Przypisy == Przypisy ==
	Uwagi: Więcej na stronie Pomoc:Przypisy
<source lang="kod języka">	Zastosowanie: Powoduje kolorowanie składni według reguł języka podanego w parametrze lang.
	<​source lang="cpp">void witajSwiecie(int powtorzenia) { for (; powtorzenia; powtorzenia--) { std::cout << "Witaj świecie!" << endl; } }<​/source>
	void witajSwiecie(int powtorzenia) { for (; powtorzenia; powtorzenia--) { std::cout << "Witaj świecie!" << endl; } }
	Uwagi: Stosowane do listingów kodów programów. Dostępne języki to: actionscript, ada, apache, applescript, asm, asp, autoit, bash, blitzbasic, bnf, c, c_mac, caddcl, cadlisp, cfdg, cfm, cpp, cpp-qt, csharp, css, d, delphi, diff, div, dos, eiffel, fortran, freebasic, gml, groovy, html4strict, idl, ini, inno, io, java, java5, javascript, latex, lisp, lua, matlab, mirc, mpasm, mysql, nsis, objc, ocaml, ocaml-brief, oobas, oracle8, pascal, perl, php, php-brief, plsql, python, qbasic, rails, reg, robots, ruby, sas, scheme, sdlbasic, smalltalk, smarty, sql, tcl, text, thinbasic, tsql, vb, vbnet, vhdl, visualfoxpro, winbatch, xml, xpp, z80. Szczegóły na stronie rozszerzenia.
<nowiki>	Zastosowanie: Powoduje, że wszelkie interpretowanie kodu wiki zostaje "wyłączone"
	<nowiki>tu '''po wpisaniu'''<br>nic się <u>nie dzieje</u></nowiki>
	tu '''po wpisaniu'''<br>nic się <u>nie dzieje</u>
	Uwagi: Stosujemy, gdy chcemy np. pokazać,jak działają znaczniki :) Kliknij w edytuj na tej stronie, by zobaczyć więcej.
<noinclude>	Zastosowanie: Ukrywanie fragmentów szablonu przy jego wywołaniu.
	Treść szablonu<noinclude> Informacje dla wstawiających nie wyświetlane przy wstawianiu szablonu w treści artykułu.</noinclude>
	Tekst w znacznikach noinclude nie pojawia się na stronach, gdzie szablon został użyty. Będzie widoczny tylko na stronie szablonu.
	Uwagi: Stosujemy w celu wyjaśnienia np. jak należy używać szablonu. W szablonach dodajemy w ten sposób także kategorię, do której ma być on dopisany.
<includeonly>	Zastosowanie: Ukrywanie fragmentów szablonu na stronie szablonu.
	Treść szablonu<includeonly> [[Kategoria:Dla artykułu do którego wstawiono szablon]]</includeonly>
	Tekst w znacznikach includeonly pojawi się jedynie na stronie, do której został wstawiony. Nie pojawi się za to na stronie szablonu.
	Uwagi: Stosujemy najczęściej do dodawania kategorii w artykułach, w których szablon będzie użyty.
<onlyinclude>	Zastosowanie: Określenie który fragment ma być widoczny przy wywołaniu szablonu.
	<onlyinclude>Treść szablonu</onlyinclude> Informacje dla wstawiających nie wyświetlane przy wstawianiu szablonu w treści artykułu.
	Jeśli znacznik zostanie użyty w szablonie, to tylko tekst zawarty w znacznikach onlyinclude pojawi się na stronie, do której zostanie wstawiony ten szablon.
	Uwagi: Użycie znacznika onlyinclude powoduje, że ignorowana jest także treść znacznika includeonly.
<inputbox>	Zastosowanie: Wstawienie prostego formularza umożliwiającego np. tworzenie nowego artykułu.
	<inputbox>type=create</inputbox>
	Uwagi: Bardziej szczegółowy opis na stronie: Wikipedia:InputBox
<categorytree>	Zastosowanie: Wyświetla w tekście drzewko kategorii w dół od danej kategorii.
	<categorytree>Chemia</categorytree>
	[−] Chemia [×] Strony przeglądowe - chemia [+] Aparatura chemiczna [+] Atomy [+] Bezpieczeństwo chemiczne [+] Broń chemiczna [+] Chemia kwasów i zasad [+] Chemicy [+] Literatura chemiczna [+] Nauki chemiczne [×] Nomenklatura chemiczna [+] Organizacje chemiczne [+] Prawa i równania chemiczne [+] Przemysł chemiczny [+] Reakcje chemiczne [+] Substancje chemiczne [×] Układ okresowy [+] Wiązania chemiczne [×] Wydziały chemii [×] Właściwości chemiczne
	Uwagi: Nie zaleca się stosować w treści artykułów, ewentualnie w portalach i na stronach meta.
<timeline>	Zastosowanie: Tworzy i wyświetla wykres zdarzeń w czasie.
	<timeline> # Miesiące roku # (nawiasem mówiąc po # jest komentarz) TimeAxis = orientation:horizontal # oś czas - pozioma ImageSize = width:600 height:100 # wielkość obrazka PlotArea = left:100 top:10 bottom:10 right:10 # marginesy (liczone od osi) DateFormat = dd/mm/yyyy # format daty Period = from:01/01/2000 till:31/12/2000 # okres czasu jaki obejmuje wykres ScaleMinor = unit:month increment:3 start:01/03/2000 # podziałka # Tu ustalamy kolejność inną niż wynikającą z poniższych danych # i dodajemy inny tekst na osi. # Można też dodać link. BarData= bar:długie text:długie miesiące bar:krótkie text:krótkie miesiące bar:nt text:nietypowe link:http://pl.wikipedia.org/wiki/Rok_przest%C4%99pny # Dane do wykresu PlotData= bar:długie from:01/01/2000 till:31/01/2000 text:I bar:nt from:01/02/2000 till:28/02/2000 text:II bar:długie from:01/03/2000 till:31/03/2000 text:III bar:krótkie from:01/04/2000 till:30/04/2000 text:IV bar:długie from:01/05/2000 till:31/05/2000 text:V bar:krótkie from:01/06/2000 till:30/06/2000 text:VI bar:długie from:01/07/2000 till:31/07/2000 text:VII bar:długie from:01/08/2000 till:31/08/2000 text:VIII bar:krótkie from:01/09/2000 till:30/09/2000 text:IX bar:długie from:01/10/2000 till:31/10/2000 text:X bar:krótkie from:01/11/2000 till:30/11/2000 text:XI bar:długie from:01/12/2000 till:31/12/2000 text:XII </timeline>
	Uwagi: Więcej na Pomoc:Timeline oraz mw:Extension:EasyTimeline

Znaczniki (X)HTML

Dopuszczalne znaczniki XHTML

Poniżej podane są znaczniki "tolerowane". Oznacza to, że nie są co prawda zalecane, ale można je stosować, gdy podobnego efektu nie da się uzyskać w ramach formatowania MediaWiki.

Tolerowane znaczniki XHTML

Znacznik	Zastosowanie	Przykład użycia	Efekt
<br/>	Przeniesienie tekstu do nowego wiersza	to jest tekst<br/>a tu tekst w nowej linii	to jest tekst a tu tekst w nowej linii
	Uwagi: Nie należy używać tego znacznika do tworzenia nowych akapitów w tekście - zamiast tego należy zostawić jedną wolną linię! Użycie <br/> jest dopuszczalne jedynie w tabelach i szablonach, gdzie wstawianie nowego akapitu nie jest wskazane.
<small>	Zmniejszenie wielkości czcionki	<small>To jest tekst, którego czcionka została zmniejszona</small>	To jest tekst, którego czcionka została zmniejszona
	Uwagi: Nie zaleca się stosować w treści artykułów, ewentualnie w tabelach, chociaż w wielu wypadkach lepszym wyjściem jest użycie stylów (style="font-size:90%").
<big>	Zwiększenie wielkości czcionki	<big>To jest tekst, którego czcionka została zwiększona</big>	To jest tekst, którego czcionka została zwiększona
	Uwagi: Nie zaleca się stosować w artykułach - w tabelach i portalach można użyć znacznika "span" lub "div" z odpowiednimi parametrami CSS lub po prostu dodanie stylu do komórki. Dzięki temu ma się większą kontrolę nad wyglądem strony.
<del>	Przekreślenie tekstu	<del>ten tekst został wykreślony</del>	ten tekst został wykreślony
	Uwagi: Stosuje się na stronach dyskusji, czy głosowaniach, np. do wykreślenia własnych, wcześniejszych uwag. Nie zaleca się używać znaczników <strike> </strike> oraz <s> </s>
<u>	Podkreślenie tekstu	<u>ten tekst został podkreślony</u>	ten tekst został podkreślony
	Uwagi: Stosuje się na stronach meta, wikiprojektach, dla podkreślenia ważnych treści. Nie należy stosować do podkreślenia własnego zdania.
<blockquote>	Oznacza, że dany tekst jest cytatem (długim).	<blockquote>Długi cytat</blockquote>	Długi cytat
	Uwagi: Tekst zostanie przesunięty w prawo. Więcej na ten temat W artykułach zaleca się stosować szablon {{Cytat}}
<code>	Wyróżniania fragmenty kodu programu.	<code>var zmienna = "wartosc"</code>	var zmienna = "wartosc"
	Uwagi: Więcej na ten temat
<div>	Tworzy element blokowy, który może zawierać tekst, grafikę, inne znaczniki. <div></div> spowoduje umieszczenie całego bloku w nowej linii, oddzielając od pozostałych elementów poprzedzających i następujących po nich. Dodatkowo za pomocą parametru style="" i języka CSS można w dowolny sposób sformatować i umiejscowić cały blok.	tekst poprzedzający znaczniki <div style="text-align: center;">tekst wyśrodkowany</div> tekst następujący po znacznikach	tekst poprzedzający znaczniki tekst wyśrodkowany tekst następujący po znacznikach
	Uwagi: Podany przykład wyśrodkowania zaleca się używać, zamiast znaczników <center></center>. Więcej na temat "div" tu i tu.
<span>	Element liniowy, za pomocą parametru style="" i języka CSS można zdefiniować wygląd fragmentu tekstu, najczęściej kolor czcionki.	tekst przed <span style="color:red">Dowolny tekst</span> tekst po	tekst przed Dowolny tekst tekst po
	Uwagi: Jego stosowanie nie jest zalecane w artykułach, ewentualnie w tabelach. Do zastosowania w portalach lub w niektórych przypadkach na stronach meta.
<!--, -->	Oznakowanie komentarza. Tekst zawarty między tymi znacznikami nie będzie widoczny na ekranie, ale nadal będzie w kodzie artykułu.	komentarza nie <!-- To jest komentarz --> widać :-)	komentarza nie widać :-)
	Uwagi: Przydaje się do ukrywania fragmentów haseł, nad którymi się aktualnie pracuje (np. tekstów obcojęzycznych w trakcie tłumaczenia).

Znaczniki do podmiany

Poniżej podajemy popularne znaczniki, których w ogóle nie należy stosować w Wikipedii - nie tylko w artykułach. W opisie podajemy ich zamienniki, które należy stosować zamiast nich. Zobacz też: Pomoc:Używanie kodu HTML.

Zamienniki popularnych znaczników (X)HTML

Znacznik(-i)	Zamiennik(-i)	Uwagi
<h1>, <h2>, ...	= nagłówek 1 = == nagłówek 2 ==	Nagłówki stanowią nie tylko wyróżnienie, ale na także na ich podstawie budowany jest spis treści, a oprogramowanie umożliwia edycję dane sekcji. W wypadku chęci wyróżnienia tekstu można go '''pogrubić''' lub zastosować znacznik <span> lub <div> wraz z odpowiednimi stylami CSS.
<pre>	<poem>, <source>	Tekst wstępnie sformatowany można uzyskać stosując podane wyżej znaczniki MediaWiki. Znaczniki te mają tą przewagę, że ich użycie określa jednocześnie rodzaj zawartości. Stąd zależnie od kontekstu należy użyć <poem>, <source>. Jeśli chce się uzyskać ramkę, to (podobnie jak powyżej) można zastosować zastosować znacznik <span> lub <div> wraz z odpowiednimi stylami CSS. Więcej na stronie Pomoc:Formatowanie tekstu
<center>	<div style="text-align:center">	Zależnie od kontekstu można zamiast tego zastosować znacznik <div>, lub po prostu dodać odpowiedni styl do innego użytego elementu.
<b>	'''pogrubione'''	Do pogrubienia zaleca się stosować jeden z podstawowych elementów składni MediaWiki podany obok. Prawidłowe pogrubienie można zastosować do zaznaczonego tekstu naciskając nad oknem edycji.
<i>	''kursywa''	Do pochylenia tekstu (kursywa, italiki) zaleca się stosować składnię podaną obok. Prawidłowe kursywę można zastosować do zaznaczonego tekstu naciskając nad oknem edycji.
<s> i <strike>	<del></del>	W większości wypadków zalecane jest stosowanie znacznika posiadającego również znaczenie semantyczne (a nie tylko formatujące). Znacznik <del> (z ang. delete) jest stosowany do "kasowania" i jest zalecany do wykreślania własnych wypowiedzi w dyskusji.
<table>, <caption>, <tr>, <th>, <td>	{|, |+, |-, !, |	Tabelki należy wstawiać według formatowania MediaWiki. Szczegółowe informacje na ten temat znajdują się na stronie Pomoc:Tabele (zob. sekcję Informacje dla osób znających znaczniki (X)HTML).
<a>	[[]], [], {{Cytuj stronę}}	Linki należy wstawiać według formatowania MediaWiki.

Zobacz też

• Pomoc:Magiczne słowa
• meta:Help:Wikitext examples (ang.)
• meta:Help:HTML in wikitext (ang.)