Szablon:Znacznik/opis

To jest podstrona dokumentacji dla szablonu {{Znacznik}}.
Zawiera ona informacje na temat sposobu użycia, kategoryzacji szablonu i inną zawartość niebędącą częścią oryginalnej strony.

Użycie

Szablon znacznik służących do budowy innych szablonów znaczników, oparty na obsłudze tagów (tagi języka HTML), styli: style, (właściwości i ich zawartości przedstawiający język CSS), klas: class (reguł w kaskadowych arkuszach stylów), identyfikatora: id, i atrybutów (inne niż style, class i id), elementów HTML. Zbudowany o znacznik oznaczony tagiem: | tag = jakiś tag. Jeśli parametr: | samyzamykający = , to tekst jest umieszczany wewnątrz tego szablonu pomiędzy tymi znacznikami.

Opis parametrów

Wywołanie

{{Znacznik|tag=|1=|id=|styl=|klasa=|atrybuty=}}

Szablon {{Znacznik}}, przyjmuje argumenty, którego wartości wraz z odpowiednimi nazwami, oprócz zmiennych: tag i 1, w nim, wsadza on do tagu, coś w rodzaju: <tag nazwa="wartość">...</tag>, obsługiwanego przez niego znacznika, przez którego on jest oparty, a parametr: tag jest nazwą tagu, a oto lista tych zmiennych poniżej.

Parametry

tag - parametr mówiący jaki tag ma obsługiwać ten szablon, obsługiwane przez język HTML - wymagany,
1 - gdy pusty lub nie podany parametr: samozamykający, to zawartość pomiędzy znacznikami - sugerowany,
id - unikalny identyfikator znacznika dla jakikolwiek tagu - sugerowany,
styl - styl CSS, właściwości i ich wartości, języka CSS - opcjonalny,
klasa - klasa kaskadowych arkuszy stylów, języka CSS - opcjonalny,
atrybuty - atrybuty znacznika ukrytego pod zmienną: tag, inne niż: style, class i id - opcjonalny,
samozamykający - gdy nie pusty, to znaczniki są samozamykające, jak np.:   i <hr /> - opcjonalny.

Opis szablonów tagów powstałych w oparciu o szablon {{Znacznik}} (w niej zawartość), {{Znacznik start}} (otwierający) i {{Znacznik koniec}} (zamykający)

Szablony znaczników opartych o znaczniki o pewnych tagach

{{Znacznik}} = szablon kombajn, równy zawartości tego szablonu

{{Div}} = {{Znacznik|tag=div|id={{{id|}}}|styl={{{styl|}}}|klasa={{{klasa|}}}|atrybuty={{{atrybuty|}}}|{{{1|}}}}} - szablon ramki pudełek, pozwalający nadać jej ściśle określony cechy jak np. rozmiar, tło, rozmiar,kolor i rodzaj czcionki tekstu w niej, a także inne właściwości, jak podkreślenie czcionki,
{{Pre}} = {{Znacznik|tag=pre|id={{{id|}}}|styl={{{styl|}}}|klasa={{{klasa|}}}|atrybuty={{{atrybuty|}}}|{{{1}}}}} - w niej umieszczany jest tekst, który ma z góry narzucone warunki typografii, można nadać jej też cechy niezależne od mechanizmu MediaWiki znacznika <pre>...</pre>, jak i nadpisać te cechy, za pomocą stylów, czy klas, ten szablon nie skraca wielu pustych spacji, a załamanie następuje wtedy przy miejscu wskazanym przez znacznik   lub szablon {{Br}} z jego stylami, klasami i atrybutami,
{{Code}} = {{Znacznik|tag=code|id={{{id|}}}|styl={{{styl|}}}|klasa={{{klasa|}}}|atrybuty={{{atrybuty|}}}|{{{1}}}}} - szablon tworzy z dowolnego tekstu kod komputerowy, o ściśle określonych cechach, tekst jest wyświetlany w białej ramce odróżnialnej od tła reszty strony,
{{Tt}} = {{Znacznik|tag=kbd|id={{{id|}}}|styl={{{styl|}}}|klasa={{{klasa|}}}|atrybuty={{{atrybuty|}}}|{{{1}}}}} - wyświetla tekst domyślną dla przeglądarki czcionką o stałej szerokości,
{{Sub}} = {{Znacznik|tag=sub|id={{{id|}}}|styl={{{styl|}}}|klasa={{{klasa|}}}|atrybuty={{{atrybuty|}}}|{{{1}}}}} - wyświetla tekst jako dolny indeks czegoś (innego elementu, ale niekoniecznie),
{{Sup}} = {{Znacznik|tag=sup|id={{{id|}}}|styl={{{styl|}}}|klasa={{{klasa|}}}|atrybuty={{{atrybuty|}}}|{{{1}}}}} - wyświetla tekst jako górny indeks czegoś (innego elementu, ale niekoniecznie),
{{Span}} = {{Znacznik|tag=span|id={{{id|}}}|styl={{{styl|}}}|klasa={{{klasa|}}}|atrybuty={{{atrybuty|}}}|{{{1}}}}} - element liniowy wyświetlany w tekście, pozwalający nadać jego zawartości jakieś cechy, jak np. rozmiar, kolor i inne właściwości czcionce, przez style, klasy i id, jest on umieszczany w tekście,
{{Small}} = {{Znacznik|tag=small|id={{{id|}}}|styl={{{styl|}}}|klasa={{{klasa|}}}|atrybuty={{{atrybuty|}}}|{{{1}}}}} - wyświetla zawartość pomniejszoną czcionką,
{{Big}} = {{Znacznik|tag=big|id={{{id|}}}|styl={{{styl|}}}|klasa={{{klasa|}}}|atrybuty={{{atrybuty|}}}|{{{1}}}}} - wyświetla zawartość powiększoną czcionką,
{{Center}} = {{Znacznik|tag=center|id={{{id|}}}|styl={{{styl|}}}|klasa={{{klasa|}}}|atrybuty={{{atrybuty|}}}|{{{1}}}}} - centruje (wyśrodkowuje) zawartość tekstu.

