[ Goran Rakić @ 28.09.2002. 18:47 ] @
Treba mi da za neke svoje projekte napišem neku dokumentaciju. E sada ja bih hteo da to mogu kasnije lako da pretvorim u pdf, rtf, ps, html... Pogledao sam HOWTO HOWTO sa tldp.org, međutim ono je previše komplikovano! (ne znam za sam proces, ali je howto preobiman i pretežak, pa sam ga batalio na drugoj strani). Zanima me u čemu mogu da napišem dokumetaciju, kao i da li ima neki razuman how to.
[ Goran Rakić @ 29.09.2002. 08:13 ] @
na http://opensource.bureau-cornavin.com/ ima lep tekst o DocBook-u. Mislim da će mi koristiti.
[ Goran Rakić @ 29.09.2002. 08:17 ] @
a imaju i četiri pristupa u linuxgazette na:
http://www.linuxgazette.com/issue73/spiel.html - POD
http://www.linuxgazette.com/issue74/spiel.html - laTex
http://www.linuxgazette.com/issue75/spiel.html - DocBook i XMl
http://www.linuxgazette.com/issue76/spiel.html - TexInfo
[ Goran Rakić @ 29.09.2002. 11:11 ] @
how to

Prvo treba nabaviti alate za rad sa docbook-om (DTD, stilove, jade, parsere, kovertore i ostalo). Ja sam to poskidao sa ftp://sources.redhat.com/pub/docbook-tools/new-trials/ (koristio sam RPM-ove, mada ima i source-a a iz srpm-a se moze napraviti i tgz). Bitno je kojim redom trebate instalirati pakete:

Code:

# rpm -ih sgml-common*.rpm
# rpm -ih jade*.rpm
# rpm -ih jadetex*.rpm
# rpm -ih docbook-dtd40-sgml*.rpm
# rpm -ih docbook-style-dsssl*.rpm
# rpm -ih perl-SGMLSpm*.rpm
# rpm -ih docbook-utils*.rpm


Posto mi se default stil ne svidja, koristio sam onaj sa LDP-a. Znači preuzmite http://www.tldp.org/authors/tools/ldp.dsl i snimite ga u neki direktorijum (ovim dobijate posebne nazive, nove tagove, drugačiji stil i još ponešto). Sada treba napisati DocBook fajl koji posle mozemo konvertovati u HTML, TeX, PostScript, RTF, PDF, Man, TexInfo a iz toga i u ostale formate što je zaista impresivno.

ldp.dsl morate malo modifikovati. Naime na vrhu fajla se nalaze sledeći redovi:
Code:

<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [
<!ENTITY % html "IGNORE">
<![%html;[
<!ENTITY % print "IGNORE">
<!ENTITY docbook.dsl SYSTEM "docbook.dsl" CDATA dsssl>
]]>
<!ENTITY % print "INCLUDE">
<![%print;[
<!ENTITY docbook.dsl SYSTEM "docbook.dsl" CDATA dsssl>
]]>
]>


Potrebno je kazati stilu gde se nalaze docbook.dsl html i print fajlovi. locate docbook.dsl će kazati istinu pa sam ja prvi zamenio sa /usr/share/sgml/docbook/dsssl-stylesheets-1.76/html/docbook.dsl a drugi sa /usr/share/sgml/docbook/dsssl-stylesheets-1.76/print/docbook.dsl. Snimite fajl.

Na ldp-u postoji i zgodan template a možete ga videti na http://www.tldp.org/authors/template/index.html.Sam kod se preuzima sa http://www.tldp.org/authors/template/big-howto-template.sgml. Snimite ovaj fajl zajedno sa ldp.dsl fajlom i odradite sledeću naredbu:

Code:

docbook2html -d ldp.dsl#html big-howto-template.sgml


Time ćete dobiti *.html fajlove, od kojih je prvi index.html. Pored ove postoje i docbook2dvi docbook2html docbook2man docbook2pdf docbook2ps docbook2rtf docbook2tex docbook2texi docbook2txt naredbe.

