--=REKLAMA=--

Pomoc

Znaczniki

Z Joomla!WikiPL

Na tej stronie znajduje się lista znaczników stosowanych na Joomla!WikiPL. Dzielą się one na:

  • znaczniki MediaWiki, specyficzne tylko dla oprogramowania MediaWiki; wyróżniliśmy je grafiką MW,
  • znaczniki (X)HTML.

Oprogramowanie MediaWiki przetwarza znaczniki specyficzne na rozpoznawany przez przeglądarki kod (X)HTML

Ikona informacja.png
 Informacja

 Znaczniki (X)HTML stosujemy tylko wówczas, gdy potrzebnego efektu nie można uzyskać za pomocą kodu Mediawiki. Ponadto wielu znaczników nie należy stosować w głównej przestrzeni nazw. 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

Mediawiki.png Znaczniki specyficzne dla MediaWiki
Znacznik Zastosowanie
MW <gallery> tworzy mini galerię obrazków. Zamiast mini galerii można stworzyć galerię, dodając link do Commons.
MW <ref> tworzy przypis. Zobacz więcej: Pomoc:Przypisy
MW <source lang="kod języka"> koloruje składnię według reguł języka podanego w parametrze lang. Zobacz więcej: Pomoc:Przypisy
! MW <nowiki> Wyłącza interpretowanie kodu wiki. Stosujemy, gdy chcemy np. pokazać,jak działają znaczniki.
! MW <noinclude> Przy wywołaniu szablonu ukrywa objętą znacznikiem treść. Na stronie szablonu natomiast treść objęta znacznikiem będzie widoczna.
! MW <includeonly> Wywołuje treść tylko na stronach, na które szablon został dodany. Natomiast na stronie szablonu treść objęta znacznikiem nie będzie widoczna.
! MW <inputbox> Wywołuje szablon z polem umożliwiającym po wpisaniu utworzenie nowego artykułu, czy strony meta
! MW <categorytree> wyświetla w tekście drzewko kategorii w dół od danej kategorii. Nie zaleca się stosować w treści artykułów, ewentualnie w portalach i na stronach meta.

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
! <br /> Przeniesienie tekstu do nowego wiersza
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
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
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
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
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).
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.
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.
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.
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.
Uwagi: Przydaje się do ukrywania fragmentów haseł, nad którymi się się aktualnie pracuje (np: tekst obcojęzycznych w trakcie tłumaczenia).

Znaczniki do podmiany

Poniżej podajemy popularne znaczniki, których w ogóle nie należy stosować w Joomla!WikiPL - 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 B 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 I 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).



Zobacz też