Szablony samozamykające

{{Br}} = {{Znacznik|tag=br|id={{{id|}}}|styl={{{styl|}}}|klasa={{{klasa|}}}|atrybuty={{{atrybuty|}}}|samozamykający=tak}} - przejście do nowej z aktualnej linii,
{{Hr}} = {{Znacznik|tag=hr|id={{{id|}}}|styl={{{styl|}}}|klasa={{{klasa|}}}|atrybuty={{{atrybuty|}}}|samozamykający=tak}} - kreska pozioma z nadanymi cechami poprzez styl;e, klasy i id.

Szablony pochodne zamykające i otwierające zawartość znaczników - kombajny

{{Znacznik start}} - szablon kombajn, otwierający, równy zawartości tego szablonu, służący do budowy innych szablonów znaczników otwierających,
{{Znacznik koniec}} - szablon kombajn, zamykający, równy zawartości tego szablonu, służący do budowy innych szablonów znaczników zamykających,

{{Div start}} = {{Znacznik start|tag=div|id={{{id|}}}|styl={{{styl|}}}|klasa={{{klasa|}}}|atrybuty={{{atrybuty|}}}}} - szablon ramki otwierający zwartość, wraz z nadanymi jej cechami i też jej zawartości poprzez język CSS poprzez style klasy i id,
{{Div koniec}} = {{Znacznik koniec|tag=div}} - szablon ramki zamykający zawartość, otworzonego przez {{Div start}}
{{Pre start}} = {{Znacznik start|tag=pre|id={{{id|}}}|styl={{{styl|}}}|klasa={{{klasa|}}}|atrybuty={{{atrybuty|}}}}} - szablon otwierający zawartość, w której tekst ma z góry narzucone warunki typografii, podobnie jak przy szablonie {{Pre}}, tylko ten szablon jest otwierający, a w tamtym cechy otwierania i zamykania są zawarte w jednym szablonie,
{{Pre koniec}} = {{Znacznik koniec|tag=pre}} - szablon zamykający zawartość otworzonego przez {{Pre start}}.

Szablon ramek pływających

{{OverflowWiersz}} = {{Znacznik|tag=div|id={{{id|}}}|styl=overflow-x:auto;max-height:{{{h|none}}};max-width:{{{w|none}}};{{{styl|}}}|klasa={{{klasa|}}}|atrybuty={{{atrybuty|}}}|{{{1}}}}} - szablon ramki pływający, dzięki niej możliwe jest pojawienie się suwaku poziomowego, jeśli jest to możliwe,

Szablony opływania

