Názory k článku Budoucnost dokumentace pro OSS

Jirko, osobnosti se sesly, to je 5. trida ZS

Opraveno

........... vydělat si tak na živobití.

(ve ktere tride se berou vyjm. slova)?

Nestvete mne s pravopisem. Mislim, ze dulezitejsi je obsah, ne? Clanek je mislim dobrej a da se mu rozumet i kdiz bych rad slisel i osobni zkusenosti autora s produktem a jak a proc to delat timto zpusobem. Jsem pro zruseni Y a zavedeni premysleni do skol.

Cao

Důležité jsou obě věci. Bohužel jsem neměl v San Diegu kde článek vytisknout a přečíst ho po sobě, takže je v něm mnohem více chyb než obvykle produkuji. Čtenářům se omlouvám.

Zrusenim Y byste se o spoustu premysleni pripravil. :o)))

Podle meho mazoru je docela jedno jaky bude format dokumentace, hlavne aby byla napsana tak aby ji clovek porozumnel.
A pokud se vyvine novy format, tak doufam ze si jeho prohlizec budu moci velmi rychle a jednoduse nainstalovat.

Není jedno, jaký bude formát dokumentace. Je totiž důležité, aby dokumentaci bylo možno snadno napsat a snadno přečíst. Jako určitou slabinu DocBooku vidím to první, XML zrovna velkou přehledností a snadností editace neoplývá (ani v Emacsu s PSGML:-). Mně
osobně se nejlépe píše v Texinfo. To má sice jiné mouchy v podobě nedostatečné strukturovanosti a potažmo pak závislosti na TeXu, nicméně i přesto mi jako autorovi i čtenáři (s ohledem na *současný* nevalný stav DocBookových nástrojů) vyhovuje Texinfo mnohem lépe než DocBook, takže zůstávám na špatné koleji. :-)

No ja naopak pred texinfo preferuju XML. Na DocBooku me vadi hlavne to,
ze ma minimalni podporu matematiky (i te nejjednoduzsi, takze v praxi
se vracime do doby, kdy se matematika simulovala na psacich strojich,
coz je hruzaaaa!!

Já bych to s tou podporou matematiky neviděl tak zle. Jednak existuje rozšíření DocBooku o MathML (http://www.oasis-open.org/docbook/xml/mathml/index.shtml). V místech elementech pro zápis rovnic (*equation) lze používat kompletní MathML. Chce to však mít nějaký dobrý editor, protože psát MathML ručně je dost pomalé. Pro zpracování DocBook+MathML již nějaké nástroje také existují. Pro převod do HTML lze použít standardní XSLT styly, pokud prohlížeč umí MathML, mat. výrazy se zobrazí (Amaya, Mozilla). Pokud potřebujete tištěný výstup, můžete použít XSL styly pro výstup do formátovacích objektů a výsledek zpracovat PassiveTeXem. PassiveTeX sice neumí kompletní MathML, ale mnoho věcí v tom udělat jde.

Dalším řešením je zápis rovnic v TeXu. Buď můžete rovnou rovnice zapisovat do docbookového dokumentu a upravit si styly tak, aby se texový kód beze změn předal JadeTeXu nebo PassiveTeXu. Druhou možností je zapsat každou rovnici v texové notaci do samostatného souboru a ty vkládat jako obrázky. JadeTeX umí zpracovat obrázky ve formátu TeX tak, že je vysází jako normální texovou rovnici.

Lepší podporu matematiky už DocBook asi mít nemůže, ledaže by mi něco uniklo. Přidat rovnou do DTD DocBooku dalších několik set elementů pro zápis vzorců je v dnešní době XML a jmenných prostorů trošku zvrácená představa.

Jasne, ze cesta je MathML. Styl k DocBooku samo mam. Zatim se me jej ale nepdarilo poradne rozchodit. Nevim treba kde vzit
ten MathML editor, protoze vazne bez nej to asi nepujde udelat jinak. Zkousel jsem ruzne odkazy
ma www.mathml.org (tak nejak se to jmenuje) ale nic jsem nerozchodil. Ruzne flikovani s texem
nepovazuju za idealni reseni. No casem, az budu nucen se na to zase kouknu, bylo by to fajn,
s docbookem se me pracuje prijemne.:-) Jen by me zajimalo, jestli treba openoffice nebo staroffice
bud enekdy casem schopne pouzivat i treba docbookstyles. To by bylo vubec uplne idelani, uz jen proto,
ze bych si mohl ty vzroce psat v of:-)

takže pojďme přeložit zase kousek manuálů do češtiny
czman-help@linux.cz
czman@linux.cz