2 | ||
Editor: geon
Time: 2008/02/13 16:08:44 GMT+1 |
||
Note: |
changed: - <h2>Výzva</h2> 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ě. <h2>Structured Text</h2> 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. <h2>Formátování stylu písma</h2> * Zdůraznění: '*kurzíva*' => *kurzíva* * Tučně: '**tučně**' => **tučně** * Podtrženě: '_podtrženě_' => _podtrženě_ * Kód: <code>'kod'</code> => 'kod' <h2>Odstavce</h2> 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: <table><tr><td bgcolor="lightgrey" border=1> Toto je text v prvním odstavci. Toto je jiný text odstavce druhého. </td></tr></table> <h2>Nadpisy</h2> 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: <table><tr><td bgcolor="lightgrey" border=1> 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. </td></tr></table> <h2>Předformátovaný text</h2> <h3>Blok předformátovaného textu</h3> 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: <table><tr><td bgcolor="lightgrey" border=1> 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í. </td></tr></table> Poznámka: Můžete používat také HTML <code><pre></code> a <code></pre></code> tagy a získáte ten samý výsledek. <h3>Předformátovaný text v řádku</h3> Zadejte toto:: Zde je normální text. Zde nějaký 'předformátovaný text'. Další obyčejný text. A získáte toto: <table><tr><td bgcolor="lightgrey" border=1> Zde je normální text. Zde nějaký 'předformátovaný text'. Další obyčejný text. </td></tr></table> Poznámka: Nefunguje s HTML tagy ani styly písma. <h2>Seznamy</h2> <h3>Seznamy s odrážkami</h3> 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: <table><tr><td bgcolor="lightgrey" border=1> - 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. </td></tr></table> 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 -. <h3>Číslované seznamy</h3> 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: <table><tr><td bgcolor="lightgrey" border=1> 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. </td></tr></table> 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>... <h3>Seznam definic</h3> 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: <table><tr><td bgcolor="lightgrey" border=1> 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. </td></tr></table> <h2>Odkazy</h2> <h3>Vytváření odkazů</h3> - **Odkazy** Zadejte toto:: "Odkaz na CNN":http://www.cnn.com/ A získáte toto: <table><tr><td bgcolor="lightgrey" border=1> "Odkaz na CNN":http://www.cnn.com/ </td></tr></table> - **URL odkazy** Cokoliv, co je jasně URL adresa bude zformátováno na odkaz. Například:: http://www.zope.org/ vyrobí: <table><tr><td bgcolor="lightgrey" border=1> http://www.zope.org/ </td></tr></table> - **Emailové adresy** Zadejte toto:: mailto:address@example.com A získáte toto: <table><tr><td bgcolor="lightgrey" border=1> mailto:address@example.com </td></tr></table> Jiný způsob:: "napiš mi", mailto:address@example.org A získáte toto: <table><tr><td bgcolor="lightgrey" border=1> "napiš mi", mailto:address@example.org </td></tr></table> <br><br> - **!WikiJmeno** Wiki odkazy jsou tvořeny dvěmi nebo více spojenými slovy s velkými počátečními písmeny, které tak pojmenovávají cílovou stránku. Zwiki umožňuje jednopísmenná slova a číslice na konci. Když taková cílová stránka existuje, wiki odkaz se vygeneruje jako odkaz. Jak prosté! Wiki odkazy také slouží pro vytváření stránek - když cílová stránka chybí tak WikiJmeno samo o sobě není odkazem, ale je k němu "přišpendlen" otazníček, který *je* odkazem na stránku, kde můžeme chybějící stránku vytvořit. Pár příkladů:: StrukturovanyText, FrontPage, WikiPiskoviste, WikiJmeno, AJmeno, WikiJmenoPlus001 Získejte toto: <table><tr><td bgcolor="lightgrey" border=1> StrukturovanyText, FrontPage, WikiPiskoviste, WikiJmeno, AJmeno, WikiJmenoPlus001 </td></tr></table> - **Hranaté zavorky** Používejte hranaté závorky k převodu téměř čehokoliv na wiki odkaz buďte si ale vědomi, že mezery a čeština vytvoří neobvyklý odkaz. Používejte střídmě - je moudré se vystříhat této techniky jak to jen jde. Example:: [nejaky divny odkaz] A získáte toto: <table><tr><td bgcolor="lightgrey" border=1> [nejaky divny odkaz] </td></tr></table> - **!RemoteWikiURL** (Vzdálené odkazy URL) Zadejte toto:: ZWiki:RemoteWikiURL A získáte toto: <table><tr><td bgcolor="lightgrey" border=1> ZWiki:RemoteWikiURL </td></tr></table> Vzdálené odkazy URL RemoteWikiURLs vyžadují speciální stránku v lokálním wiki, kde bude popsán vzdálený wiki server. Stránka musí obsahovat klíčové slovo RemoteWikiURL: následovaný URL stránkou na té samé řádce. - **Odkazy v rámci jedné stránky** Zadejte toto:: 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. A získáte toto: <table><tr><td bgcolor="lightgrey" border=1> 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é. </td></tr></table> <h3>Ochrana před odkazy</h3> Jak zabránit, aby se !WikiJmeno převedl na odkaz? - Uzavřete výraz do ' (jednoduché uvozovky) : 'ZWiki' - Uzavřete výraz do bloku "::" :: StrukturovanyText, http://www.zope.org, <strong>nope!<strong> - Před WikiJmeno nebo '[]' napište vykřičník: !StrukturovanyText, ![meta comment] <h2>Obrázky</h2> 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ř.: <img src="cat031.jpg" /> 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: <table><tr><td bgcolor="lightgrey" border=1> "Plone logo":img:http://www.plone.org/logo.jpg </td></tr></table> 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 <table><tr><td bgcolor="lightgrey" border=1> "Plone logo":img:http://www.plone.org/logo.jpg "Kocicka":img:cat031.jpg </td></tr></table> <h2>Tabulky</h2> Tabulky asi bude lepší zatím používat v HTML. Při použití značek "Strukturovaneho textu":StrukturovanyText 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: <table><tr><td bgcolor="lightgrey" border=1> |------------------------------------| | 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! | |------------------------------------| </td></tr></table> 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. <h2>A to je vše</h2> Ať slouží a trvá.
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.
'kod'
=> kod
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. |
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 nadpisPokud 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 1Použ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 2Další podnadpis získáte ještě větším odsazením. Podnadpis 3Další podnadpis získáte ještě větším odsazením. |
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.
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. |
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:
|
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 -.
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:
|
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>...
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:
|
Zadejte toto:
"Odkaz na CNN":http://www.cnn.com/
A získáte toto:
|
Cokoliv, co je jasně URL adresa bude zformátováno na odkaz. Například:
http://www.zope.org/
vyrobí:
|
Zadejte toto:
mailto:address@example.com
A získáte toto:
|
Jiný způsob:
"napiš mi", mailto:address@example.org
A získáte toto:
"napiš mi", address@example.org
|
Wiki odkazy jsou tvořeny dvěmi nebo více spojenými slovy s velkými počátečními písmeny, které tak pojmenovávají cílovou stránku. Zwiki umožňuje jednopísmenná slova a číslice na konci.
Když taková cílová stránka existuje, wiki odkaz se vygeneruje jako odkaz. Jak prosté!
Wiki odkazy také slouží pro vytváření stránek - když cílová stránka chybí tak WikiJmeno samo o sobě není odkazem, ale je k němu "přišpendlen" otazníček, který je odkazem na stránku, kde můžeme chybějící stránku vytvořit.
Pár příkladů:
StrukturovanyText, FrontPage, WikiPiskoviste, WikiJmeno, AJmeno, WikiJmenoPlus001
Získejte toto:
StrukturovanyText?, FrontPage, WikiPiskoviste, WikiJmeno, AJmeno, WikiJmenoPlus001
|
Používejte hranaté závorky k převodu téměř čehokoliv na wiki odkaz buďte si ale vědomi, že mezery a čeština vytvoří neobvyklý odkaz. Používejte střídmě - je moudré se vystříhat této techniky jak to jen jde.
Example:
[nejaky divny odkaz]
A získáte toto:
[nejaky divny odkaz]?
|
Zadejte toto:
ZWiki:RemoteWikiURL
A získáte toto:
ZWiki:RemoteWikiURL
|
Vzdálené odkazy URL RemoteWikiURLs? vyžadují speciální stránku v lokálním wiki, kde bude popsán vzdálený wiki server. Stránka musí obsahovat klíčové slovo RemoteWikiURL?: následovaný URL stránkou na té samé řádce.
Zadejte toto:
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.
A získáte toto:
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.
|
ZWiki
StrukturovanyText, http://www.zope.org, <strong>nope!<strong>
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:
|
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
|
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:
|
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.