Názory k článku DocBook a jeho použití

No, nezlobte se na me, ale kdyz jsem cetl tento clanek, tak jsem si rikal, ponekud rozvlekly uvod. A v tu chvili ten clanek skoncil. Nemelo tam byt 'pokracovani priste...'?

A to jsem se puvodne tesil, ze se dozvim neco noveho :(.

No, ja jsem si kliknul na odkaz dole a prolistoval autorovu bakalarskou praci a myslim, ze to muze uzitecne.

pokracovani bude, prece nemuzu dat hned do uvodu vsechno

Nevěděl jsem, že jsi se nechal unést rozvláčností Aloise Jiráska. :-)

Zda sa, ze generovanie PDF vystupu zo slovenskeho SGML dokumentu obsahujuceho diakriticke znaky je nedoriesene. Miesto znakov ako ľ, ž alebo č (plati to aj pre ine) sa zobrazuje akysi nezmyselny balast. Vam to funguje?

S anglickymi textami a dokumentaciami problem nemam. Vlastne presne toto bol dovod, preco sa kolega rozhodol pisat diplomovku v TeXu a nie v Docbooku.

Cestina mi bez problemu funguje pri postupu:

Docbook -> (Saxon) -> .fo -> (fop) -> .pdf

Nejspíše se jedná o chybu v nastavení nástrojů? Jaké byly použity? Vzhledem k tomu, že vstup byl v SGML nejspíše jste použil Jade+JadeTeX. Nejpravděpodobnější příčinou bude chybné nastavení proměnné prostředí SP_ENCODING. Ta musí obsahovat kódování vstupních SGML dokumentů. Druhá varianta je její nastavení na hodnotu "XML" a na začátek dokumentu pak psát <?xml version="1.0" encoding="iso-8859-2"?>.

Nastavenie premennej prostredia SP_ENCODING na hodnotu "iso-8859-2" problem vyriesilo. Dakujem.

Neni trosku zavadejici tvrdit, ze HTML je podmnozinou XML? Mel jsem za to, ze HTML rozhodne nedorzuje konvence XML a je tutiz spis podmnozinou SGML.
Nebylo by fajn uvest aspon kratky priklad a jeho mozne vystupy? Souhlasim s cohenem, z clanku jsem nepochopil co chtel autor rict.

DocBook nezvlada uspokojive psani matematickych rovnic, takze pozor , protoze velka cast lidi, kteri prave nepisi diplomky v Wordu, OpenOffice apod. a pisi je v texu, tak DocBook nemuze pouzit.

Pro matematiku je mozne pouzit MathML. Neni to tezke a da se tim docilit to same, jako v LaTeXu. Jen nevim jak je to potom s konvarzi do pdf a to by mohl byt problem. Ja sam pisu diplomku v LaTeXu, protoze se mi jevi vhodnejsi.

Že je možné s MathML dosáhnout to samé jako v [La]TeXu, a navíc to není těžké, to bych teda netvrdil. Má-li sazba matematiky za něco stát, je potřeba více méně ručně doladit spoustu jemností, které z logické ani fyzické struktury vzorce přímo nevyplývají. To v TeXu jakožto low-level sázecím jazyku jde, zatímco v MathML teda nevím nevím....

Koukal jsem na nejake priklady v MathML a prijde mi, ze psat to rucne je holy nesmysl, je to jako stvorene pro nejaky generator (ktery to treba prelozi z vyrazu v prirozene (infixove) forme). Proto nevidim duvod, proc to psat v XML, kdyz v TeXu se to hodne podoba puvodnimu zapisu :-)

Idealni pouziti DocBooku a MathML vidim treba tam, kde pisu dokumentaci k softu, ktery pracuje s vyrazy a uklada si je v MathML treba do souboru a ty ja pak vezmu a pouziju v dokumentaci.

Nicmene psat rucne do diplomky vyrazy v MathML je ztrata casu (ale kdo chce kam ... )

Obecne mi pripada, ze co se XML tyce, tak spousta lidi nevi, jak s nabytou technologii a jeji znalosti zachazet, ale to je spis namet na filosofickou debatu.

Hodne Zdaru
Honza K.

Taky mam ten pocit. Videl jsem jak OpenOffice uklada vzorce v MathML a to co v LaTeXu je na jeden radek je vtom skoro na pul obrazovky.

Offtopic: Zkouseli jste nekdy unzip na dokument z OOWriteru?

i v DocBooku se pouzit matematika, nejjednoduzsi je pouzit TeXovou notaci, ta se do HTML transformuje jako obrazek a v PDF se zobrazi nativne. Ukazky pouziti matematiky jsou v navodu: http://www.fi.muni.cz/~xpavlov/xml

