Pomoc:Znaczniki: Różnice pomiędzy wersjami

Z Nonsensopedii, polskiej encyklopedii humoru
M (usuwam informację o konkretnej skórce, bo w przyszłości może się znowu zmienić)
(iii zmiana)
Linia 1: Linia 1:
{{Pomoc nagłówek|Zaawansowane}}
{{Pomoc nagłówek|Zaawansowane}}
'''Znaczniki''' (inaczej tagi) to funkcje języka XML. Na Nonsensopedii można używać niektórych znaczników stosowanych powszechnie w ramach języka HTML. Dostępne są również dodatkowe znaczniki, specyficzne dla składni MediaWiki.
Znaczniki (inaczej tagi) pozwalają na wstawianie na Nonsensopedię specjalnych elementów oraz zmianę sposobu, w jaki oprogrogramowanie Nonsensopedii będzie traktować kod wikitekstu. Na Nonsensopedii można używać niektórych znaczników stosowanych powszechnie w ramach języka HTML. Dostępne są również dodatkowe znaczniki, specyficzne dla składni MediaWiki.


Podczas używania znaczników należy pamiętać, że choć można wstawiać znaczniki wewnątrz znaczników, to nie mogą się one przeplatać, to znaczy coś takiego:<br />
Niektóre znaczniki są względem siebie równoważne i teoretycznie można używać obu z nich, jednak z różnych powodów często jeden z nich jest preferowany w kodzie względem drugiego.
<code><nowiki><znacznik1><znacznik2>mlem</znacznik2></znacznik1></nowiki></code><br />
jest dozwolone, ale już:<br />
<code><nowiki><znacznik1><znacznik2>błąd!</znacznik1></znacznik2></nowiki></code><br />
nie jest.



