Show README_DE.txt syntax highlighted
Astrum Futura Dokumentation // Deutsche Version
---------------------------
Einleitung
============
Die Astrum Futura Dokomentation ist im Docbook XML format, für alle Sprachen, geschrieben. Docbook XML ist ein leichtes format, welches das erstellen von HTML und PDF Dokomenten erlaubt. Dafür wird Linux oder unter Windows Cygwin benötigt. (Inklusive dem Standart GNU toolchain and xsltproc)
Wenn du Windows benutzt installiere bitte Cygwin und die foglenden Packete:
1. autoconf
2. make
3. libxslt
4. libxml2-devel
Herstellen der HTML Dokomentation
===============================
From the command prompt in a console (on Windows, start Cygwin), navigate to the relevent language directory under ./documentation/manual whose HTML you intend building. At present, only an "en" (English) directory exists.
Run the following commands in sequence:
1. autoconf
2. ./configure
3. make
Assuming no errors, the HTML documentation will have been generated in the ./documentation/manual/en/html directory. If an error has occured please post the error to the Astrum Futura technical support forum.
Additional commands available:
i) make clean (delete old HTML in preparation for a new build)
ii) make check (check XML for errors)
Note: Files generated by the build process should never be added to the subversion repository. Please add new files one-by-one to avoid errors.
Encountered an Error?
=====================
1. Remove all files from the html/ subdir except dbstyle.css
2. Remove all files from the root dir except manual.xml, configure.in, Makefile.in and README. The important one here is entities.ent.
3. You can optionally remove the "/autom4te.cache" directory and the "/build/docbook-xsl" directory
4. Try to build again following the instructions given above. If it still throws errors, post a message to the forums.
Tips
====
- Several documents currently existing contain non-English characters. These will produce errors if certain documents are not saved encoded as UTF-8, or which were not encoded to UTF-8 until *after* the non-English characters were typed and saved. As a standard, please create new files as UTF-8 before typing - it makes future editing simpler.
- Please note the build process requires an active internet connection without the presence of a passworded HTTP proxy.
- Since building uses an active internet connections, you may need to approve several new firewall rules (depending on your firewall version) or even temporarily disable the firewall.
See more files for this project here