Przejdź do zawartości

Szablon:ŹródłoKodu

Z Wikibooks, biblioteki wolnych podręczników.
 Dokumentacja szablonu [zobacz] [edytuj] [historia] [odśwież]

Użycie

[edytuj]

Szablon służy do wyświetlania w ramce, dla przykładu język=xml, znaczników <syntaxhighlight lang="xml">{{{1}}}</syntaxhighlight>, pokolorowanego kodu w różnych językach komputerowych, nawet znacznikowych. W przypadku znaczników XML interpretowanych przez wiki należy używać szablonów {{Mniejszy}} i {{Większy}}, (w przypadku znaczników tu omawianych) oraz {{=}} (we wszystkich przypadkach przed zabezpieczeniem przy pierwszym tym znaku w danym polu parametru, by część poprzedzająca nie była interpretowana jako parametr, a część następująca po nim jako wartość), jak np. dla kodu: <ref name="Nazwa przypisu">W przypisie może być cokolwiek</ref>, np. tworząc kod:

{{ŹródłoKodu|język=xml|
{{Mniejszy}}ref name{{=}}"Nazwa przypisu"{{Większy}}W przypisie może być cokolwiek{{Mniejszy}}/ref{{Większy}}
{{Mniejszy}}ref name{{=}}"Wydawca: Jakiś tytuł"{{Większy}}Franciszka Tłumacząca, Przypisy często zawierają odniesienia do literatury lub źródeł internetowych{{Mniejszy}}/ref{{Większy}}
}}

A jego wywołanie jest takie:

<ref name="Nazwa przypisu">W przypisie może być cokolwiek</ref>
<ref name="Wydawca: Jakiś tytuł">Franciszka Tłumacząca, ''Przypisy często zawierają odniesienia do literatury lub źródeł internetowych''</ref>

Możliwe szablony pochodne

[edytuj]
  • Szablony zbudowane w oparciu szablon {{ŹródłoKodu}}:
    • {{ŹródłoKodu}} - szablon równy zawartości tego szablonu,
    • {{ŹródłoHtml}} - szablon wyświetlający i kolorujący składnie HTML, równoważny wywołaniu: {{ŹródłoKodu|język=html|...}},
    • {{ŹródłoCss}} - szablon wyświetlający i kolorujący składnie CSS, równoważny wywołaniu: {{ŹródłoKodu|język=css|...}}.
    • {{ŹródłoXml}} - szablon wyświetlający i kolorujący składnie XML, równoważny wywołaniu: {{ŹródłoKodu|język=xml|...}}.

Opis parametrów

[edytuj]
Parametry:
  • 1 - kod (wikikod) do wyświetlenia pokolorowania w obramowanej ramce (konieczny),
  • język - język składni tego kodu (wikikodu), np.: | język = html, | język = xml, | język = css. Tylko przy szablonie kombajnie {{ŹródłoKodu}}, przy innych szablonach zbudowanych o niego tego parametru nie ma (sugerowany).
Nagłówek i stopka:
  • nagłówek - nagłówek podświetlania składni kodu (opcjonalny),
  • stopka - stopka podświetlania składni kodu (opcjonalny),
  • styl nagłówka - style nagłówka kaskadowych arkuszy stylów CSS (opcjonalny),
  • styl stopki - style stopki kaskadowych arkuszy stylów CSS (opcjonalny).
Kod:
  • styl kodu - style, kaskadowych arkuszy stylów CSS, kodu komputerowego w różnych językach programowania, podświetlania składni (opcjonalny).
Parametry nad-ramki podświetlającego kod:
  • id - identyfikator znacznika <div>...</div> (opcjonalny),
  • klasa - klasy reguł kaskadowych styli arkuszy stylów (opcjonalny),
  • styl - style kaskadowych arkuszy stylów CSS (opcjonalny).

Przykład

