Jump to content

Příručka:Vytváření stránek s přednačteným textem

From mediawiki.org
This page is a translated version of the page Manual:Creating pages with preloaded text and the translation is 100% complete.

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:

  1. Navržení souboru předběžného načtení a jeho podpůrné šablony
  2. Vytvoření stránky pro předběžné soubory a podpůrné šablony
  3. 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&section=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 tagy noinclude, můžete ve svém zdrojovém kódu použít
    <no<includeonly></includeonly>include>
    
    : Protože dva prostřední tagy budou odstraněny (viz dále), přednačtený text skončí pouze s požadovaným tagem ‎<noinclude>.
  • Štítky ‎<includeonly> a ‎</includeonly> jsou ze zdrojové stránky odstraněny. Pokud potřebujete, aby přednačtený text poskytoval tagy includeonly, můžete ve svém zdrojovém kódu použít
    <include<includeonly></includeonly>only>
    
    . Protože dva prostřední tagy budou odstraněny, přednačtený text nakonec bude mít pouze požadovaných ‎<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.

http://meta.wikimedia.org/w/wiki.phtml?title=Meta:Sandbox&action=edit&section=new&preloadtitle=New_Header

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

http://meta.wikimedia.org/w/wiki.phtml?title=Meta:Sandbox&action=edit&minor=1

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.

Proměnné $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[].

Tato dokumentace by měla být vylepšena vysvětlením, proč existují tyto dva odlišné zápisy parametrů šablony a kdy je možné nebo nutné použít každý z nich.

Například:

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:

Všechna rozšíření související s tvorbou stránek jsou v Kategorie:Rozšíření pro vytváření stránek .

Související odkazy