== Znaczniki MediaWiki ==
== <nowiki><poem></nowiki> ==
{| border="2" cellpadding="4" cellspacing="0" style="margin: 1em 1em 1em 0; background: #f9f9f9; border: 1px #aaa solid; border-collapse: collapse; font-size: 95%;"
<code><nowiki><poem></nowiki></code> to znacznik pozwalający na przeniesienie tekstu do nowej linii zwyczajnym enterem (znakiem nowej linii), bez konieczności używania HTML-owego <nowiki><br /></nowiki> bądź tworzenia nowego akapitu poprzez naciśnięcie entera dwukrotnie.
|-

! Znacznik
'''Przykładowo''', następujący kod:<br />
! Użycie
<syntaxhighlight lang="xml">
! Uwagi
|-
!<tt><nowiki><poem></nowiki></tt>
|<syntaxhighlight lang="xml">
<poem>
<poem>
Oto Królestwo między dwoma rzeki,
Pojechał raz kmiotek na Berdyczów
Mamy bogate w humor biblioteki.
Zobaczyć dziedzictwo Rurykowiczów
Widać jadących wojów hen, z oddali,
Wróciwszy zaniósł się krzykiem
Znów odeprzemy najazdy wandali.
Nie ma pieprzonych znaczników!
</poem>
</poem>
</syntaxhighlight>
</syntaxhighlight>
zostanie ładnie wyświetlony w poniższej formie:
|Stosuje się go w przypadku wstawiania fragmentów wierszy i innych krótkich tekstów literackich opisywanych w artykułach. Faktultatywnie w przypadku tekstów stylizowanych na literackie.
<poem>
|-
Oto Królestwo między dwoma rzeki,
!<tt><nowiki><gallery></nowiki></tt>
Mamy bogate w humor biblioteki.
|<syntaxhighlight lang="xml">
Widać jadących wojów hen, z oddali,
Znów odeprzemy najazdy wandali.
</poem>

Bez użycia znacznika poem, wszystkie linie zlałyby się w jedną, oddzielone jedynie spacjami. Warto również zaznaczyć, że w jego wnętrzu wciąż można formatować tekst.

'''Uwaga!''' Ze względów technicznych, na stronach w całości składających się z tekstu (na przykład w Nonźródłach) zaleca się stosowanie szablonu {{s|Pasta}}, który pozwala na taki sam efekt, ale nie wyłącza podglądu artykułów po najechaniu kursorem na link.

== <nowiki><ref></nowiki> ==
Znacznik <code><nowiki><ref></nowiki></code> służy do wstawiania przypisów.

'''Przykład''':<br />
<code><nowiki>Przypisy wstawiamy w artykułach, używając znaczników i szablonu Przypisy.<ref>Na ich końcu nie stawiamy jednak kropek</ref></nowiki></code>

'''Efekt:''' Przypisy wstawiamy w artykułach, używając znaczników i szablonu Przypisy.<ref>Na ich końcu nie stawiamy jednak kropek</ref>

'''Uwaga!''' Jeśli artykuł do którego chcesz wstawić przypis nie ma jeszcze innych przypisów, pod jego koniec (ale przed kategoriami i szablonami nawigacyjnymi) należy wstawić szablon {{s|Przypisy}}. Więcej o przypisach możesz dowiedzieć się [[Nonsensopedia:Formatowanie#Przypisy|na tej stronie]].

== <nowiki><nowiki></nowiki> ==
Użycie tego znacznika każe oprogramowaniu Nonsensopedii traktować tekst pomiędzy rozpoczynającym <nowiki><nowiki></nowiki> a <nowiki></nowiki></nowiki> jako zwykły tekst, nie jako kod MediaWiki. Oznacza to, że wszystko znajdujące się wewnątrz tego znacznika zostanie wyświetlone tak, jak wygląda w edytorze kodu, nie zostaną wywołane szablony, nie wyświetlą się grafiki, nie będą działały znaczniki pogrubienia czy pochylenia, i tak dalej.

Znacznik ten stosuje się zazwyczaj wtedy, gdy chce się zaprezentować wikitekst bez uruchamiania go, na przykład w tym poradniku.

'''Przykład:''' <syntaxhighlight lang="xml"><nowiki>dans dans dans '''mlem''' <del>uwielbiam [[schabowy]] z żurkiem</del> {{s|Motoryzacja}}</nowiki></syntaxhighlight>

'''Efekt:''' <nowiki>dans dans dans '''mlem''' <del>uwielbiam [[schabowy]] z żurkiem</del> {{s|Motoryzacja}}</nowiki>

'''Efekt bez zastosowania nowiki:''' dans dans dans '''mlem''' <del>uwielbiam [[schabowy]] z żurkiem</del> {{s|Motoryzacja}}

== <nowiki><gallery></nowiki> ==
Pozwala na tworzenie minigalerii zdjęć w artykule. Aby go użyć, po prostu wstaw do środka nazwy obrazków (bez przedrostka – nazwy przestrzeni – Plik:) oddzielonych nową linią. Możesz również dodać opis grafiki po znaku „|”.

'''Przykład:'''
<syntaxhighlight lang="xml">
<gallery>
<gallery>
Alarm invalid.jpg
Alarm invalid.jpg
Drill sergeant screams.jpg
Intercity paper seats.jpg
Koniec pociągu śpiewa.jpg|Koniec pociągu tańczy i śpiewa
Koniec pociągu śpiewa.jpg|Koniec pociągu tańczy i śpiewa
</gallery>
</gallery>
</syntaxhighlight>
</syntaxhighlight>
'''Efekt:'''
|Pomoc przy tworzenia minigalerii zdjęć związanych z danym artykułem. Więcej informacji o wstawianiu galerii grafik znajdziesz na [[Pomoc:Wstawianie grafik#Zwykła galeria|tej stronie pomocy]].
<gallery>
|-
Alarm invalid.jpg
!<tt><nowiki><ref></nowiki></tt>
Drill sergeant screams.jpg
|<syntaxhighlight lang="xml">Przypisy wstawiamy w artykułach, używając
Koniec pociągu śpiewa.jpg|Koniec pociągu tańczy i śpiewa
znaczników i szablonu {{Przypisy}}. Na ich końcu nie stawiamy jednak kropek.
</gallery>
</syntaxhighlight>

|Przykłady poprawnego wstawiania przypisów odnajdziesz [[Nonsensopedia:Formatowanie#Przypisy|tu]].
Więcej informacji o wstawianiu galerii grafik znajdziesz na [[Pomoc:Wstawianie grafik#Zwykła galeria|tej stronie pomocy]].
|-

!<tt><nowiki><nowiki></nowiki></tt>

|<syntaxhighlight lang="xml"><nowiki>tu po wpisaniu <del>nic się nie dzieje</nowiki></syntaxhighlight>
== <nowiki><noinclude></nowiki> ==
|Wyłączona interpretacja kodu wiki w celu informacji nt. skorzystania z innego znacznika lub szablonu.
Zawartość tego znacznika nie zostanie użyta w miejscu transkludowania strony, na której się znajduje. Oznacza to po prostu, że wyświetli się jedynie na stronie, do której została bezpośrednio dodana; gdy ktoś umieści ową stronę na innej w taki sposób, w jaki używa się szablonów, rzeczy umieszczone wewnątrz tego znacznika się tam nie pojawią.
|-

!<tt><nowiki><noinclude></nowiki></tt>
'''Na przykład''', jeśli utworzymy szablon o nazwie Kabanos, i wstawimy do niego poniższą treść:
|<syntaxhighlight lang="xml">Treść szablonu<noinclude>

Informacje dla wstawiających, które nie są wyświetlane przy wstawianiu szablonu.</noinclude></syntaxhighlight>
<code><nowiki>
|Służy do ukrycia informacji nt. kategorii szablonu, nie pojawi się on na stronach z użyciem szablonu.
Kocham swój szablon, hahaha! Ta treść się wyświetli.
|-
!<tt><nowiki><includeonly></nowiki></tt>
<noinclude>A ta nie!</noinclude></nowiki></code>

|<syntaxhighlight lang="xml">Treść szablonu<includeonly>
A następnie wywołamy go na przykład na tej stronie, poprzez wpisanie <code><nowiki>{{Kabanos}}</nowiki></code>, to wyświetli się jedynie to:
[[Kategoria:Dla artykułu do którego wstawiono szablon]]</includeonly></syntaxhighlight>
Kocham swój szablon, hahaha! Ta treść się wyświetli.
|Tekst w znacznikach includeonly pojawi się jedynie na stronie, do której został wstawiony. Nie pojawi się za to na stronie szablonu.

|-
Noinclude jest najczęściej wykorzystywane do ukrywania kategorii szablonów oraz ich dokumentacji.
!<tt><nowiki><nomobile></nowiki></tt>

|<syntaxhighlight lang="xml"><nomobile>Ten tekst nie pojawi się na skórce mobilnej</nomobile></syntaxhighlight>
== <nowiki><includeonly></nowiki> ==
|Tekst w znacznikach nomobile pojawi się tylko, gdy będzie używana jedna z desktopowych skórek (Monobook, Vector, Timeless).
Odwrotność „noinclude” – kod znajdujący się we wnętrzu tego znacznika wyświetli się '''jedynie wtedy''', gdy strona zostanie wywołana jak szablon.
|-

!<tt><nowiki><mobileonly></nowiki></tt>
Includeonly jest stosowany między innymi do dodawania do szablonów kategorii, które mają się pojawić jedynie na stronach, do których szablon został wstawiony.
|<syntaxhighlight lang="xml"><mobileonly>Ten tekst pojawi się tylko na skórce mobilnej</mobileonly></syntaxhighlight>
|Tekst w znacznikach mobileonly pojawi się tylko, gdy będzie używana skórka mobilna.
|}


{{Wikipedia}}
{{Przypisy}}


<br clear="all" />
<br clear="all" />

Wersja z 20:20, 6 lis 2021

Pomoc / Zaawansowane / Znaczniki

Znaczniki (inaczej tagi) pozwalają na wstawianie na Nonsensopedię specjalnych elementów oraz zmianę sposobu, w jaki oprogrogramowanie Nonsensopedii będzie traktować kod wikitekstu. Na Nonsensopedii można używać niektórych znaczników stosowanych powszechnie w ramach języka HTML. Dostępne są również dodatkowe znaczniki, specyficzne dla składni MediaWiki.

Podczas używania znaczników należy pamiętać, że choć można wstawiać znaczniki wewnątrz znaczników, to nie mogą się one przeplatać, to znaczy coś takiego:
<znacznik1><znacznik2>mlem</znacznik2></znacznik1>
jest dozwolone, ale już:
<znacznik1><znacznik2>błąd!</znacznik1></znacznik2>
nie jest.


<poem>

<poem> to znacznik pozwalający na przeniesienie tekstu do nowej linii zwyczajnym enterem (znakiem nowej linii), bez konieczności używania HTML-owego <br /> bądź tworzenia nowego akapitu poprzez naciśnięcie entera dwukrotnie.

Przykładowo, następujący kod:

<poem>
Oto Królestwo między dwoma rzeki,
Mamy bogate w humor biblioteki.
Widać jadących wojów hen, z oddali,
Znów odeprzemy najazdy wandali.
</poem>

zostanie ładnie wyświetlony w poniższej formie:

Oto Królestwo między dwoma rzeki,
Mamy bogate w humor biblioteki.
Widać jadących wojów hen, z oddali,
Znów odeprzemy najazdy wandali.

Bez użycia znacznika poem, wszystkie linie zlałyby się w jedną, oddzielone jedynie spacjami. Warto również zaznaczyć, że w jego wnętrzu wciąż można formatować tekst.

Uwaga! Ze względów technicznych, na stronach w całości składających się z tekstu (na przykład w Nonźródłach) zaleca się stosowanie szablonu {{Pasta}}, który pozwala na taki sam efekt, ale nie wyłącza podglądu artykułów po najechaniu kursorem na link.

<ref>

Znacznik <ref> służy do wstawiania przypisów.

Przykład:
Przypisy wstawiamy w artykułach, używając znaczników i szablonu Przypisy.<ref>Na ich końcu nie stawiamy jednak kropek</ref>

Efekt: Przypisy wstawiamy w artykułach, używając znaczników i szablonu Przypisy.[1]

Uwaga! Jeśli artykuł do którego chcesz wstawić przypis nie ma jeszcze innych przypisów, pod jego koniec (ale przed kategoriami i szablonami nawigacyjnymi) należy wstawić szablon {{Przypisy}}. Więcej o przypisach możesz dowiedzieć się na tej stronie.

<nowiki>

Użycie tego znacznika każe oprogramowaniu Nonsensopedii traktować tekst pomiędzy rozpoczynającym <nowiki> a </nowiki> jako zwykły tekst, nie jako kod MediaWiki. Oznacza to, że wszystko znajdujące się wewnątrz tego znacznika zostanie wyświetlone tak, jak wygląda w edytorze kodu, nie zostaną wywołane szablony, nie wyświetlą się grafiki, nie będą działały znaczniki pogrubienia czy pochylenia, i tak dalej.

Znacznik ten stosuje się zazwyczaj wtedy, gdy chce się zaprezentować wikitekst bez uruchamiania go, na przykład w tym poradniku.

Przykład:

<nowiki>dans dans dans '''mlem''' <del>uwielbiam [[schabowy]] z żurkiem</del> {{s|Motoryzacja}}</nowiki>

Efekt: dans dans dans '''mlem''' <del>uwielbiam [[schabowy]] z żurkiem</del> {{s|Motoryzacja}}

Efekt bez zastosowania nowiki: dans dans dans mlem uwielbiam schabowy z żurkiem {{Motoryzacja}}

<gallery>

Pozwala na tworzenie minigalerii zdjęć w artykule. Aby go użyć, po prostu wstaw do środka nazwy obrazków (bez przedrostka – nazwy przestrzeni – Plik:) oddzielonych nową linią. Możesz również dodać opis grafiki po znaku „|”.

Przykład:

<gallery>
Alarm invalid.jpg
Drill sergeant screams.jpg
Koniec pociągu śpiewa.jpg|Koniec pociągu tańczy i śpiewa
</gallery>

Efekt:

Więcej informacji o wstawianiu galerii grafik znajdziesz na tej stronie pomocy.


<noinclude>

Zawartość tego znacznika nie zostanie użyta w miejscu transkludowania strony, na której się znajduje. Oznacza to po prostu, że wyświetli się jedynie na stronie, do której została bezpośrednio dodana; gdy ktoś umieści ową stronę na innej w taki sposób, w jaki używa się szablonów, rzeczy umieszczone wewnątrz tego znacznika się tam nie pojawią.

Na przykład, jeśli utworzymy szablon o nazwie Kabanos, i wstawimy do niego poniższą treść:

Kocham swój szablon, hahaha! Ta treść się wyświetli. <noinclude>A ta nie!</noinclude>

A następnie wywołamy go na przykład na tej stronie, poprzez wpisanie {{Kabanos}}, to wyświetli się jedynie to:

Kocham swój szablon, hahaha! Ta treść się wyświetli.

Noinclude jest najczęściej wykorzystywane do ukrywania kategorii szablonów oraz ich dokumentacji.

<includeonly>

Odwrotność „noinclude” – kod znajdujący się we wnętrzu tego znacznika wyświetli się jedynie wtedy, gdy strona zostanie wywołana jak szablon.

Includeonly jest stosowany między innymi do dodawania do szablonów kategorii, które mają się pojawić jedynie na stronach, do których szablon został wstawiony.

Przypisy

  1. Na ich końcu nie stawiamy jednak kropek