[team-gnome-gr] Δημιουργία PDF α πό την τεκμηρίωση

[Simos <simos lists googlemail com>]

Εδώ περιγράφουμε στα γρήγορα τη διαδικασία δημιουργίας PDF από την τεκμηρίωση.
Στόχος είναι να το περάσουμε στο wiki.gnome.gr κάποια στιγμή, οπότε
καταγράφω εδώ.

1. Επιλέγουμε πακέτο, π.χ. zenity
2. Λήψη του κώδικα
svn co svn://svn.gnome.org/svn/zenity/trunk zenity
(απαιτεί το πακέτο subversion)
3. cd zenity/help/
4. \ls C/*.xml | perl -n -e 'chop; $a=$_; print "xml2po -p el/el.po $a
> el/`basename $a`\n"' | sh
5. cd el/
6. xmllint --noent zenity.xml --output documentation-zenity.xml
7. dblatex --backend=xetex --verbose documentation-zenity.xml
Η εντολή μπορεί να αποτύχει, ή να δημιουργήσει ένα .pdf. Το ζήτημα
είναι ότι λόγω του προβλήματος
http://simos.info/blog/archives/817 το κείμενο είναι «κινέζικα» (δεν
είναι «κινέζικα», αλλά λέμε τώρα...)
Το όλο θέμα είναι ανοικτό για κάποιον/α που θα ήθελε να εντοπίσει το
πρόβλημα και να το λύσει με σωστό τρόπο.
8. Μπαίνουμε στο documentation-zenity.xml και αλλάζουμε το lang="el"
σε lang="en" και ξανά
dblatex --backend=xetex --verbose documentation-zenity.xml
9. Ta dah! Έχουμε το documentation-zenity.pdf !
Άφησα ένα αντίγραφο στο http://simos.info/documentation-zenity.pdf

Γενικά, η τεκμηρίωση της κάθε εφαρμογής προορίζεται για να τη βλέπουμε
μέσω ηλεκτρονικής μορφής (από το yelp, Προβολή βοήθειας). Νομίζω ότι
είναι όμορφο να βλέπουμε και πως φαίνεται και σε PDF.

Σίμος