Jump to content
MediaWiki

Extension:Poem

From mediawiki.org
This page is a translated version of the page Extension:Poem and the translation is 100% complete.
This code base is maintained by the Readers Experience team. Code review only for UBNs or security fixes.
Toto rozšíření je součástí MediaWiki 1.21 a vyšší. Zbývající konfigurační pokyny je stále nutné dodržovat.
Příručka k rozšířením MediaWiki
Poem
Stav rozšíření: stabilní
Implementace Značka
Popis Přidává značku ‎<poem> pro formátování básní
Autoři Nikola Smolenski diskuse
Nejnovější verze průběžné aktualizace
MediaWiki 1.25+
Změny v databázi Ne
Licence Creative Commons Zero v1.0 Universal
Stáhnout
‎<poem>
Přeložte rozšíření Poem, používá-li lokalizaci z translatewiki.net
Problémy Otevřené úkoly · Nahlásit chybu

Rozšíření Poem umožňuje snadné formátování básní a podobných útvarů v rámci Wikitext . Pokud je rozšíření povoleno, upravuje zobrazování textového bloku uzavřeného do značky ‎<poem>‎</poem> dle následujících pravidel:

  • Všechny nové řádky jsou zachovány, jako by byly opatřeny značkou ‎<br />.
  • Blok textu je uzavřen ve značkách ‎<p>...‎</p> (stejně jako div třídy "poem").
  • Dvojtečky na začátku řádku jsou převedeny na odsazení 1 em.
  • Mezery na začátku řádku jsou zachovány a již nevyvolávají tag ‎<pre>.

Rozšíření zachovává wikilinky, tučné písmo atd., pokud jsou v básni přítomny.

Použití

Wikisource provides the best usage model for this extension. It uses several templates and a module to create indentation, line numbers, etc. See Wikisource:Help:Poetry for an explanation of how this is used there. This requires Extension:Scribunto and Extension:TemplateStyles, which are both now bundled as standard.

Příklad

Vstupní text Výstup 
<poem>
In [[Wikipedia:Xanadu|Xanadu]] did Kubla Khan
A stately pleasure-dome decree:
Where Alph, the sacred river, ran
Through caverns measureless to man
Down to a sunless sea.
So twice five miles of fertile ground
With walls and towers were girdled round:
And there were gardens bright with sinuous rills,
Where blossomed many an incense-bearing tree;
And here were forests ancient as the hills,
Enfolding sunny spots of greenery.
</poem>

In Xanadu did Kubla Khan
A stately pleasure-dome decree:
Where Alph, the sacred river, ran
Through caverns measureless to man
Down to a sunless sea.

So twice five miles of fertile ground
With walls and towers were girdled round:
And there were gardens bright with sinuous rills,
Where blossomed many an incense-bearing tree;
And here were forests ancient as the hills,
Enfolding sunny spots of greenery.

Příklad s odsazením

Vstupní text Výstup 
<poem>
Une terre au flanc maigre, âpre, avare, inclément
Où les vivants pensifs travaillent tristement, 
::Et qui donne à regret à cette race humaine
Un peu de pain pour tant de labeur et de peine ; 
::Des hommes durs, éclos sur ces sillons ingrats ; 
Des cités d’où s’en vont, en se tordant les bras, 
::La charité, la paix, la foi, sœurs vénérables ; 
L’orgueil chez les puissants et chez les misérables ; 
</poem>

Une terre au flanc maigre, âpre, avare, inclément
Où les vivants pensifs travaillent tristement,
Et qui donne à regret à cette race humaine
Un peu de pain pour tant de labeur et de peine ;
Des hommes durs, éclos sur ces sillons ingrats ;
Des cités d’où s’en vont, en se tordant les bras,
La charité, la paix, la foi, sœurs vénérables ;
L’orgueil chez les puissants et chez les misérables ;

Styl

Text básně je zabalen do div, který ve výchozím nastavení nemá žádný styl; ale zdědí jakoukoli možnost style nebo class předaná básni.

Například, zatímco odsazený text lze použít pro jednoduché příklady, aby se zabránilo vyplňování a nakreslení pěkného modrého rámečku, v některých případech může být obtížné jej přečíst, protože dlouhé řádky nejsou přerušované. Podobný, ale o něco lepší účinek lze dosáhnout pomocí: 

<poem style="border: 2px solid #d6d2c5; color: var(--color-base, #202122); background-color: var(--background-color-warning-subtle, #fdf2d5); padding: 1em;">

Při aplikaci na výše uvedený příklad je výsledek následující:

