moodle/lang/cs/help/wiki.html
2004-03-07 14:00:43 +00:00

212 lines
7.0 KiB
HTML

<p align="center"><b>Nápověda k psaní Wiki stránek</b></p>
<p>
Wiki stránky poskytují možnost formátovat text intuitivními a lidmi snadno
čitelnými značkami. Formátování je při zobrazování automaticky převedeno do
XHTML. Nemusíte tedy znát syntaxi HTML a přitom nepřicházíte o možnost
formátování vámi napsaných stránek. Další výhodou je, že text vypadá čitelněji
než klasická HTML stránka i <em>před</em> konverzí. Wiki text je alternativou
k vytváření webových stránek pomocí ukládání jako HTML ve Wordu a umožňuje
snadnou úpravu těchto stránek online.
</p>
<p>
Wiki stránku píšete jako obyčejný text. K dispozici máte navíc několik
<em>speciálních</em> znaků, kterými určujete, jak bude text na stránce vypadat
(formátovací znaky).
</p>
<h3>Formátování odstavce textu</h3>
<p>
Odstavce se ve Wiki oddělují prázdným řádkem. Chcete-li naformátovat celý
odstavec na určitý typ, vložte jeden z následujících znaků jako první znak
prvního řádku odstavce a za ním udělějte mezeru.
</p>
<table>
<tr><th>Znak</th><th>Typ odstavce</th></tr>
<tr><td>Nic</td><td>Obyčejný odstavec</td></tr>
<tr><td>&gt;</td><td>Odsazený odstavec</td></tr>
<tr><td>Mezera</td><td>Již naformátovaný text (pevná šířka)</td></tr>
<tr><td>%</td><td>Již naformátovaný text <em>a</em> formátování Wikki je ignorováno</td></tr>
<tr><td>!#</td><td>Nadpis - místo # napište úroveň nadpisu 1-6 (1 je nejvyšší)</td></tr>
<tr><td>Q.</td><td>Otázka (z angl. Question) - do odstavce je přidána informace o CSS stylu, což umožní zobrazit odstavec jako otázku (závisí na použitém motivu stránek)</td></tr>
<tr><td>A.</td><td>Odpověď (z angl. Answer) - jako Q., ale odpověď</td></tr>
</table>
<h3>Formátování seznamů</h3>
<p>
Jednoduché seznamy se tvoří prostým umístěním speciálního formátovacího znaku
na začátek každého řádku v seznamu, za kterým se umisťuje mezera. Seznam je
přerušen prázdným řádkem. Seznamy mohou být rovněž hierarchické - typy
vnořených seznamů se mohou lišit. Definice v seznamu definic a typy textu
můžete volně kombinovat, dokud nedosáhnete kýženého vzhledu. K určení typu
položky seznamu použijte některý z následujících znaků.
</p>
<table>
<tr><th>Znak</th><th>Typ položky seznamu</th></tr>
<tr><td>*</td><td>Nesetříděný seznam (puntík před položkou)</td></tr>
<tr><td>#</td><td>Setříděný seznam (1,2,3 atd.)</td></tr>
<tr><td>:</td><td>Seznam definic, definice</td></tr>
<tr><td>;</td><td>Seznam definic, text</td></tr>
</table>
<p>Příklad vnořeného seznamu:</p>
<p><pre>
* první puntík
* druhý puntík
## vnořený řádek 1
## vnořený řádek 2
* třetí puntík
</pre></p>
<p>Zobrazí se jako:
<ul><li>první puntík</li>
<li>druhý puntík</li>
<ol><li>vnořený řádek 1</li>
<li>vnořený řádek 2</li></ol>
<li>třetí puntík
</ul></p>
<h3>Formátování uvnitř řádku</h3>
<p>
Formátování uvnitř řádku umožňuje označit část řádku tak, aby měla určitý styl.
Speciální formátovací znaky se mohou objevit kdekoliv na řádku, ale mějte na
paměti, že nemohou přecházet na další řádek. Následují ukázky kódu.
</p>
<table>
<tr><th>Wiki kód</th><th>Bude vypadat jako</th><th>Formátování</th></tr>
<tr><td>*hello world*</td><td><strong>hello world</strong></td><td>Silné, tučné</td></tr>
<tr><td>/hello world/</td><td><em>hello world</em></td><td>Zvýraznění, kurzíva</td></tr>
<tr><td>+hello world+</td><td><ins>hello world</ins></td><td>Vsazený text</td></tr>
<tr><td>-hello world-</td><td><del>hello world</del></td><td>Smazaný, přeškrtnutý</td></tr>
<tr><td>hello ~world~</td><td>hello <sub>world</sub></td><td>Dolní index</td></tr>
<tr><td>hello ^world^</td><td>hello <sup>world</sup></td><td>Horní index</td></tr>
<tr><td>"hello world"</td><td><q>hello world</q></td><td>V uvozovkách</td></tr>
<tr><td>%hello world%</td><td><code>hello world</code></td><td>Kód, pevná šířka</td></tr>
<tr><td>@hello world@</td><td><cite>hello world</cite></td><td>Citace</td></tr>
</table>
<h3>Zkratky</h3>
<p>
Vysvětlivky zkratek psaných velkými písmeny se umisťují bezprostředně za
zkratku do uvozovek (mezi posledním velkým písmenem zkratky a závorkou nesmí
být mezera). Například:
</p>
<p>
HTML(Hypertext Markup Language)
<br />
bude převeden na
<br />
<acronym title="Hypertext Markup Language">HTML</acronym>
</p>
<h3>Hypertextové odkazy</h3>
<p>
URL odkaz se umístí do textu a bezprostředně za něj (bez mezery) se napíše
text do uvozovek. Z tohoto textu se stane odkaz na zadanou URL. Například:
</p>
<p>
<em>http://www.google.com/(Vyhledat Googlem)</em>
<br />
bude převeden na
<br />
<a href="http://www.google.com/">Vyhledat Googlem</a>
</p>
<p>
Podobným způsobem jsou automaticky převáděny emailové adresy:
</p>
<p>
nikdo@nikde.com(Pokusný uživatel)
<br />
bude převeden do
<br />
<a href="mailto:nobody@example.com">Pokusný uživatel</a>
</p>
<h3>Odkazy na Moodle Moduly</h3>
<p>
Znáte-li id číslo zdroje (podívejte se na ?id=nn na konci URL adresy) a název
modulu, můžete na příslušný zdroj odkazovat použitím syntaxe:
</p>
<p>
NázevModulu:nn(Popisný text)
</p>
<p>
např. <em>resource:36(Moje nová stránka)</em> <em>forum:10(Přejít do
diskusního fóra)</em>
</p>
<h3>Vkládání obrázků</h3>
<p>
Pomocí Wiki můžete snadno vkládat do vašich stránek obrázky. Nejprve pomocí
správce souborů nahrejte obrázek do Moodle a zapamatujte si cestu k tomuto
souboru. Poté stačí psát:
</p>
<p>
/<em>..cesta k souboru..</em>(Alterantivní text)
</p>
<p>
např. /moje/pic00.jpg(Můj obrázek)</p>
<h3>Automaticé přeformátování</h3>
<p>
Množství obecně používaných textů je automaticky převedeno do jejich XHTML
ekvivalentů. Mezi ty nejdůležitější patří:
</p>
<ul>
<li>HTTP odkazy jsou převedeny na aktivní odkazy
<li> ..., (R), (TM), (C), 1/4, 1/2, 3/4 jsou převedeny na odpovídající znak
<li> číslo x číslo se převede s použitím znaku pro násobení
<li>Řádek začínající nejméně čtyřmi pomlčkami je automaticky převeden na
horizontální čáru
</ul>
<h3>Kontrola pravopisu (zatím zkušební verze)</h3>
<p>
Wiki může být přepnuto do režimu kontroly pravopisu. Umístěte do textu
následující řádku a vše, co následuje, bude zkontrolováno:
<pre>
!SPELL:kód_jazyka:varianta_jazyka
Příklady:
!SPELL:en:british
!SPELL:cz
</pre>
<p>
"kód_jazyka" nahraďte příslušným kódem (například en, fr, sk apod.),
"varianta_jazyka" (za dvojtečkou) je volitelná a může nabývat hodnot
"american", "british" nebo "canadian", je-li "kód_jazyka" en.
</p>
<p>
Při zobrazování jsou všechna neznámá slova zvýrazněna a návrhy na opravu
pravopisu můžete vidět, ponecháte-li kurzor myši na zvýrazněným slovem.
</p>
<p><em>POZNÁMKA: kontrola pravopisu používá knihoven <strong>pspell</strong>.
Pro správnou funkci musí být tyto knihovny a odpovídající adresáře nainstalovány
na vašem serveru (jinak bude PHP hlásit chybu "calling undefined function").
Platforma Windows není plně podporována.</em>
</p>