Fórum Root.cz

Hlavní témata => Software => Téma založeno: Martin Landa 05. 10. 2012, 10:19:59

Název: V čem vytvářet tutoriál?
Přispěvatel: Martin Landa 05. 10. 2012, 10:19:59

Zdravim, chystam se vytvorit tutorial na pouzivani daneho softwaru. Tutorial bude obsahovat

• volny text
• formatovany text (ukazky zdrojovych kodu, prikazy - se zvyraznenim syntaxe, cislovani radek)
• obrazky
• videa

Zakladni pozadavky:

• fulltext
• obsah

Bonus:

• moznost internaciolanizace, tj. prekladu textu, s tim, ze se vysledny tutorial vygeneruje na zaklade sablony

Uvazoval jsem o Sphinx [1] (bez internacionalizace, tutorial by se musel do dalsiho jazyka prelozit jako celek), samorejme Docbook. Mate nekdo nejaky dalsi tip, vlastni zkusenosti? Predem diky za kazdou radu...

ML

Název: Re:V čem vytvářet tutoriál?
Přispěvatel: alef0 05. 10. 2012, 11:14:36

Cielovy format je HTML? Alebo chcete aj PDF podporu?

Název: Re: V čem vytvářet tutoriál?
Přispěvatel: dumblob 05. 10. 2012, 17:41:21

markdown z pandoc

Název: Re:V čem vytvářet tutoriál?
Přispěvatel: ertwertwert 05. 10. 2012, 21:18:07

ja mam rad old school txt pripadne html tutorialy viz nasledujici:

v tomhle jsem kdysi sedel neustale: http://www.ucw.cz/~hubicka/skolicky/

ascii art+tutorial to miluju neustale, to mi umozni zapomenout na dnesni silenou dobu milionu frameworku a vzpomenout na dobry jednoduchy linux :-)
http://www.ucw.cz/~hubicka/skolicky/UNIX.Hrdonka.txt

http://www.ludd.luth.se/~vk/pics/ascii/junkyard/techstuff/tutorials/Joan_Stark.html

Název: Re:V čem vytvářet tutoriál?
Přispěvatel: Róbert Novotný 06. 10. 2012, 12:49:15

Kedysi som vyrábal tutoriály v nacustomizovanom PmWiki markupe, potom niektoré v DocBooxu (v XmlMind XM Editore), ale teraz prakticky všetko píšem v Extended MarkDowne. Jednoducho preto, že nemusím sa zdržovať s tagovaním a podobnými vecami a len práskam text v editore.

Je to niečo podobné, ako písal ertwertwert, akurát môj výstup ide do WordPressu, ktorý to sformátuje, osyntaxhighlightuje a urobí z toho civilizovaný text.

Obrázky sú trochu opruz (v porovnaní s DocBookom), ale na lepšie riešenie som neprišiel.