{{BrClear}} = {{Znacznik|tag=p|klasa=br-clear br-clear-{{{1|both}}} {{{klasa|}}}|styl=font-size:0;line-height:0;margin:0;padding:0;{{{styl|}}}|{{Znacznik|tag=br|samozamykający=tak|styl=clear:{{{1|both}}}}}}} - szablon opływania elementów HTML oparty o znacznik  ,
{{SpanClear}} = {{Znacznik|tag=span|klasa=span-clear span-clear-{{{1|both}}}|styl=clear:{{{1|both}}};height:0px;font-size:0;line-height:0;display:block| }} - szablon opływania tekstu oparty o znacznik ...,
{{DivClear}} = {{Znacznik|tag=div|klasa=div-clear-{{{1|both}}}|styl=clear:{{{1|both}}}|}} - znacznik opływania zawartości HTML o pustej zawartości tagu <div>...</div>.

Szablony przedstawiania kwestii technicznych projektu mechanizmu MediaWiki,

{{Parametr}} - szablon przedstawiający po kresce pionowej nazwę parametry, a po równa się jego zawartość, cały kod szablonu jest obłożony znacznikiem <code>...</code>, za pomocą szablonu {{Znacznik|tag=code|...}},
{{Tag}} - szablon przedstawiający znaczniki wraz z tagami i ich zawartością otoczony znacznikiem <code>...</code> za pomocą szablonu: {{Znacznik|tag=code|...}}.

Parametry szablonów znaczników

Parametry wraz z wyjaśnieniem dla powyższych szablonów są takie same jak dla szablonu {{Znacznik}} dla parametrów styl, klasa i atrybuty. Dla szablonów, które są niesamozamykające, i nie posiadają wersji otwierającej i zamykającej, parametr 1, to jest zawartość.

Przykłady wykorzystania do budowy innych szablonów znaczników

Ten szablon {{Znacznik}} można wykorzystać do budowy innych szablonów znaczników, oto przykład:

Szablon {{Div}}

{{Znacznik|tag=div|id={{{id|}}}|styl={{{styl|}}}|klasa={{{klasa|}}}|atrybuty={{{atrybuty|}}}|{{{1|}}}}}

Przykłady

Można też umieścić reguły CSS wszystkie w stylach.

Przykład

Oto jest tekst przed tym szablonem, dalej: {{Znacznik|tag=span|styl=font-size:15px;color:darkslategray;background-color:ivory;border:darkblue 1px solid|Zawartość}}, a oto jest tekst za tym szablonem.

Wynik

Oto jest tekst przed tym szablonem, dalej: Zawartość, a oto jest tekst za tym szablonem.

Ale też można wszystko umieścić w kaskadowych arkuszach stylów w postaci:

.przykład{
   font-size:15px;
   color:darkslategray;
   background-color:ivory;
   border:darkblue 1px solid
 }

A wywołanie jest takie jego:

Oto jest tekst przed tym szablonem, dalej: {{Znacznik|tag=span|klasa=przykład|Zawartość}}, a oto jest tekst za tym szablonem.

A wynik jest taki sam jak poprzednio.

Ale też można częściowo umieszczać w stylach i klasach, to wtedy w kaskadowych arkuszach stylów mamy:

.przykład{
   color:darkslategray;
   border:darkblue 1px solid
 }

A przykład:

Oto jest tekst przed tym szablonem, dalej: {{Znacznik|tag=span|styl=font-size:15px;background-color:ivory;|klasa=przykład|Zawartość}}, a oto jest tekst za tym szablonem.

A wynik jest taki sam jak w pierwszym przykładzie.

A gdy id znacznika ... jest unikalne, to też napiszemy:

#przykład{
   font-size:15px;
   background-color:aquamarine;
   color:darkslategray;
   border:darkblue 1px solid
 }

To wtedy należy napisać wywołanie naszego szablonu:

Oto jest tekst przed tym szablonem, dalej: {{Znacznik|tag=span|id=przykład|Zawartość}}, a oto jest tekst za tym szablonem.

A wynik jest taki sam jak poprzednio.

Można też rozkładać style (właściwości i ich wartości) pomiędzy style, class i id, co nie zmniejsza uwagi, że wynik wyświetlania jest taki sam.

A oto inny przykład wykorzystujący zmienną tego szablonu atrybuty:

Przykład

Oto jest tekst przed tym szablonem, dalej: {{Znacznik|tag=FONT|atrybuty=size="4" face="Arial" color="blue"|Zawartość}}, a oto jest tekst za tym szablonem.

A oto wynik

Oto jest tekst przed tym szablonem, dalej: Zawartość, a oto jest tekst za tym szablonem.

Przykład wykorzystujący zmienną samozamykający

Przykład

