Výzva

Structured text (STX) neparsuje dobře české znaky (únor 2008), takže se správně nevytvoří například tučně, kurzíva ani odkazy, pokud jsou v nich české znaky. Doporučuje se tedy stx nepoužívat a místo toho zkusit Restructured Text (RTX), který funguje správně.

Structured Text

Původní cíl návrhu Strukturovaného textu (Structured Text) je vytvořit takový chytrý text, který bude pěkně čitelný ve zdrojové formě i v zobrazení v prohlížeči.

Strukturovaným textem můžete naznačkovat vše - nadpisy i podnadpisy, styly písma, odkazy a podobné věci - a to při použití jednoduchých čistě textových formátovacích značek. (Strukturovaný text může také obsahovat značky HTML v případě, že potřebujete spáchat něco navíc, co Strukturovaný text nenabízí. Čím méně jich bude, tím lépe pro budoucí editory - včetně vás!).

Zdrojové texty existujících stránek poskytují snad nejlepší příklad značkovacích pravidel - text na této stránce ukazuje mnoho hlavních příkladů. Klikněte na "edit", abyste si zdrojový kód prohlédli.

Formátování stylu písma

Odstavce

Chcete li ukončit odstavec, nebo vytvořit nový, vložte prázdnou řádku:

        Toto je text v
        prvním odstavci.

        Toto je jiný text
        odstavce druhého.

Bude to pak zobrazeno takto:

Toto je text v prvním odstavci.

Toto je jiný text odstavce druhého.

Nadpisy

Zadejte toto:

        Můj nadpis

         Pokud chcete z řádky (jako třebas ta výše) učinit nadpis, 
        musíte za ní nechat jednu řádku volnou a následující 
        odstavec odsadit jednou mezerou. 

         Všimněte si, že druhý (tento) odstavec má také první řádku
         odsazenou. Všimněte si také, že nemusíte odsazovat celý odstavec
         (jak je to uděláno zde kvůli výkladu), ale stačí odsazovat
         první řádku.

         Mezi odstavci nechávejte prázdný řádek. Tento odstavec je také 
        odsazený. Pokud by nebyl, stane se to, že následující podnadpis 1
        nebude podnadpisem, ale nadpisem.

         Podnadpis 1

          Použijte dalšího odsazení mezerou, abyste získali podnadpis.
        Všimněte si, že úroveň odsazení podnadpisu je stejné,
        jako předchozí odstavec, ale *tento* odstavec je dosazený
        ještě více. A právě toto větší odsazení *tohoto* odstavce vytváří
        podnadpis.

          Podnadpis 2

           Další podnadpis získáte ještě větším odsazením.

           Podnadpis 3

            Další podnadpis získáte ještě větším odsazením.

Získáte toto:

Můj nadpis

Pokud chcete z řádky (jako třebas ta výše) učinit nadpis, musíte za ní nechat jednu řádku volnou a následující odstavec odsadit jednou mezerou.

Všimněte si, že druhý (tento) odstavec má také první řádku odsazenou. Všimněte si také, že nemusíte odsazovat celý odstavec (jak je to uděláno zde kvůli výkladu), ale stačí odsazovat první řádku.

Mezi odstavci nechávejte prázdný řádek. Tento odstavec je také odsazený. Pokud by nebyl, stane se to, že následující podnadpis 1 nebude podnadpisem, ale nadpisem.

Podnadpis 1

Použijte dalšího odsazení mezerou, abyste získali podnadpis. Všimněte si, že úroveň odsazení podnadpisu je stejné, jako předchozí odstavec, ale tento odstavec je dosazený ještě více. A právě toto větší odsazení tohoto odstavce vytváří podnadpis.

Podnadpis 2

Další podnadpis získáte ještě větším odsazením.

Podnadpis 3

Další podnadpis získáte ještě větším odsazením.

Předformátovaný text

Blok předformátovaného textu

Zadejte toto:

        Další blok textu bude formátován přesně tak, 
        jak ho napíšete::

            Toto vše je předformátované. <h1>

              Vaše formátování bude používáno dokud...
                 ... neskončí odsazování textu.
              Žádný ze *strukturovanych* **prikazu** _zde_ nefunguje.

        A tohle již předformátované není.

A získáte toto:

Další blok textu bude formátován přesně tak, jak ho napíšete:

      Toto vše je předformátované. <h1>

        Vaše formátování bude používáno dokud...
         ... neskončí odsazování textu.
        Žádný ze *strukturovanych* **prikazu** _zde_ nefunguje.

