Pomoc:Znaczniki
|
- Dla zaawansowanych
- Te informacje dotyczą edytora wikikodu. Brak analogicznych dotyczących edytora wizualnego (Czym to się różni?)
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.
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.
Wielu znaczników nie należy stosować w 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ącą 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ć.
Znaczniki Mediawiki[edytuj | edytuj kod]
Znacznik | Zastosowanie / Przykład użycia / Efekt / Uwagi |
---|---|
<poem> | Zastosowanie: Formatuje tekst tak, jakby w każdym wierszu wstawiony został znacznik nowej linii (<br /> ), ponadto zachowuje spacje na początku wersów
|
<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 | |
Uwagi: Stosuje się go w przypadku wstawiania fragmentów wierszy i innych krótkich tekstów literackich opisywanych w artykułach. Można też, zwłaszcza w przypadku tekstów niepolskojęzycznych, zastosować szablon {{Tekst utworu}}. | |
<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
</gallery>
| |
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}}
| |
Przypisy wstawiamy w artykułach, używając znaczników i szablonu {{Przypisy}}[1]. Używanie przypisów jest zalecane[2]
| |
Uwagi: Więcej na stronie Pomoc:Przypisy | |
<syntaxhighlight lang="kod języka"> | Zastosowanie: Powoduje kolorowanie składni według reguł języka podanego w parametrze lang. |
<syntaxhighlight lang="cpp">void witajSwiecie(int powtorzenia) { for (; powtorzenia; powtorzenia--) { std::cout << "Witaj świecie!" << endl; } }</syntaxhighlight> | |
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 „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 niewyś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>
| |
<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[edytuj | edytuj kod]
Dopuszczalne znaczniki XHTML[edytuj | edytuj kod]
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
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ą pustą 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> | |
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 metastronach 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> |
|
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 metastronach. | |||
<!-- … --> | 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[edytuj | edytuj kod]
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.
Znacznik(-i) | Zamiennik(-i) | Uwagi |
---|---|---|
= nagłówek 1 =
== nagłówek 2 ==
|
Nagłówki stanowią nie tylko wyróżnienie, ale 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. | |
<poem>, <syntaxhighlight>
|
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>, <syntaxhighlight>. Jeśli chce się uzyskać ramkę, to (podobnie jak powyżej) można zastosować znacznik <span> lub <div> wraz z odpowiednimi stylami CSS. Więcej na stronie Pomoc:Formatowanie tekstu | |
<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. | |
'''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. | |
''kursywa''
|
Do pochylenia tekstu (kursywa, italiki) zaleca się stosować składnię podaną obok. Prawidłowe pochylenie można zastosować do zaznaczonego tekstu naciskając nad oknem edycji. | |
<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. | |
|
{| |
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). |