rozhodne neznamena DocBook konec TeXu, je to jen jista alternativa pro ty, kteri to v TeXu (LaTeXu) psat nechteji, plus se da s dokumentem v DocBooku delat spousta jinych logickych transformaci

Vetsinou se snazim byt nad veci, ale pokud si da nekdo uz do uvodniho nadpisu blud tak se tezko udrzim. Na pocatku DocBooku pochopitelne nebylo XML. Naopak by slo tvrdit opak. Jeste pred XML zde bylo SGML a jiz v nem existoval DocBook. XML pak prevzalo par zakladnich veci ze SGML a byla vytvorena mnozina DocBooku i pro XML.

Dalsi blud: co ma spolecne HTML a XML? Opravdu to co projde nejakym HTML validatorem by proslo XML parserem? Zkuzte v nejakem XML parseru udelat z uvodni stranky root.cz DOM.. Mozna by bylo lepsi hovorit o XHTML pokud ma neco byt podmnozinou XML.

Dle meho nazoru je DocBook trosku problematicka vec. K cemu ma slouzit? K sazeni dokumentu? Kdo v tom zkusil napsat neco vic nez nadpis kapitoly (treba matematicky vzorec), vi ze ne (v diskusi to jiz zaznelo). Na web je tu zase XHTML. Zkratka pokus vytvorit vseobjimajici XML aplikaci neni uplne stastny a navic se tim ztraci vyhody XML (neni definovana pevna mnozina tagu, DocBook jich definuje ohromne mnozstvi, ktere ovsem nemusi byt pro sazbu dostatecne).
Ano urcite to muze byt zajimava vec pro psani urcite tridy textu a po te pres ruzne transformace dostavat XHTML stranky ci pdf. Pokud ale potrebujete sazet napr. matematiku, neni v lidskych silach to napsat, tzn. vhodnejsi by bylo psat dokument v nejakem klikatoru. Pak je otazka na kolik je pro me zajimave znat dalsi elementy a mit vubec tuseni o nejakem XML co se za tim skryva. V te chvili to spis muze byt uz "jenom" soubor do ktereho se ulozi vysledek klikani. Proc ale potom neco takoveho pouzivat a nepsat to primo v TeXu? Tim chci rict, ze bychom se nemeli nechat unest kouzelnymi sluvky ale divat se na to spise z praktickeho hlediska.

DocBook je formát pro zápis dokumentace, především pro software. K čemu je to dobré? K tomu aby tuto dokumentaci šlo snadno přenášet (proto se jedná o standardizovaný formát) a aby jí šlo snadno převádět do dalších formátů jako (X)HTML, PDF, RTF, HTML Help. Většinou totiž dokumentaci chcete jen v jednom formátu.

Kromě dokumentace lze DocBook použít i pro další druhy dokumentů jako knihy, články, FAQ apod. DocBook rozhodně není sázecí systém, naopak se snaží dokument maximálně oddělit od jeho vzhledu. To proto, abyste ho mohl převést do dalších formátů, které potřebujete, a které mohou mít dost rozdílnou podstatu.

To je samozrejme pravda, pokud je to XML dokument, muze se s tim jako s XML dokumentem zachazet (transformace do jinych XML aplikaci ci binarnich souboru atd.). Jenom si myslim, ze casto slychana fraze o tom ze DocBook slouzi pro psani libovolne dokumentace zkratka neni pravdiva.

A jaký druh dokumentace se vám nepodařilo v DocBooku vytvořit? Byl bych nerad, kdyby vznikly další fráze nepodložené fakty. :-)

Např. dokumentaci ke GNU Scientific Library si představuju v DocBooku těžko, právě kvůli velkému množství matematiky (je napsaná v texinfu). Samozřejmě by to šlo, zejména proto, že v technické dokumentaci se na nějaké jemnosti sazby matematiky stejně moc nehraje. Nicméně by byla sebevražda psát to MathML ručně, což je pruda, protože jsem vždycky považoval za výhodu SGML obecně a DocBooku konkrétně, že jde psát (opravovat, doplňovat) i ručně. texinfový zroják je oproti tomu pohodlně čitelný a modifikovatelný (pro TeXisty ;-)

... sice to uplne nesouvisi, ale je to celkem legracni:

http://www.fi.muni.cz/~xpavlov/xml/

a dale:

http://www.fi.muni.cz/~xpavlov/xml/examples/bc1/bc1.xhtml

Tvorba dokumentu v XML: Jan Pavlovič
Prohlášení: Prohlašuji, že tato bakalářská práce je mým původním autorským dílem, které jsem vypracovala samostatně. Všechny zdroje, prameny a literaturu, které jsem při vypracování používala nebo z nich čerpala, v práci řádně cituji s uvedením úplného odkazu na příslušný zdroj.

Tak kdo to vlastně psal? :-) [nic ve zlem...]

