docbook sgml vs xml

Köszönöm a válaszokat!

Amint látom, gy.k. mindenki a markdown-t ajánlja - valóban elég egyszerűnek tűnik és a célra teljesen tökéletes, mert minimális változtatást kell csak elvégeznem a szövegen. Ennek ellenére mégis a docbook mellett döntöttem, mert - bár így tovább tart a cél elérése - szélesebb használható tudásra teszek szert szerintem.

@muszike:
Köszönöm a linkeket, mindegyik jól használhatónak tűnik, hasznukat fogom venni, miközben vim-ben szerkesztem az xml-t. :)
--
A kényszer helyett a tudásvágy vezessen a tanulásban!

Már egész átalakítottam az irományt docbook-ra, de egyenlőre a 4.1.2 áll a DTD-ben (a v5 motyeszokat nem sikerült működésre bírnom) viszont az lenne a kérdésem, hogy milyen "fordítót" ajánlotok (amit lehetőleg windows alól is tudok használni) és azt hogy lehet használni?

Az xsltproc jól működik a 4-es és 5-ös docbook-kal is, csak úgy látom, hogy windows-os verziót összehozni nem lesz egyszerű - hátha van jobb alternatíva.

Az xmlto hasznos, csak az a baj vele, hogy a docbook5 fájloknál "no DTD found!" üzenetet dob. Ugyan ezt meg lehet kerülni a --skip-validation kapcsolóval, de ez nem épp korrekt megoldása a dolognak.

A docbook-utils ilyen hibaüzeneteket dob xml fájloknál:

$ docbook2html tmp.docbk
Using catalogs: /etc/sgml/catalog
Using stylesheet: /usr/share/docbook-utils/docbook-utils.dsl#html
Working on: /media/winapp/xampp/htdocs/linux/parancsok/tmp.docbk
openjade:/usr/share/xml/docbook/schema/dtd/4.1.2/docbookx.dtd:74:17:E: "X20AC" is not a function name
openjade:/usr/share/xml/entities/xml-iso-entities-8879.1986/ISOamsa.ent:40:19:E: "X21B6" is not a function name

Próbáltam a '-n -c /etc/xml/catalog' kapcsolóval tiltani az sgml katalógust és helyette az xml-t használni, de nagyjából ugyanezek a hibák jelentkeztek.
--
A kényszer helyett a tudásvágy vezessen a tanulásban!

Muszike hozzászólása alapján csináltam egy 'önfejlesztő' alias-t a .bashrc-be:

# Az alap saxon-xslt-nek nem tudom atadni, hogy hasznalja a saxon extensions-t
# es xerces legyen az xml parser (ha argumentumkent adjuk at a classpath-ot,
# akkor a $CLASSPATH figyelmen kivul lesz hagyva).
if [ -f '/usr/share/java/saxon.jar' ]; then
    saxon='java -classpath /usr/share/java/saxon.jar'
    if [ -f '/usr/share/java/docbook-xsl-saxon.jar' ]; then
        saxon+=':/usr/share/java/docbook-xsl-saxon.jar'
    fi
    if [ -f '/usr/share/java/xercesImpl.jar' ]; then
        saxon+=':/usr/share/java/xercesImpl.jar                                                            \
              -Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl \
              -Djavax.xml.parsers.SAXParserFactory=org.apache.xerces.jaxp.SAXParserFactoryImpl'
    fi
    alias saxon-xslt="$saxon com.icl.saxon.StyleSheet"
fi

Működik is rendesen, Win-be is átírtam egy .bat-ba, az is okés. A .html kimenet szépen alakul, ellenben szerencsétlen fop-ot már össze-vissza szidtam elsősorban azért, mert nem hajlandó a .pdf-ben megjeleníteni az "ő" és "ű" karaktereket, emellett pedig a float-ot sem ismeri.

Hogy valóban érthető legyen, ezért mellékelem a forrást is (peldak.xml)

