joachim99@61: README for the Documentation
joachim99@61: ============================
joachim99@61: Author: Joachim Eibl, 2004-02-22
joachim99@61: 
joachim99@61: The following text contains some info about how the docs are created.
joachim99@61: It helps me remember certain details. Most users probably aren't 
joachim99@61: interested in these things.
joachim99@61: 
joachim99@61: Each directory contains the documentation for a different translation.
joachim99@61: The textual information is in the index.docbook of every subdirectory.
joachim99@61: 
joachim99@61: I wrote the English version in en/index.docbook. The other translations
joachim99@61: were done by the KDE-Internationalization-Team. They are doing a great
joachim99@61: job!
joachim99@61: 
joachim99@61: 
joachim99@61: The command meinproc (which is part of KDE) can be used to convert this 
joachim99@61: file into HTML.
joachim99@61: 
joachim99@61: meinproc index.docbook
joachim99@61: 
joachim99@61: During normal installation on KDE a compressed file is generated.
joachim99@61: 
joachim99@61: meinproc --check --cache index.cache.bz2 index.docbook
joachim99@61: 
joachim99@61: 
joachim99@61: As a service for non-KDE-users the en-directory also contains the 
joachim99@61: HTML-version of the English documentation.
joachim99@61: 
joachim99@61: After running meinproc the HTML-files contain some references to files 
joachim99@61: in help:/common/ which contains stylesheets and KDE-graphics which make
joachim99@61: the result look much prettier. Because on non-KDE-systems this is not 
joachim99@61: available, I placed a copy of these files in doc/en/common. 
joachim99@61: To correct the references, I run the following command, which removes 
joachim99@61: the "help:/"-part of the references, and only the "common/"-part remains.
joachim99@61: 
joachim99@61: for i in *.html; do sed -i "s/help:\///g" $i; done
joachim99@61: 
joachim99@61: (sed-option "-i" means in-place, "s/orig/repl/" is the replacement-command,
joachim99@61: "g" replaces every occurance in the line, not only the first.)
joachim99@61: 
joachim99@61: The screenshots were made with the English KDE-version and therefore are
joachim99@61: placed in the en-directory. But since for the other translations no new
joachim99@61: screenshots were made yet, they only contain links to the English 
joachim99@61: screenshots. These links are created en-bloc with this command. (But
joachim99@61: first you must cd into each subdirectory.)
joachim99@61: 
joachim99@61: for i in `ls ../en | grep png`; do ln -s ../en/$i $i; done
joachim99@61: 
joachim99@66: Command to retrieve other translations from cvs:
joachim99@66: 
joachim99@66: cvs co kde-i18n/subdirs
joachim99@66: for i in `cat kde-i18n/subdirs`; do  cvs co kde-i18n/$i/docs/kdeextragear-1/kdiff3/index.docbook; done