A tohle již předformátované není.

Poznámka: Můžete používat také HTML <pre> a </pre> tagy a získáte ten samý výsledek.

Předformátovaný text v řádku

Zadejte toto:

        Zde je normální text. Zde nějaký 'předformátovaný text'.
        Další obyčejný text.

A získáte toto:

Zde je normální text. Zde nějaký 'předformátovaný text'. Další obyčejný text.

Poznámka: Nefunguje s HTML tagy ani styly písma.

Seznamy

Seznamy s odrážkami

Zadejte toto:

        - První položka

        - Druhá položka.  Všimněte si prázdného řádku mezi nimi.

          - Vytvořte seznamy uvnitř seznamů použitím extra odsazením.

          - Druhá odsazená položka.

        - Třetí položka v hlavním seznamu.

A získáte toto:

  • První položka
  • Druhá položka. Všimněte si prázdného řádku mezi nimi.
    • Vytvořte seznamy uvnitř seznamů použitím extra odsazením.
    • Druhá odsazená položka.
  • Třetí položka v hlavním seznamu.

Můžete použít také * nebo - nebo o jako značku pro vaše položky seznamu. Nezapomínejte nechávat prázdný řádek před i za řádkou s -.

Číslované seznamy

Zadejte toto:

        1 První položka

        1 Druhá položka.  A znovu, všimněte si prázdné řádky
        mezi položkami.

        1 Třetí položka v seznamu.

A získáte toto:

  1. První položka
  2. Druhá položka. A znovu, všimněte si prázdné řádky mezi položkami.
  3. Třetí položka v seznamu.

Poznámka: Číslované seznamy nemohou být vnořené do seznamů s odrážkami. Na tučnější první řádky v každé položce použijte HTML tagy:

 <h1> ... nebo vytvořte celý seznam pomocí HTML tagů <ol>...<li>...

Seznam definic

Zadejte toto:

        První položka -- Více o první položce.

        Druhá položka -- Více o druhé položce.

        Třetí položka -- Více o třetí položce.

A získáte toto:

První položka
Více o první položce.
Druhá položka
Více o druhé položce.
Třetí položka
Více o třetí položce.

Odkazy

Vytváření odkazů

Budu se odkazovat na poznámku [1].

Dále v textu budu mít odstavec s poznámkou.

[1] Má poznámka. Všimněte si těch dvou teček na začátku řádky. .. následované mezerou a odkazem v hranatých závorkách. Tečky nesmí být odsazené.

Ochrana před odkazy

Jak zabránit, aby se WikiJmeno převedl na odkaz?

Obrázky

Po uploadu obrázku se vám automaticky na konci Vašeho textu vytvoří odkaz, např:

        <img src="cat031.jpg" />

Při následné editaci můžete celý tag přesunout na požadované místo a dostanete např.:

Můžete také použít externí plné URL obrázku, např.:

        "Plone logo":<img src="http://www.plone.org/logo.jpg" />

A získáte toto:

Plone logo

Můžete také použít img značku Strukturovaného textu, které předchází text, který se zobrazí, když se obrázek nenajde:

        "Plone logo":img:http://www.plone.org/logo.jpg
        "Kocicka":img:cat031.jpg

Plone logo Kocicka

Tabulky

Tabulky asi bude lepší zatím používat v HTML. Při použití značek Strukturovaneho textu to vypadá takto:

Zadejte toto:

        |------------------------------------|
        | Ovoce     | Oříšky     | Savci     |
        |====================================|
        | Jablko    | Arašídy    | Veverka   |
        |------------------------------------|
        | Pomeranč  | Pistácie   | Psi       |
        |------------------------------------|
        | Banán     | Ořechy     | Kravičky  |
        |------------------------------------|
        | Překlenuje 2 sloupce.  | Kočka     |
        |------------------------------------|
        | Hruška    | Překlenuje 2 sloupce.  |
        |------------------------------------|
        | Toto překlenuje 3 sloupce!         |
        |------------------------------------|

A získáte toto:

Ovoce

Oříšky

Savci

Jablko

Arašídy

Veverka

Pomeranč

Pistácie

Psi

Banán

Ořechy

Kravičky

Překlenuje 2 sloupce.

Kočka

Hruška

Překlenuje 2 sloupce.

Toto překlenuje 3 sloupce!

Opatrně s čísly v buňkách! Jsou považovány za položky nějakého seznamu. Každá buňka se chová v této souvislosti jako by byla na novém řádku.

A to je vše

Ať slouží a trvá.




subject:
  ( 112 subscribers )