<?xml version="1.0" encoding="utf-8"?>
<article xml:id="peldak" xmlns="http://docbook.org/ns/docbook" version="5.0" lang="hu">

    <info>
        <author><firstname>László</firstname><surname>Bimba</surname></author>
        <title>Docbook példák</title>
    </info>

    <section xml:id="programlisting">
        <info>
            <title><literal>programlisting</literal></title>
        </info>

        <informalfigure float="1">
            <mediaobject>
                <imageobject>
                    <imagedata fileref="bcgmw.jpg" format="jpg" align="right" width="12em"/>
                </imageobject>
            </mediaobject>
        </informalfigure>

        <para> A <literal>linenumbering</literal> paraméter fordító-függő,
            jelenleg csak a java fordítók támogatják
            (<literal>saxon</literal>, <literal>xalan</literal>), de a
            megfelelő kiegészítések is telepítve kell, hogy legyenek
            (<literal>saxon</literal> esetében pl.
            <literal>docbook-xsl-saxon</literal>), ezenkívül a kiegészítőket
            is aktiválni kell fordítás közben:
        </para>

        <screen><prompt>$ </prompt><userinput>saxon-xslt -o peldak.html peldak.xml \
  /usr/share/xml/docbook/stylesheet/nwalsh/html/docbook.xsl \
  use.extensions=1 linenumbering.extension=1</userinput></screen>

        <programlisting linenumbering="numbered" lang="c"><![CDATA[
#include <stdio.h>

int
factorial( int n )
{
    int
        ret = 1;

    while( n > 0 )
    {
        ret *= n--;
    }

    return( ret );
}

int
main( void )
{
    int
        t = 0, /* Tesztesetek szama. */
        m = 0; /* Matrix merete.     */

    for( scanf( "%d", &t ) ; t > 0 ; --t )
    {
        scanf( "%d", &m );
        printf( "%d\n", factorial( 2 * m ) / (factorial( m ) * factorial( m )) );
    }

    return( 0 );
}]]>
        </programlisting>

    </section>

    <section xml:id="warning">
        <info>
            <title><literal>warning</literal></title>
        </info>

        <warning><para>Hasznos lesz ez, ha megismerem.</para></warning>
    </section>

</article>

Gugliztam rendesen, hogy találjak egy normális xsl-fo processzort, az egyetlen normális listát a DocBook XSL: The Complete Guide-ban találtam:

http://www.sagehill.net/docbookxsl/FOprocessors.html

A baj az, hogy itt a legtöbb fizetős - arra hogy itthon bohóckodjak vele nem akarok pénzt költeni. Maradt a fop, dblatex, xmlroff.

dblatex

A dblatex legalább felismeri az ékezeteket, de pl. a beágyazott kép align paraméterére fittyet hány és egy felől nem tetszik a .pdf kinézete (oké, alakítható, csak ahhoz latex stylesheet, vagy mifene kell, ha jól értem, az .xsl itt kikerül a képből), másfelől a Win-es relatíve sok cuccot kell feltelepíteni.

$ dblatex -o dblatex.pdf peldak.xml

xmlroff

Az xmlroff-ot nem sikerült igazából működésre bírnom, ezt a hibaüzenetet dobta:

$ xmlroff --format=pdf -o xmlroff.pdf peldak.xml /usr/share/xml/docbook/stylesheet/docbook-xsl-ns/fo/docbook.xsl
Making portrait pages on USletter paper (8.5inx11in)


(xmlroff:13937): libfo-WARNING **: Expression evaluation error:: Evaluation resulted in an error
Object path: /FoTree[1]/FoRoot[1]/FoLayoutMasterSet[1]/FoSimplePageMaster[1]/FoRegionStart[1]
Object path: /FoTree[1]/FoRoot[1]/FoLayoutMasterSet[1]/FoSimplePageMaster[1]/FoRegionStart[1]

De ha a --continue kapcsolóval lefordítom (és kikommentelem a képbeágyazást), akkor legalább van .pdf kimenet - ékezetek vannak.

fop

Végül pedig a fop:

