Szablon:ŹródłoKodu
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
{| 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]]
|}
- 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
<xml lang="pl">Oto jest pytanie</xml>
- 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
.klasa_jeden{
width:100px;
height:150px;
font-size:12px;
white-space:nowrap;
}
Błędy
[edytuj]Błędy należy zgłaszać na stronie Wikibooks:Kwestie techniczne.
Parametry szablonu (strukturyzacja Wizualnego Edytora)
[edytuj]Szablon kolorujący składnie kodu w różnych językach komputerowych.
Parametr | Opis | Typ | Status | |
---|---|---|---|---|
1 | 1 | Kod w jakimś języku komputerowych. | Ciąg znaków | wymagany |
język | język | Kod języka komputerowego.
| Ciąg znaków | sugerowany |
nagłówek | nagłówek | Nagłówek podświetlania składni kodu. | Ciąg znaków | opcjonalny |
stopka | stopka | Stopka podświetlania składni kodu. | Ciąg znaków | opcjonalny |
styl nagłówka | styl nagłówka | Style nagłówka kaskadowych arkuszy stylów CSS. | Nieznany | opcjonalny |
styl stopki | styl stopki | Style nagłówka kaskadowych arkuszy stylów CSS. | Nieznany | opcjonalny |
styl kodu | styl kodu | Style, kaskadowych arkuszy stylów CSS, kodu komputerowego w różnych językach programowania podświetlania składni. | Nieznany | opcjonalny |
id | id | Identyfikator znacznika <div>...</div>. | Nieznany | opcjonalny |
klasa | klasa | Klasy reguł kaskadowych styli arkuszy stylów. | Nieznany | opcjonalny |
styl | styl | Style kaskadowych arkuszy stylów CSS. | Nieznany | opcjonalny |
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.
|
Powyższy opis jest dołączany ze strony Szablon:ŹródłoKodu/opis. (edytuj | historia)
Kategorie należy dodawać do podstrony /opis. Zobacz podstrony tego szablonu. |