Moc nerozumim? Co je na tom zvlastniho, pokud cerpal z nejake literatury uvest ji seznamu referenci? Zrejme doslo k nejakemu nedorozumeni.

vypracovala ... pouzivala ... nebo je autor opravdu zena? Mozna ze jsem z jine planety ja ;-)

No, pokud se podivam do xml zdrojaku, tak hned na zacatku je <fi:woman>true</fi:woman> , rekl bych ,ze se autor prepsal - no a pak se vsechny auto-generovane texty vygerenovaly v zenskem rode :-)

Autor diplomky ten text pravdepodobne obslehl z jedne stranky, kde se radilo, jak ma diplomka na FI MU vypadat. Ten, kdo ty rady psal, byl ale nepritel, protoze text byl urcen pro asi 1 % posluchacu fakulty informatiky (rozumej, pro zeny a divky). :-))
Ja jsem si toho vsiml asi den pred tiskem ... :-))

:) ne autor opravdu neni divka, z testovacich duvodu jsem samo zkousel i volbu pro nezne pohlavi, jaxi pretvrvala az do finalni verze, jinak to prohlaseni, je dane fakultou, takze vsichni studenti ho musi ve sve praci obsahovat ... ale to je mimo ramec diskuze

Omlouvam se, tech -la jsem si vubec nevsiml. :-)

Toto je oficialni zneni prohlaseni o puvodnosti dila, ktere je predepsano a musi byt soucasti vsech zaverecnych praci na FI MU.

Jak to vypada s UTF-8 a zpracovanim DocBooku? Proleze to omegou, nebo proste mam s TeXem smulu a musim pouzit neco jineho? A co jine konvertory? Kudy a kam to projde a kudy a kam ne?

Diky,
W.

Asi jsem úplně nepochopil váš problém.

DocBook je formát postavený nad XML, takže můžete použít libovolné kódování, stačí jej uvést v XML deklaraci. Např.:

<?xml version="1.0" encoding="iso-8859-2"?>

Pro zpracování docbookových dokumentů nepotřebujete Omegu. JadeTeX a PassiveTeX, které se mohou používat během sazby XML dokumentů implementují podporu Unicode nad klasickým 8bitovým TeXem. Jejich práce nezávisí na kódování vstupních XML souborů, protože ty se nejprve stejně zpracovávají pomocí procesoru DSSSL nebo XSL.

Pred casem jsem si psani v docbooku diky instalacnimu archivu pana Koska zkusil. Musim rict, ze jsem byl velice mile prekvapen a docbook se mi zda hodne vymakany nastroj na psani DOKUMENTACE. Ale to je kamen urazu -- plno lidi stale neni schopno pochopit, ze se primarne jedna o format k psani dokumentace! Nic vic nic min. Chtit po docbooku aby umel kvalitni sazbu matematiky a ja nevim ceho jeste je nesmyslne -- v lednicce prece nepereme pradlo, ne?

Osobne davam tomuto formatu velkou sanci. Ta moznost ziskat vice formatu (bez ztrat) je dokonala.

Bohuzel ja zustavam u LaTeXu, protoze ta matematika je pro me zasadni nedostatek. Kdyby ale nekdo upravil tento format i pro tyto ucely tak okamzite presedlavam :-) Ty stavajici moznosti sazby matematiky jsou opravdu priserne...

Nekdo v diskusi napsal, ze pochybuje ze v tom nekdo pise vice nez jenom nadpis kapitoly. No nevim, treba takovy Vim Book (http://www.iccf.nl/click5.html) byl cely napsan v docbooku..... Akorat si nedokazu predstavit jak to nekdo smolil ve Vimu :-) Mimochodem nevite nekdo o necem jako psgml for Vim?

Do DocBooku lze vkládat matematické vzorce v TeXu. Zpracování dokumentů je pak omezeno na nástroje, které jsou postaveny nad TeXem -- tj. DSSSL styly + JadeTeX, resp. XSL styly + PassiveTeX. Při konverzi do HTML se z matematiky udělají obrázky.

http://docbook.sourceforge.net/release/xsl/current/doc/html/tex.math.in.alt.html

http://ricardo.ecn.wfu.edu/~cottrell/dbtexmath/

no to sice ano, ale je to takove "neakcni". navic pokud chci export do rtf, tak ty rovnice urcite nemuzu dale upravovat ...

navic mam pocit, za to neumi klasicke cislovani rovnic:
x+y = 1 (1)
x+y = 2 (2)

a urcite to nema takove vychytavky jako eqnarray apod .....

Ma to vsechny vychytavky, ktery dam zadas, funguje to tak, ze to vezme cistej texovej zapis a vlozi ho do vygenerovanyho latexovyho kodu. Matematiku to zatim umi do HTML a LaTeXu. Coz pokud nechces psat neobvykle graficky vychytanou dokumentaci je naprosto super.