In Xanadu did Kubla Khan
A stately pleasure-dome decree:
Where Alph, the sacred river, ran
Through caverns measureless to man
Down to a sunless sea.

So twice five miles of fertile ground
With walls and towers were girdled round:
And there were gardens bright with sinuous rills,
Where blossomed many an incense-bearing tree;
And here were forests ancient as the hills,
Enfolding sunny spots of greenery.


Možnost "compact"

Použitím tagu ‎<poem> s volbou compact na text o více než dvou řádcích se každý řádek stane samostatným odstavcem. (To znamená, že umožňuje kompaktnější označení, nikoli kompaktnější výstup.)

Následné použití tagu ‎<poem> s volbou compact s až dvěma novými řádky mezi texty vytvoří pouze jeden nový řádek mezi texty, nikoli nový odstavec.

Při použití na texty o více než dvou řádcích se tedy každý řádek stane samostatným odstavcem, s výjimkou toho, že poslední řádek každého textu a první řádek dalšího textu jsou spojeny do odstavce jednoho.

Vstup Výstup Vstup Výstup 
<poem>
One,
Two.
</poem>
<poem>
Three?
Four!
</poem>

One,
Two.

Three?
Four! 

<poem compact>
One,
Two.
</poem>
<poem compact>
Three?
Four!
</poem>
One,
Two.
Three?
Four!
Vstup Výstup Vstup Výstup 
<poem>
One,
Two.
Extra.
</poem>
<poem>
Three?
Four!
Extra.
</poem>

One,
Two.
Extra.

Three?
Four!
Extra. 

<poem compact>
One,
Two.
Extra.
</poem>
<poem compact>
Three?
Four!
Extra.
</poem>
One,

Two.

Extra.
Three?

Four!

Extra.

Případné problémy a jejich řešení

  • Proměnné a funkce ParserFunctions fungují uvnitř kontejneru ‎<poem>...‎</poem>, ale NE uvnitř samotného tagu <poem ... >. To zabrání šablonám s kódem jako <poem style="{{{1}}}">.
  • Jedním z řešení je použít místo toho <div style="{{{1}}}"><poem> ... </poem></div>.
  • Dalším způsobem je použít #tag kouzelné slovo: {{#tag:poem| ... |style="{{{1}}}"}}.
    • Poznámka: Zdá se však, že to nefunguje s možností "compact".
Vstup (uvnitř OK, uvnitř není OK) Výstup 
<poemstyle="{{{1|border: 1px solid Black;}}}">
One,
{{{2|Two.}}}
</poem>

One,
Two.

Vstup (uvnitř i v OK) Výstup 
<divstyle="{{{1|border: 1px solid Black;}}}">
<poem>
One,
{{{2|Two.}}}
</poem>
</div>

One,
Two. 

{{#tag:poem|
One,
{{{2|Two.}}}
|style="{{{1|border: 1px solid Black;}}}"
}}

One,
Two.


Instalace

Toto rozšíření je součástí MediaWiki 1.21 a vyšší. Zbývající konfigurační pokyny je stále nutné dodržovat.
  • Stáhněte soubor/y a vložte je do adresáře pojmenovaného Poem ve vaší složce extensions/.
    Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:
    cdextensions/
gitclonehttps://gerrit.wikimedia.org/r/mediawiki/extensions/Poem
  • Na konec vašeho souboru LocalSettings.php přidejte následující kód: 
    wfLoadExtension( 'Poem' );
  • Yes Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.


Instalace Vagrant:

  • Pokud používáte Vagrant , instalujte s těmito parametry vagrant roles enable poem --provision
Toto rozšíření se používá na jednom nebo více projektech Wikimedia. Pravděpodobně to znamená, že rozšíření je stabilní a funguje dostatečně dobře, aby jej mohly používat weby s tak vysokou návštěvností. Vyhledejte tento název rozšíření v konfiguračních souborech CommonSettings.php a InitialiseSettings.php Wikimedie, abyste viděli, kde je nainstalováno. Úplný seznam rozšíření nainstalovaných na konkrétní wiki lze vidět na stránce wiki Special:Version.
Toto rozšíření je zahrnuto v následujících wiki farmách/hostitelích a/nebo balíčcích: Toto není autoritativní seznam. Některé wiki farmy/hostitelé a/nebo balíčky mohou toto rozšíření obsahovat, i když zde nejsou uvedeny. Pro potvrzení se vždy obraťte na své wiki farmy/hostitele nebo balíček.

AltStyle によって変換されたページ (->オリジナル) /