Kapitel 4. Hello World-Projekt

Die Standard-Verzeichnisstruktur sieht immer so aus:

Das Common-Verzeichnis: enthält alle Bibliotheken und Tools, die zum Erstellen des Projekts gebraucht werden. Alles hier ist im Wesentlichen erst mal immer gleich und unabhängig vom Projektinhalt.


	Das ist natürlich nicht ganz richtig, denn hier wird insbesondere das Aussehen der erstellten Dokumente per XSL Stylesheet festgelegt.

Das Build-Verzeichnis: enthält die Batch-Datei zum Aufrufen von Ant: make.bat (bzw. deren Unixvariante make.sh), die Datei build.xml, die das Bauen steuert und das Verzeichnis mit den Quelldokumenten: xml.

Das XML-Verzeichnis: enthält alle XML-Dateien, die das eigentliche Dokument oder Buch ausmachen. Im Falle von „Hello World“ kommt man hier natürlich auch mit nur einer Datei aus.

Die Steuerdatei für Ant sieht wie folgt aus:

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE project [
         <!ENTITY common "../common">
         <!ENTITY buildcommon SYSTEM "../common/build_common.xml">
]>
<project name="HelloWorld" default="html" basedir="."> 
         <property name="lang" value="de"/>
         <target name="postprocess"/>
         <property name="project" value="HelloWorld"/>
         <property name="javahome" value="..."/>
         <property name="fileversion" value="1.0"/> 
&buildcommon;
</project>

Was hier also eigentlich nur festgelegt wird, ist wie das Projekt heißt und welche Dokumentenart standardmäßig erzeugt werden.

	Definiert Projektname und Standard-Target (hier html).
	Definiert eine Eigenschaft des Projekts. Hier der Projektname, was in der gemeinsamen Steuerdatei für Ant `build_common.xml` als Variable gebraucht wird.

Was jetzt noch fehlt ist der Inhalt in diesem Fall die Datei HelloWorld.xml und zwar im XML-Verzeichnis.

Für das allereinfachste HelloWorld steht hier nicht mehr als:

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"../../common/docbook/dtd/docbookx.dtd">
<article lang="de">
 <articleinfo>
     <title>Hello World</title>
     <author>
       <firstname>Stefan</firstname>
       <surname>Rinke</surname>
     </author>
 </articleinfo>
 <section>
     <title>Hello World</title>
     <para>Das ist alles. </para>
 </section>
</article>

Nun ist endgültig alles beisammen, was man zum ersten Testen braucht. Nachdem alle Tools installiert sind, sollte jetzt das Aufbauen des ersten Projekts kein Problem mehr sein. Wenn anschließend der Aufruf von

make all
 BUILD SUCCESSFUL
Total time: 11 seconds

liefert. Dann sollten im dist-Verzeichnis unterhalb von build alle Formate des soeben erzeugten HelloWorld-Dokuments zu finden sein.

DocBook Publishing

Kapitel 4. Hello World-Projekt