Miközben ezt a kommentet írom, sikerült megoldanom az ékezet problémát: fogtam a dejavusans.ttf fájlt és rátoltam a fop-ttfreader dejavusans.ttf dejavusans.xml parancsot, ami legyártotta a dejavusans.xml fájlt. Létrehoztam egy fop.config.xml beállítófájlt, ami a következőket tartalmazza:

<fop version="1.0">
    <font-base>./</font-base>
    <renderers>
        <renderer mime="application/pdf">
            <fonts>
              <font metrics-url="dejavusans.xml" kerning="yes" embed-url="dejavusans.ttf">
                <font-triplet name="DejaVu Sans" style="normal" weight="normal"/>
              </font>
            </fonts>
        </renderer>
    </renderers>
</fop>

A .pdf létrehozásánál pedig megadtam, hogy ezt a konfigot használja és hogy a fő szövegrész DejaVu Sans típusú legyen:

$ fop -c fop.conf.xml -pdf peldak-fop.pdf -xml peldak.xml -xsl /usr/share/xml/docbook/stylesheet/docbook-xsl/fo/docbook.xsl -param body.font.family "DejaVu Sans"

No, ennek ellenére azért még mindig nem működik a kép szöveg mellé helyezése (float).

KÉRDÉS

Egy szó, mint száz: tudtok ajánlani olyan xsl-fo fordítót, ami helyből jól működik Linuxon és Win-en is? (lehetőleg egy példát mellékeljetek a futtatási paraméterekhez)

--
A kényszer helyett a tudásvágy vezessen a tanulásban!

Mióta utoljára írtam átváltottam xep personal-ra, kerestem egy oprendszer-független framework-ot, megtaláltam a publican-t, nagyon megtetszett a renderelt pdf és a html kimenet is, de hiányoltam, hogy (tudtommal) nem lehet Xep-et használni benne és így a float is ki van lőve. Nem adtam fel a reményt: azóta az xsl-eket hackelem.

Már csak egy dolog hiányzik (egyelőre) a boldogságomhoz: hogy kellene megoldani, hogy teljes oldalszélességű táblázatokat kapjak, de a cellák szélessége a tartalomra igazodjon (kivéve az utolsót: az érjen ki a lap széléig)?

Amennyire vissza tudtam követni a szálakat, a cellák szélességét a

/usr/share/xml/docbook/stylesheet/docbook-xsl/fo/table.xsl

fájlon belül határozza meg az alábbi template:

<xsl:template name="generate.col.raw">
...
      <xsl:variable name="colspec.colwidth">
        <xsl:choose>
          <xsl:when test="normalize-space($colspec/@colwidth)='*'">1*</xsl:when>
          <xsl:when test="$colspec/@colwidth">
            <xsl:value-of select="$colspec/@colwidth"/>
          </xsl:when>
          <xsl:otherwise>1*</xsl:otherwise>
        </xsl:choose>
      </xsl:variable>

Na most az a baj, hogy itt arányokkal számol és mivel nem tudom a szülő blokk (a <para>, ami tartalmazza) szélességét és a táblázat szélességét sem, így nem tudok aránypárt felállítani, tehát nem tudom kiszámolni, hogy az utolsó cella milyen széles legyen.

--

A publican bűvölése mellett gugliztam, hátha rátalálok az O'Reilly xsl-ekre, hamár egyszer tőlük származik a docbook, és a könyveik 'dizájnja' is tetszik, miért ne csináljak én is hasonlót? Azt hiszem meg is találtam:

https://prod.oreilly.com/external/tools/docbook/prod/trunk/

A username=guest jelsző nem kell. Le is szedtem svn-el:

svn checkout --username guest https://prod.oreilly.com/external/tools/docbook/prod/trunk/ .

Van mellé pár sample:

https://github.com/oreillymedia/docbook_samples

...és a hozzájuk tartozó leírás:
http://chimera.labs.oreilly.com/books/1234000000058/

Ezek közül a

book.xml

-el próbálkozok.

[folyamatosan frissíteni fogom ezt a kommentet - gyk. itt logolom a tapasztalataimat.]
--
A kényszer helyett a tudásvágy vezessen a tanulásban!