Revision as of 16:21, 22 November 2011 by Abella(talk | contribs)(Created page with "* Convertiu en primer lloc els vostres DocBook a HTML. Per a fer-ho utilitzeu <code>meinproc4 index.docbook</ code>.")
El procediment actual no està polit, el codi de l'script és lleig, no prou intel·ligent, etc. L'única excusa és que funciona d'alguna manera .
Si voleu millorar el procediment, teniu bones habilitats amb Python, i coneixeu els principis d'autoria de docbook, podeu millorar el procediment. Si us plau, poseu-vos en contacte amb Yurchor si sou capaç d'ajudar.
Podeu obtenir la llista completa de les pàgines per a la vostra aplicació amb el següent script:
<DPL>
nottitlematch = %/__|%/zh-%|%(%)
titlematch = Amarok%
namespace = Main
columns = 1
format = ,\n* [[%PAGE%|%TITLE%]],,
</DPL>
Substituïu Amarok amb el nom de la vostra aplicació, poseu-ho a la vostra pàgina d'usuari, i feu clic a Vista prèvia. Es reordenarà la llista d'acord amb l'índex de continguts del manual.
si voleu descarregar totes les capture de pantalla (es necessita algun temps per a descarregar totes les imatges des de UserBase, grep i wget han d'estar instal·lats), o
python wiki2docbook.py -s Manual.xml
si no necessiteu descarregar les imatges.
Post-processament
Canvieu el nom de Manual.xml.docbook a index.docbook.
Comproveu si la conversió s'ha realitzat correctament:
checkXML index.docbook
Corregiu els errors (millor sobre les pàgines de UserBase).
Convertir docbook a HTML:
meinproc4 index.docbook
Comproveu les pàgines HTML (totes les imatges han de ser visibles, els enllaços no han de donar lloc a pàgines 404).
Substituïu les imatges grans per miniatures usant convert de ImageMagick.
Arrangeu els enllaços a docbook, de manera que portin a la secció de docbook, no pàgines de UserBase.
Arrangeu el nom de l'aplicació d'acord amb la llista d'entitats del KDE.
Copieu index.docbook i les imatges a la vostra carpeta /doc i publiqueu-ho (commit) al repositori.
La documentació de K3b a UserBase en Opera i la pàgina convertida en el Konqueror.
Actualitzar els DocBook des de UserBase
Per actualitzar els vostres docbook convertits si us plau utilitzeu el següent procediment:
Feu una exportació XML des de UserBase. Veure la secció Exportar.
Utilitzeu l'script per actualitzar el contingut (les capçaleres de resum, paraules clau i el peu es mantindrà):
Comproveu el docbook, reanomeneu el fitxer a index.docbook i publiqueu-lo amb les captures de pantalla al vostre repositori.
Convertir els DocBook a un altre format
Convertir-los a PDF
En general, no hi ha necessitat de convertir els DocBook de forma manual. Podeu descarregar el PDF convertit des del lloc de documentació del KDE.
En cas de necessitar cap personalització addicional, feu el següent:
Assegureu-vos que teniu alguna distribució de LaTeX instal·lada (normalment, TeXLive).
Creeu el següent script (anomenat buildpdf.sh) al directori dels DocBook:
#!/bin/bashexportSGML_CATALOG_FILES=/usr/share/sgml/docbook/sqml-dtd-4.2/catalog:/usr/share/apps/ksgmltools2/customization/catalog.xml:/usr/share/sgml/docbook/xml-dtd-4.2/docbook
# S'afegeix l'argument -d a l'ordre per mantenir la carpeta /tmp, amb el qual es podrà examinar el text generat.
./dblatex-cvs-install/bin/dblatex-d-bpdftex--style\kdestyle\-o$(pwd|awk-F/'{ print $NF }').pdf\-Platex.output.revhistory=0-Pnewtbl.use=1\-Pimagedata.default.scale=pagebound\-Pliteral.width.ignore=1\-I$KDEDIR/share/doc/HTML/en/\-X\$1
Descarregueu els estils de KDE:
svn co svn://anonsvn.kde.org/home/kde/trunk/www/areas/docs/dblatex-cvs-install/
Ajusteu dblatex-cvs-install/bin/dblatex com segueix
Copieu els estils KDE (/dblatex-cvs-install/share/dblatex/latex/contrib/) a algun directori TeX on es trobi la instal·lació de LaTeX (jo els he copiat a /usr/share/texmf-dist/tex/latex/kde).
Actualitzeu les rutes amb mktexlsr des de l'arrel.
Executeu ./buildpdf.sh index.docbook.
Copieu tots els fitxers des de /tmp/tpb-usuari-digits al directori de treball.
Personalitzeu i editeu el fitxer tex</ tt> en Kile, segons correspongui.
Compileu el fitxer PDF amb Alt + 6.
Convertir-los a EPUB
Assegureu-vos que Calibre està instal·lat al vostre sistema.
Convertiu en primer lloc els vostres DocBook a HTML. Per a fer-ho utilitzeu meinproc4 index.docbook</ code>.
Start Calibre and choose Add books.
Select index.html in your DocBook folder. Wait until the book is loaded.
Choose Convert books.
Fill the metadata fields as appropriate.
Calibre conversion configuration page.
Press OK and wait until the work is done.
Copy the book from ~/Calibre Library on your ebook reader.