Oto jest tekst przed tym szablonem, dalej: {{Znacznik|tag=br|samozamykający=tak}}. A oto jest tekst za tym szablonem, a dalej wykorzystujemy inny szablon o wywołaniu: {{Znacznik|tag=hr|samozamykający=tak|styl=background-color:darkslategray;}} A oto dalszy tekst.

Wynik

Oto jest tekst przed tym szablonem, dalej: 
 A oto jest tekst za tym szablonem, a dalej wykorzystujemy inny szablon o wywołaniu:  A oto dalszy tekst.

Widzimy, że szablon {{Znacznik|tag=br|samozamykający=tak}} w wyniku powoduje przejście do następnej linijki, a wywołanie {{Znacznik|tag=hr|samozamykający=tak|styl=background-color:ivory;}} spowoduje za to przejście do następnej linijki, tam drukuje poziomą kreskę z pewnymi cechami podane w zmiennej styl, ale też cechy można podać w kaskadowych arkuszach stylów w postaci klas, albo też tam można odwołać się do reguł - właściwości i ich wartości, względem identyfikatora znacznika dla tego tagu, a ten id="dany_identyfikator" jest unikatowy w całym dokumencie HTML. Podobnie jest dla znacznika  , jak dla <hr />.

Tabelka z przykładami dla szablonu {{Znacznik}} przy znaczniku `...`

Style są w oparciu o kaskadowe arkusze stylów, które są napisane w stylach przykładów: Znacznik/przykłady.css. W poniższych przykładach należy pamiętać o napisaniu:

<templatestyles src="Szablon:Znacznik/przykłady.css" />

Zatem:

Wywołanie	Efekt
`{{Znacznik\|Oto jest tekst do analizy\|tag=strong\|styl=font-size:15px;color:darkslategray;background-color:ivory;border:darkblue 1px solid;}}`	Oto jest tekst do analizy
`{{Znacznik\|Oto jest tekst do analizy\|tag=strong\|styl=color:darkslategray;background-color:ivory;border:darkblue 1px solid;\|klasa=czcionka}}`	Oto jest tekst do analizy
`{{Znacznik\|Oto jest tekst do analizy\|tag=strong\|styl=color:darkslategray;\|klasa=czcionka\|id=przykład2}}`	Oto jest tekst do analizy
`{{Znacznik\|Oto jest tekst do analizy\|tag=strong\|klasa=tło obramowanie\|id=przykład1}}`	Oto jest tekst do analizy
`{{Znacznik\|Oto jest tekst do analizy\|tag=strong\|klasa=czcionka kolor tło obramowanie}}`	Oto jest tekst do analizy
`{{Znacznik\|Oto jest tekst do analizy\|tag=strong\|id=przykład}}`	Oto jest tekst do analizy

Widzimy w powyższej tabelce, że niezależnie jak napiszemy znacznik ..., to wynik otrzymujemy taki sam, a to rozplanowanie stylów zrobiliśmy poprzez rozdzielenie stylów pomiędzy atrybutami style, class lub id.

Błędy

Błędy należy zgłaszać na stronie Wikibooks:Kwestie techniczne.

Parametry szablonu (strukturyzacja Wizualnego Edytora)

Szablon (kombajn), budulec innych szablonów znaczników.

Parametry szablonu[Zarządzaj danymi szablonu]
Parametr		Opis	Typ	Status
1	`1`	Gdy parametr samozamykający jest pusty lub niepodany, to ten parametr jest aktywny.	Ciąg znaków	wymagany
tag	`tag`	Jest to symbol tagu znacznika o nadanej wartości.	Ciąg znaków	wymagany
id	`id`	Unikalny identyfikator danego znacznika o jakikolwiek tagu.	Ciąg znaków	sugerowany
styl	`styl`	Styl języka CSS, właściwości i ich wartości.	Ciąg znaków	opcjonalny
klasa	`klasa`	Nazwy klas, do którego są zastosowane pewne reguły.	Ciąg znaków	opcjonalny
atrybuty	`atrybuty`	Atrybuty znacznika, inne niż: id, style i class.	Ciąg znaków	opcjonalny
samozamykający	`samozamykający`	Wartość niepusta, wtedy szablon nie ma odpowiednika zamykającego, w przeciwnym wypadku on jest.	Ciąg znaków	opcjonalny

Zobacz też

Szablony: {{Znacznik start}} (otwierający) i {{Znacznik koniec}} (zamykający), w których tekst również formatowany, np.: względem stylów, jest umieszczany pomiędzy tymi znacznikami.