Příručka:Vytváření stránek s přednačteným textem
Please note: Some techniques recommended in this article require the use of extensions. Exercise caution when using them, as the status of each extension is self-assigned by its maintainer, and does not reflect the opinion of the MediaWiki development team.
Pamatujte prosím: Některé techniky doporučené v tomto článku vyžadují použití rozšíření. Při jeho používání buďte opatrní, protože stav každého rozšíření si přiděluje jeho správce sám a neodráží názor vývojového týmu MediaWiki. |
Předběžné načítání wikitextu zobrazí uživateli částečně vytvořenou stránku, případně s vloženými instrukcemi pro organizaci obsahu, namísto prázdné stránky. Tato technika je obzvláště užitečná, když wiki obsahuje jednu nebo více kategorií článků s velkým množstvím proforma textu nebo informace, které je třeba pro takové články shromáždit, jsou kombinací strukturovaných dat a volného textu.
Vytváření stránek s přednačteným textem probíhá ve třech krocích:
- Navržení souboru předběžného načtení a jeho podpůrné šablony
- Vytvoření stránky pro předběžné soubory a podpůrné šablony
- Nastavení spouštěče pro načtení souboru předběžného načtení
Návrh souboru pro předběžné načtení
Předběžný soubor je často článek s vloženou šablonou. Pokud byste například chtěli jeden článek pro každého zákazníka nebo marketingový kontakt, můžete předem načíst text, který vypadá podobně jako v níže uvedeném příkladu.
<!-- Za znaménko rovnosti prosím zadejte kontaktní informace vašeho zákazníka.
Pokud potřebujete pomoc s nahráním obrázků vizitek, podívejte se prosím na stránku [[Help:Uploading business card images]]
-->
{{CustomerContact
|Number=
|BizcardImage=
|Primary phone number=
|Address=
}}
Pojmenování a dokumentace souboru předběžného načtení
Některá rozšíření mají specifická očekávání ohledně toho, kam by měl být přednačtený text uložen. Jiní nechávají toto rozhodnutí zcela na správci systému.
Pojmenování a dokumentace souboru předběžného načtení vyžaduje určitou opatrnost, protože soubory předběžného načtení se ne vždy zobrazují v sekci "What links here" (odkazy zde), a proto jsou vystaveny riziku nechtěného smazání (žádné informace/žádné odkazy – těžko se to pozná z článku, který byl vytvořen a opuštěn). U souborů předběžného načtení založených na šablonách mohou následující konvence pojmenování pomoci zabránit nechtěnému smazání:
- umístit šablonu do
Template:CategoryName - umístit soubor předběžného načtení do
Template:CategoryName/Preload
Načítání souboru předběžného načtení
Předběžné načítání lze provést pomocí parametru preload v URL adrese, například http://en.wikipedia.org/wiki/Talk:Main_Page?action=edit§ion=new&preload=Template:Foo, který odkazuje na editační pole nové stránky, na které je předběžně načten parametr Template:Foo. K dispozici je také řada rozšíření pro spuštění souboru předběžného načtení, viz níže.
Wikitext zdrojové stránky se předem načte do editačního pole, pokud stránka nebo sekce ještě neexistuje. Pokud stránka nebo sekce, která má být upravena, již existuje, načte se pouze její wikitext a příkaz preload se ignoruje.
- Tagy
<noinclude>a</noinclude>jsou odstraněny. Pokud potřebujete, aby přednačtený text poskytoval tagynoinclude, můžete ve svém zdrojovém kódu použít: Protože dva prostřední tagy budou odstraněny (viz dále), přednačtený text skončí pouze s požadovaným tagem<no<includeonly></includeonly>include>
<noinclude>. - Štítky
<includeonly>a</includeonly>jsou ze zdrojové stránky odstraněny. Pokud potřebujete, aby přednačtený text poskytoval tagyincludeonly, můžete ve svém zdrojovém kódu použít. Protože dva prostřední tagy budou odstraněny, přednačtený text nakonec bude mít pouze požadovaných<include<includeonly></includeonly>only>
<includeonly>.
Neexistuje tedy ani úplné zahrnutí, ani regulérní transkluze. Viz také T7210 (od 9. března 2006).
Pokud se vytváří nová sekce, lze počáteční obsah pole "Subject/headline" (předmět/nadpis) zadat pomocí parametru preloadtitle.
Pokud se nevytváří nová sekce, lze shrnutí nastavit parametrem summary. (T19002)
- http://meta.wikimedia.org/w/wiki.phtml?title=Meta:Sandbox&action=edit&summary=Doing%20some%20changes
Zaškrtávací políčko pro drobnou úpravu lze nastavit přidáním parametru minor
Použití parametrů
| Verze MediaWiki: | ≥ 1.23 |
Parametry pro předběžně načítaný text můžete také zadat pomocí parametru url s hodnotou preloadparams[].
(Při odkazování na wiki je vhodné nahradit [] znakem %5b%5d.)
Každému vložení proměnné parameter[] do URL adresy (v pořadí) odpovídá proměnná v číselném pořadí: např. první výskyt nahrazuje proměnnou $1, druhý $2 atd.
$1, $2, ... se liší od proměnných {{{1}}}, {{{2}}}, ....
Aby bylo možné použít proměnnou preloadparams[], šablona by měla používat konkrétně proměnné $1, $2, ... místo parametrů {{{1}}}, {{{2}}}, ..., které nesouvisí s funkcí preloadparams[].
Například:
- https://mediawiki.org/wiki/Project:Sandbox?action=edit§ion=new&nosummary=true&preload=Manual:Creating_pages_with_preloaded_text/param_demo
- https://mediawiki.org/wiki/Project:Sandbox?action=edit§ion=new&nosummary=true&preload=Manual:Creating_pages_with_preloaded_text/param_demo&preloadparams%5b%5d=first%20value&preloadparams%5b%5d=second%20value
- https://mediawiki.org/wiki/Project:Sandbox?action=edit§ion=new&preload=MediaWiki:July (zavedeno od 1.41)
Rozšíření
Mezi rozšíření, která spouštějí soubor předběžného načtení, patří:
- Extension:Inputbox (stabilní, je součástí MediaWiki) - nabízí největší kontrolu nad procesem načítání. Umožňuje umístit tlačítko někam do článku, obvykle na stránku s nápovědou pro uživatele nebo na stránku kategorie odpovídající danému článku. Název souboru předběžného načtení zadáte jako součást definice tlačítka.
- Extension:NamespacePreload (stabilní)
- Extension:MultiBoilerplate (stabilní)
- Extension:Page Forms (stabilní) - může jednoduše přednačíst stránku článku, kromě funkcí formuláře.
- Extension:Preloader (neudržované)
Několik rozšíření také zvládne všechny tři kroky za vás:
- Extension:ArticleToCategory2 (neudržované)
Všechna rozšíření související s tvorbou stránek jsou v Kategorie:Rozšíření pro vytváření stránek.