[edytuj]
Przykład - język HTML
{{ŹródłoKodu|język=html|nagłówek=Nagłówek kodu|stopka=Stopka kodu|{{Integrowanie|Zapałka/jeden|nazwa przestrzeni nazw=(main)|nazwa jednostki=Strona/Podstrona}}}}
Wynik
Nagłówek kodu
{| style="margin: 4px 10%; border-collapse: collapse; background: #f9f9f9;border: 1px solid #9932cc;" class="plainlinks noprint"  
|-    
| style="border: none; padding: 2px 0px 2px 0.9em; text-align: center;"| [[File:Merge-arrow.svg|35px]]
| style="border: none; padding: 0.25em 0.9em; width: 100%;"| '''Ta strona szablonu jest właśnie '"`UNIQ--templatestyles-0000000E-QINU`"'<span class="iew link">[[:w:Pomoc:Integracja|integrowana]]</span> ze stroną szablonu: ''[[:Szablon:Zapałka/jeden|Zapałka/jeden]]'', i może być nieaktualna'''. <br /><small>Prosimy edytować jedynie stronę szablonu podaną powyżej, ponieważ ta strona szablonu może być niedługo zamieniona na '"`UNIQ--templatestyles-00000010-QINU`"'<span class="iew link">[[:w:Pomoc:Przekierowanie|przekierowanie]]</span>. </small></span> <span style="white-space:nowrap"><small>Dyskusja na temat integracji może znajdować się w [[:Dyskusja szablonu:ŹródłoKodu|dyskusji tej strony szablonu]] lub strony szablonu docelowego.</small>[[Kategoria:Strony szablonów, do zintegrowania|ŹródłoKodu]][[Kategoria:Strony szablonów, w edycji|ŹródłoKodu]]

|}
Stopka kodu

Przykład - język XML
{{ŹródłoKodu|język=xml|nagłówek=Nagłówek kodu|stopka=Stopka kodu|<xml lang{{=}}"pl">Oto jest pytanie</xml>}}
Wynik
Nagłówek kodu
<xml lang="pl">Oto jest pytanie</xml>
Stopka kodu

Przykład - język CSS
{{ŹródłoKodu|język=css|nagłówek=Nagłówek kodu|stopka=Stopka kodu|
.klasa_jeden{
   width:100px;
   height:150px;
   font-fize:12px;
   white-space:nowrap;
}}}
Wynik
Nagłówek kodu
.klasa_jeden{
   width:100px;
   height:150px;
   font-size:12px;
   white-space:nowrap;
}
Stopka kodu

Błędy

[edytuj]

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

Szablon kolorujący składnie kodu w różnych językach komputerowych.

Parametry szablonu[Zarządzaj danymi szablonu]

ParametrOpisTypStatus
11

Kod w jakimś języku komputerowych.

Ciąg znakówwymagany
językjęzyk

Kod języka komputerowego.

Wartość domyślna
html
Ciąg znakówsugerowany
nagłóweknagłówek

Nagłówek podświetlania składni kodu.

Ciąg znakówopcjonalny
stopkastopka

Stopka podświetlania składni kodu.

Ciąg znakówopcjonalny
styl nagłówkastyl nagłówka

Style nagłówka kaskadowych arkuszy stylów CSS.

Nieznanyopcjonalny
styl stopkistyl stopki

Style nagłówka kaskadowych arkuszy stylów CSS.

Nieznanyopcjonalny
styl kodustyl kodu

Style, kaskadowych arkuszy stylów CSS, kodu komputerowego w różnych językach programowania podświetlania składni.

Nieznanyopcjonalny
idid

Identyfikator znacznika <div>...</div>.

Nieznanyopcjonalny
klasaklasa

Klasy reguł kaskadowych styli arkuszy stylów.

Nieznanyopcjonalny
stylstyl

Style kaskadowych arkuszy stylów CSS.

Nieznanyopcjonalny

Zobacz też

[edytuj]
  • {{LuaSubst}} - szablon do zwracania zawartości stron, w postaci nierozwiniętego wikitekstu, na tym projekcie, a do kolorowania składni tego kodu służy ten szablon.