Sada zavirite u big-howto-template.sgml i izmenjajte šta sve treba i dobićete lepi howto, koji može da se konvertuje u sve i svja.
[ Goran Rakić @ 30.09.2002. 14:18 ] @
e sada kada bih prolvalio kako da koristim popularna "naša" slova u celoj priči...
[ Goran Rakić @ 30.09.2002. 17:37 ] @
Što volim da pričam sam sa sobom... ;)

Naime, podesio sam "naša" slova u docbook-u na iso-8859-2 charset tako što sam izmeni dssl šablon i podesio jade da radi sa ovim charset-om. Za HTML nije problem, jer sam u šablonu napisao da ubaci <meta http-equiv... > i naša slova se lepo vide. Takođe sma stavio lang="sr" zako da je ono Home, Next, Previous sada Kući, Sledeći, Prethodni. Kada koristim docbook2txt isto je ok, jer on konvertuje č u c itd. Problem su docbook2rtf , 2pdf i 2ps koje prikazuju iso-8859-1 charset. Kako to da sredim?
[ Goran Rakić @ 13.01.2003. 19:45 ] @
još uvek mene ovo zanima i još uvek nisam našao rešenje (doduše od zadnjeg posta do danas ga nisam ni tražio ;) ). Koliko sam do sada skapirao nemoguće je koristeći SGML napraviti iso8859-2 ili utf8 kodiranje. Šta preostaje...

Post je čisto za buđenje teme iz mrtvih...
[ Dejan Lozanovic @ 13.01.2003. 19:59 ] @
Pa eto da ne bude vise monolog, ja bih tu toplo preporucio da koristis latex, pre svega cela akademska javnost koristi tex kao osnovno sredstvo razmene dokumenata. Plus lako se dobije gotov proizvod za sve navedene formate koji su ti potrebni.
[ Goran Rakić @ 13.01.2003. 20:35 ] @
random se svojevremeno raspitivao po SGML listama kako da koristi latin2 tako da smatram da može da pomogne. Inače za XML postoji saxon koji valjda podržava utf8 kodnu stranu, ali ja nemam Java VM na linux-u. I da, viđao sam Docbook na češkom tako da sigurno može nekako, ali ne znam češki pa mi to ne znači mnogo.
[ -zombie- @ 13.01.2003. 20:55 ] @
kako be ne moze XML u utf? znam sigurno da moze. mada, ja sam uglavnom vidjao textove sa utf16 a ne 8, ali mislim da nema veze.

u zar doctype nije XML (a ne SGML)?


btw, nije bash tema za linux forum zar ne? ;)

mozda vise za XML forum (vidi u predlozi & pitanja)
[ tOwk @ 14.01.2003. 11:47 ] @
Uobičajen (,,default'') encoding za XML je UTF-8.

Za SGML je ISO-646 (praktično isto kao i US-ASCII).

SGML je mašinerija koja može koristiti bilo koji skup znakova, i sve što je potrebno je odgovarajuća SGML deklaracija uz odgovarajući skup (Unikod). Pošto je UTF zapravo Unicode Transformation Format, SGML procesor koji se koristi ga mora podržavati. ,,sp'' Džejmsa Klarka, i njegov naslednik ,,OpenSP'' nemaju problema sa UTF-8 zapisom. Oni se čak koriste i za procesiranje XML-a sa malim izmenama (,,sx'').

DocType postoji i u SGML, i u XML verziji (samo novije verzije, pa bi zanemarivanje SGML verzije značilo baciti hiljade dokumenata).


Kako izmeniti SGML deklaraciju da bi koristili neki od ISO-8559-x zapisa, pogledajte na http://www.jclark.com/sp/sgmldecl.htm

Za Jade je sigurno potrebna i izmena DSSSL definicija.

E da, naišao sam i na sajt o SGML na mađarskom jeziku: mada mađarski ne razumem, razumeo sam pojavu ,,Latin-2'' kao i komande koje se koriste. Primenite na srpski jezik sa stranice http://www.szabilinux.hu/ismerteto/sgml-tools-hogyan.html


PS. Proširio sam predlog za novi forum, izrazite svoje (ne)slaganje na http://www.elitesecurity.org/tema/18835