Szablon:Znacznik

 Dokumentacja szablonu [zobacz] [edytuj] [historia] [odśwież]

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.: <br /> 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 <br /> 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 <br />,
• {{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 <span>...</span>,
• {{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 <span>...</span> 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 <br />, jak dla <hr />.

Tabelka z przykładami dla szablonu {{Znacznik}} przy znaczniku <strong>...</strong>

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 <strong>...</strong>, 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.