rady zacatecnikovi ...

Mošnička Roman RMosnicka na cpoj.cz
Čtvrtek Říjen 17 15:28:12 CEST 2002 

Dobry den,
potrebuji vytvorit obsahlejsi dokumentaci k systemu. Zkusil jsem tedy sahnou po docbooku a verim ze az se prenesu pres pocatecni problemy,tak 
mi to "ponese ovoce" jak uz je u linux. programu zvykem :-)

Mam RH 7.2 a z distribuce mam nainstalovane baliky:
docbook-dtd30-sgml-1.0-10
docbook-utils-0.6.9-2.1
docbook-dtd31-sgml-1.0-10
docbook-dtd41-sgml-1.0-10
docbook-style-dsssl-1.64-3
docbook-dtd412-xml-1.0-1
docbook-dtd40-sgml-1.0-11
docbook-dtd41-xml-1.0-7
docbook-utils-pdf-0.6.9-2.1
openjade-1.3-17
jadetex-3.11-4
sgml-tools-1.0.9-12
sgml-common-0.5-7

Na stranka www.kosek.cz jsem se dozvedel zhruba nasledujici (tedy tak to chapu ja)

1. Pro tvorbu dokumentu docbooku se pouziva jazyk XML - coz je nejaky "mark language"
2. Pokud chci xml dokument zobrazit, potrebuji mit k dispozici styl, ktery mi definuje zobrazeni jednotlivych elementu v XML souboru
3. Jako stylovy jazyk mohu pouzit XSL nebo DSSSL
4. Pro zpracovani techto stylu budu potrebovat nejaky "stylovy procesor"(mozna jsem take nekde narazil na termin parser ...?) - pro DSSSL to bude openjade pro XSL nevim

Kdyz se nadale budu zabybat pouzitim DSSSL stylu, tak XML soubor zpracuji nasledovne :
jade -d styl -t výstupní_formát XML_deklarace soubor.xml
Tady uz presne nerozumim parametru styl a XML_deklarace - jaky je mezi tim rozdil ??
Nicmene jsem zkousel prelozit dokument prvni.xml, ktery ma p. Kosek na svych strankach - dokument je viz nize
Tento xml soubor jsem zkousel do rtf formatovat zhruba takto:
vyexportoval jsem si promene
SGML_CATALOG_FILES=/usr/share/sgml/openjade-1.3/catalog:/usr/share/sgml/sgml-iso-entities-8879.1986/catalog:/usr/share/sgml/docbook/sgml-dtd-4.1/catalog
XML_CATALOG_FILES=/usr/share/sgml/docbook/xml-dtd-4.1/catalog

jade -d /usr/share/sgml/docbook/dsssl-stylesheets-1.64/print/docbook.dsl -t rtf /usr/share/sgml/docbook/dsssl-stylesheets/dtds/decls/xml.dcl prvni.xml

dostal jsem takoveho chybove hlaseni 
jade:druha.xml:3:66:E: URL not supported by this version
jade:druha.xml:3:66:E: DTD did not contain element declaration for document type name
jade:druha.xml:4:11:E: there is no attribute "lang"
jade:druha.xml:4:15:E: element "book" undefined
jade:druha.xml:5:11:E: element "bookinfo" undefined
jade:druha.xml:6:10:E: element "title" undefined
jade:druha.xml:7:11:E: element "author" undefined
jade:druha.xml:8:16:E: element "firstname" undefined
jade:druha.xml:9:14:E: element "surname" undefined
jade:druha.xml:12:10:E: element "preface" undefined
jade:druha.xml:13:10:E: element "title" undefined
jade:druha.xml:14:9:E: element "para" undefined
jade:druha.xml:15:9:E: element "para" undefined
jade:druha.xml:17:10:E: element "chapter" undefined
jade:druha.xml:18:10:E: element "title" undefined
jade:druha.xml:19:9:E: element "para" undefined
jade:druha.xml:20:9:E: element "para" undefined
jade:druha.xml:22:10:E: element "chapter" undefined
jade:druha.xml:23:10:E: element "title" undefined
jade:druha.xml:24:9:E: element "para" undefined
jade:druha.xml:25:9:E: element "para" undefined
jade:druha.xml:27:11:E: element "appendix" undefined
jade:druha.xml:28:10:E: element "title" undefined
jade:druha.xml:29:9:E: element "para" undefined
jade:druha.xml:30:9:E: element "para" undefined
jade:/usr/share/sgml/docbook/dsssl-stylesheets-1.64/print/docbook.dsl:268:69:W: cannot generate system identifier for public text "-
//Norman Walsh//DOCUMENT DSSSL Library V2//EN"
jade:/usr/share/sgml/docbook/dsssl-stylesheets-1.64/print/docbook.dsl:311:8:E: no style-specification or external-specification with
 ID "DBLIB"
jade:/usr/share/sgml/docbook/dsssl-stylesheets-1.64/print/dbparam.dsl:1021:2:E: quantity "pi" undefined
jade:/usr/share/sgml/docbook/dsssl-stylesheets-1.64/print/dbparam.dsl:1033:2:E: quantity "pi" undefined
...
...
... atd
a vysledny rtf soubou je spatny


Muzete mi nekdo jednoduse vysvetlit nasledujici:
Jaky je rozdil v parametru pro jade mezi stylem a xml_deklaraci ?
Proc musim mit vyexportovanou promenou SGML_CATALOG_FILES a XML_CATALOG_FILES, co to je ten catalog a proc musim mit cestu ke katalogu k jade, ke katalogu iso-entities a sgml ?
Co jsem pravdepodobne udelal spatne, nebo neudelal, ze se mi nepovedlo prelozit soubor prvni.xml ?
Kdyz budu chtit napriklad pomoci docbooku vytvaret pouze rtf co musim mit pouze nainstalovane ? - takze bude to jade,docbook-style-dsssl a jeste neco ?

Predem dekuji za pripadne rady ci nasmerovani 
S pozdravem Roman Mošnička


Testovaci XML dokument prvni.xml
----------------------------------------------------
<?xml version='1.0' encoding='windows-1250'?>
<!DOCTYPE book PUBLIC '-//OASIS//DTD DocBook XML V4.2//EN' 
          'http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd'>
<book lang="cs">
  <bookinfo>
    <title>První pokusná kniha</title>
    <author>
      <firstname>Jioí</firstname>
      <surname>Kosek</surname>
    </author>
  </bookinfo>
  <preface>
    <title>Úvod</title>
    <para>Odstavec textu.</para>
    <para>...</para>
  </preface>
  <chapter>
    <title>První kapitola</title>
    <para>Text první kapitoly</para>
    <para>...</para>
  </chapter>
  <chapter>
    <title>Druhá kapitola</title>
    <para>Text druhé kapitoly</para>
    <para>...</para>
  </chapter>
  <appendix>
    <title>První poíloha</title>
    <para>Text poílohy</para>
    <para>...</para>
  </appendix>
</book>

Další informace o konferenci Docbook