Script zum Bauen der Dokumentation sowie Dobudish-Custom-CFGs
authorMoritz Bunkus <moritz@bunkus.org>
Wed, 11 Jan 2012 14:30:49 +0000 (15:30 +0100)
committerMoritz Bunkus <moritz@bunkus.org>
Wed, 11 Jan 2012 14:36:01 +0000 (15:36 +0100)
23 files changed:
.gitignore
doc/build/custom-cfg/common.xsl [new file with mode: 0644]
doc/build/custom-cfg/eclipse.xsl [new file with mode: 0644]
doc/build/custom-cfg/epub.xsl [new file with mode: 0644]
doc/build/custom-cfg/fo.xsl [new file with mode: 0644]
doc/build/custom-cfg/html.xsl [new file with mode: 0644]
doc/build/custom-cfg/htmlhelp.xsl [new file with mode: 0644]
doc/build/custom-cfg/javahelp.xsl [new file with mode: 0644]
doc/build/custom-cfg/local-entities.xml [new file with mode: 0644]
doc/build/custom-cfg/localbuild.properties [new file with mode: 0644]
doc/build/custom-cfg/localbuild.xml [new file with mode: 0644]
doc/build/custom-cfg/manpages.xsl [new file with mode: 0644]
doc/build/custom-cfg/rtf.xsl [new file with mode: 0644]
doc/build/custom-cfg/singlehtml.xsl [new file with mode: 0644]
doc/build/custom-cfg/singlexhtml.xsl [new file with mode: 0644]
doc/build/custom-cfg/slides.xsl [new file with mode: 0644]
doc/build/custom-cfg/style-common.css [new file with mode: 0644]
doc/build/custom-cfg/style-eclipse.css [new file with mode: 0644]
doc/build/custom-cfg/style-javahelp.css [new file with mode: 0644]
doc/build/custom-cfg/wordml.xsl [new file with mode: 0644]
doc/build/custom-cfg/xhtml.xsl [new file with mode: 0644]
doc/dokumentation.xml
scripts/build_doc.sh [new file with mode: 0755]

index 81d3e49..10b6786 100644 (file)
@@ -7,3 +7,4 @@ crm
 /config/lx_office.conf
 /doc/online/*/*.html
 pod2html*
+/doc/build/dobudish*
diff --git a/doc/build/custom-cfg/common.xsl b/doc/build/custom-cfg/common.xsl
new file mode 100644 (file)
index 0000000..13239cb
--- /dev/null
@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>\r
+\r
+<!-- This file is part of DobuDish                                           -->\r
+\r
+<!-- DobuDish is free software; you can redistribute it and/or modify        -->\r
+<!-- it under the terms of the GNU General Public License as published by    -->\r
+<!-- the Free Software Foundation; either version 2 of the License, or       -->\r
+<!-- (at your option) any later version.                                     -->\r
+\r
+<!-- DobuDish is distributed in the hope that it will be useful,             -->\r
+<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of          -->\r
+<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the           -->\r
+<!-- GNU General Public License for more details.                            -->\r
+\r
+<!-- You should have received a copy of the GNU General Public License       -->\r
+<!-- along with DobuDish; if not, write to the Free Software                 -->\r
+<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->\r
+\r
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"\r
+                xmlns:fo="http://www.w3.org/1999/XSL/Format"\r
+                version='1.0'>\r
+\r
+\r
+</xsl:stylesheet>\r
diff --git a/doc/build/custom-cfg/eclipse.xsl b/doc/build/custom-cfg/eclipse.xsl
new file mode 100644 (file)
index 0000000..817da32
--- /dev/null
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="UTF-8"?>\r
+\r
+<!-- This file is part of DobuDish                                           -->\r
+\r
+<!-- DobuDish is free software; you can redistribute it and/or modify        -->\r
+<!-- it under the terms of the GNU General Public License as published by    -->\r
+<!-- the Free Software Foundation; either version 2 of the License, or       -->\r
+<!-- (at your option) any later version.                                     -->\r
+\r
+<!-- DobuDish is distributed in the hope that it will be useful,             -->\r
+<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of          -->\r
+<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the           -->\r
+<!-- GNU General Public License for more details.                            -->\r
+\r
+<!-- You should have received a copy of the GNU General Public License       -->\r
+<!-- along with DobuDish; if not, write to the Free Software                 -->\r
+<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->\r
+\r
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"\r
+                xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"\r
+                xmlns:exsl="http://exslt.org/common"\r
+                xmlns:set="http://exslt.org/sets"\r
+               version="1.0"\r
+                exclude-result-prefixes="doc exsl set">\r
+\r
+  <xsl:import href="../../../system/custom-xsl/eclipse-book.xsl"/>\r
+  <xsl:import href="common.xsl"/>\r
+\r
+</xsl:stylesheet>\r
diff --git a/doc/build/custom-cfg/epub.xsl b/doc/build/custom-cfg/epub.xsl
new file mode 100644 (file)
index 0000000..508d783
--- /dev/null
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="UTF-8"?>\r
+\r
+<!-- This file is part of DobuDish                                           -->\r
+\r
+<!-- DobuDish is free software; you can redistribute it and/or modify        -->\r
+<!-- it under the terms of the GNU General Public License as published by    -->\r
+<!-- the Free Software Foundation; either version 2 of the License, or       -->\r
+<!-- (at your option) any later version.                                     -->\r
+\r
+<!-- DobuDish is distributed in the hope that it will be useful,             -->\r
+<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of          -->\r
+<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the           -->\r
+<!-- GNU General Public License for more details.                            -->\r
+\r
+<!-- You should have received a copy of the GNU General Public License       -->\r
+<!-- along with DobuDish; if not, write to the Free Software                 -->\r
+<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->\r
+\r
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"\r
+                xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"\r
+                xmlns:exsl="http://exslt.org/common"\r
+                xmlns:set="http://exslt.org/sets"\r
+               version="1.0"\r
+                exclude-result-prefixes="doc exsl set">\r
+\r
+  <xsl:import href="../../../system/custom-xsl/epub-book.xsl"/>\r
+  <xsl:import href="common.xsl"/>\r
+\r
+</xsl:stylesheet>
\ No newline at end of file
diff --git a/doc/build/custom-cfg/fo.xsl b/doc/build/custom-cfg/fo.xsl
new file mode 100644 (file)
index 0000000..bee2136
--- /dev/null
@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8"?>\r
+\r
+<!-- This file is part of DobuDish                                           -->\r
+\r
+<!-- DobuDish is free software; you can redistribute it and/or modify        -->\r
+<!-- it under the terms of the GNU General Public License as published by    -->\r
+<!-- the Free Software Foundation; either version 2 of the License, or       -->\r
+<!-- (at your option) any later version.                                     -->\r
+\r
+<!-- DobuDish is distributed in the hope that it will be useful,             -->\r
+<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of          -->\r
+<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the           -->\r
+<!-- GNU General Public License for more details.                            -->\r
+\r
+<!-- You should have received a copy of the GNU General Public License       -->\r
+<!-- along with DobuDish; if not, write to the Free Software                 -->\r
+<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->\r
+\r
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"\r
+                xmlns:fo="http://www.w3.org/1999/XSL/Format"\r
+                version='1.0'>\r
+\r
+  <xsl:import href="../../../system/custom-xsl/fo-book.xsl"/>\r
+  <xsl:import href="common.xsl"/>\r
+\r
+</xsl:stylesheet>\r
diff --git a/doc/build/custom-cfg/html.xsl b/doc/build/custom-cfg/html.xsl
new file mode 100644 (file)
index 0000000..042bd8a
--- /dev/null
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="UTF-8"?>\r
+\r
+<!-- This file is part of DobuDish                                           -->\r
+\r
+<!-- DobuDish is free software; you can redistribute it and/or modify        -->\r
+<!-- it under the terms of the GNU General Public License as published by    -->\r
+<!-- the Free Software Foundation; either version 2 of the License, or       -->\r
+<!-- (at your option) any later version.                                     -->\r
+\r
+<!-- DobuDish is distributed in the hope that it will be useful,             -->\r
+<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of          -->\r
+<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the           -->\r
+<!-- GNU General Public License for more details.                            -->\r
+\r
+<!-- You should have received a copy of the GNU General Public License       -->\r
+<!-- along with DobuDish; if not, write to the Free Software                 -->\r
+<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->\r
+\r
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"\r
+                xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"\r
+                xmlns:exsl="http://exslt.org/common"\r
+                xmlns:set="http://exslt.org/sets"\r
+               version="1.0"\r
+                exclude-result-prefixes="doc exsl set">\r
+\r
+  <xsl:import href="../../../system/custom-xsl/html-book.xsl"/>\r
+  <xsl:import href="common.xsl"/>\r
+\r
+</xsl:stylesheet>
\ No newline at end of file
diff --git a/doc/build/custom-cfg/htmlhelp.xsl b/doc/build/custom-cfg/htmlhelp.xsl
new file mode 100644 (file)
index 0000000..5462cd8
--- /dev/null
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="UTF-8"?>\r
+\r
+<!-- This file is part of DobuDish                                           -->\r
+\r
+<!-- DobuDish is free software; you can redistribute it and/or modify        -->\r
+<!-- it under the terms of the GNU General Public License as published by    -->\r
+<!-- the Free Software Foundation; either version 2 of the License, or       -->\r
+<!-- (at your option) any later version.                                     -->\r
+\r
+<!-- DobuDish is distributed in the hope that it will be useful,             -->\r
+<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of          -->\r
+<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the           -->\r
+<!-- GNU General Public License for more details.                            -->\r
+\r
+<!-- You should have received a copy of the GNU General Public License       -->\r
+<!-- along with DobuDish; if not, write to the Free Software                 -->\r
+<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->\r
+\r
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"\r
+                xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"\r
+                xmlns:exsl="http://exslt.org/common"\r
+                xmlns:set="http://exslt.org/sets"\r
+               version="1.0"\r
+                exclude-result-prefixes="doc exsl set">\r
+\r
+  <xsl:import href="../../../system/custom-xsl/htmlhelp-book.xsl"/>\r
+  <xsl:import href="common.xsl"/>\r
+\r
+</xsl:stylesheet>
\ No newline at end of file
diff --git a/doc/build/custom-cfg/javahelp.xsl b/doc/build/custom-cfg/javahelp.xsl
new file mode 100644 (file)
index 0000000..50d5aee
--- /dev/null
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="UTF-8"?>\r
+\r
+<!-- This file is part of DobuDish                                           -->\r
+\r
+<!-- DobuDish is free software; you can redistribute it and/or modify        -->\r
+<!-- it under the terms of the GNU General Public License as published by    -->\r
+<!-- the Free Software Foundation; either version 2 of the License, or       -->\r
+<!-- (at your option) any later version.                                     -->\r
+\r
+<!-- DobuDish is distributed in the hope that it will be useful,             -->\r
+<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of          -->\r
+<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the           -->\r
+<!-- GNU General Public License for more details.                            -->\r
+\r
+<!-- You should have received a copy of the GNU General Public License       -->\r
+<!-- along with DobuDish; if not, write to the Free Software                 -->\r
+<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->\r
+\r
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"\r
+                xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"\r
+                xmlns:exsl="http://exslt.org/common"\r
+                xmlns:set="http://exslt.org/sets"\r
+               version="1.0"\r
+                exclude-result-prefixes="doc exsl set">\r
+\r
+  <xsl:import href="../../../system/custom-xsl/javahelp-book.xsl"/>\r
+  <xsl:import href="common.xsl"/>\r
+\r
+</xsl:stylesheet>
\ No newline at end of file
diff --git a/doc/build/custom-cfg/local-entities.xml b/doc/build/custom-cfg/local-entities.xml
new file mode 100644 (file)
index 0000000..9f4216b
--- /dev/null
@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="UTF-8"?>\r
+\r
+<!-- This file is part of DobuDish                                           -->\r
+\r
+<!-- DobuDish is free software; you can redistribute it and/or modify        -->\r
+<!-- it under the terms of the GNU General Public License as published by    -->\r
+<!-- the Free Software Foundation; either version 2 of the License, or       -->\r
+<!-- (at your option) any later version.                                     -->\r
+\r
+<!-- DobuDish is distributed in the hope that it will be useful,             -->\r
+<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of          -->\r
+<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the           -->\r
+<!-- GNU General Public License for more details.                            -->\r
+\r
+<!-- You should have received a copy of the GNU General Public License       -->\r
+<!-- along with DobuDish; if not, write to the Free Software                 -->\r
+<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->\r
+\r
+<!ENTITY local_entity "local entity (defined per document)">\r
diff --git a/doc/build/custom-cfg/localbuild.properties b/doc/build/custom-cfg/localbuild.properties
new file mode 100644 (file)
index 0000000..d6bef76
--- /dev/null
@@ -0,0 +1,22 @@
+# BEGIN Do not overwrite\r
+document.type = book\r
+# END Do not overwrite\r
+\r
+# Overwrite properties here\r
+\r
+# If you happen to have sub documents you can set here the document type of each one of those.\r
+#document.<sub_document_name>.type = article|book|set|website|slides...\r
+\r
+# These are needed for the 'eclipse' target\r
+eclipse.plugin.id=com.mycompany\r
+eclipse.plugin.name=Document Name\r
+eclipse.plugin.provider=My Company\r
+\r
+# The version of the eclipse plugin\r
+eclipse.plugin.version=${document.version}\r
+\r
+# The version of the document\r
+document.version = 1.0\r
+\r
+# The name of the folder whose content will be carbon copied to the output directory\r
+special.folder.name.carbonCopy=copy_to_output\r
diff --git a/doc/build/custom-cfg/localbuild.xml b/doc/build/custom-cfg/localbuild.xml
new file mode 100644 (file)
index 0000000..acd490d
--- /dev/null
@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="UTF-8"?>\r
+\r
+<!-- This file is part of DobuDish                                           -->\r
+\r
+<!-- DobuDish is free software; you can redistribute it and/or modify        -->\r
+<!-- it under the terms of the GNU General Public License as published by    -->\r
+<!-- the Free Software Foundation; either version 2 of the License, or       -->\r
+<!-- (at your option) any later version.                                     -->\r
+\r
+<!-- DobuDish is distributed in the hope that it will be useful,             -->\r
+<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of          -->\r
+<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the           -->\r
+<!-- GNU General Public License for more details.                            -->\r
+\r
+<!-- You should have received a copy of the GNU General Public License       -->\r
+<!-- along with DobuDish; if not, write to the Free Software                 -->\r
+<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->\r
+\r
+<project>\r
+\r
+  <!--
+  You can add hooks here that perform your custom action at a given point.
+  Please see the manual (or the the file etc/build-output-formats.xml) for all
+  available hooks.
+  
+  Example:
+  
+  <target name="local-pre-init" >
+  </target>
+  -->
+\r
+</project>
\ No newline at end of file
diff --git a/doc/build/custom-cfg/manpages.xsl b/doc/build/custom-cfg/manpages.xsl
new file mode 100644 (file)
index 0000000..9a1b744
--- /dev/null
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="UTF-8"?>\r
+\r
+<!-- This file is part of DobuDish                                           -->\r
+\r
+<!-- DobuDish is free software; you can redistribute it and/or modify        -->\r
+<!-- it under the terms of the GNU General Public License as published by    -->\r
+<!-- the Free Software Foundation; either version 2 of the License, or       -->\r
+<!-- (at your option) any later version.                                     -->\r
+\r
+<!-- DobuDish is distributed in the hope that it will be useful,             -->\r
+<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of          -->\r
+<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the           -->\r
+<!-- GNU General Public License for more details.                            -->\r
+\r
+<!-- You should have received a copy of the GNU General Public License       -->\r
+<!-- along with DobuDish; if not, write to the Free Software                 -->\r
+<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->\r
+\r
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"\r
+                xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"\r
+                xmlns:exsl="http://exslt.org/common"\r
+                xmlns:set="http://exslt.org/sets"\r
+                version="1.0"\r
+                exclude-result-prefixes="doc exsl set">\r
+\r
+  <xsl:import href="../../../system/custom-xsl/manpages.xsl"/>\r
+  <xsl:import href="common.xsl"/>\r
+\r
+</xsl:stylesheet>\r
diff --git a/doc/build/custom-cfg/rtf.xsl b/doc/build/custom-cfg/rtf.xsl
new file mode 100644 (file)
index 0000000..da292db
--- /dev/null
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="UTF-8"?>\r
+\r
+<!-- This file is part of DobuDish                                           -->\r
+\r
+<!-- DobuDish is free software; you can redistribute it and/or modify        -->\r
+<!-- it under the terms of the GNU General Public License as published by    -->\r
+<!-- the Free Software Foundation; either version 2 of the License, or       -->\r
+<!-- (at your option) any later version.                                     -->\r
+\r
+<!-- DobuDish is distributed in the hope that it will be useful,             -->\r
+<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of          -->\r
+<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the           -->\r
+<!-- GNU General Public License for more details.                            -->\r
+\r
+<!-- You should have received a copy of the GNU General Public License       -->\r
+<!-- along with DobuDish; if not, write to the Free Software                 -->\r
+<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->\r
+\r
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"\r
+                xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"\r
+                xmlns:exsl="http://exslt.org/common"\r
+                xmlns:set="http://exslt.org/sets"\r
+               version="1.0"\r
+                exclude-result-prefixes="doc exsl set">\r
+\r
+  <xsl:import href="../../../system/custom-xsl/rtf-book.xsl"/>\r
+  <xsl:import href="common.xsl"/>\r
+\r
+</xsl:stylesheet>
\ No newline at end of file
diff --git a/doc/build/custom-cfg/singlehtml.xsl b/doc/build/custom-cfg/singlehtml.xsl
new file mode 100644 (file)
index 0000000..f433906
--- /dev/null
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="UTF-8"?>\r
+\r
+<!-- This file is part of DobuDish                                           -->\r
+\r
+<!-- DobuDish is free software; you can redistribute it and/or modify        -->\r
+<!-- it under the terms of the GNU General Public License as published by    -->\r
+<!-- the Free Software Foundation; either version 2 of the License, or       -->\r
+<!-- (at your option) any later version.                                     -->\r
+\r
+<!-- DobuDish is distributed in the hope that it will be useful,             -->\r
+<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of          -->\r
+<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the           -->\r
+<!-- GNU General Public License for more details.                            -->\r
+\r
+<!-- You should have received a copy of the GNU General Public License       -->\r
+<!-- along with DobuDish; if not, write to the Free Software                 -->\r
+<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->\r
+\r
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"\r
+                xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"\r
+                xmlns:exsl="http://exslt.org/common"\r
+                xmlns:set="http://exslt.org/sets"\r
+               version="1.0"\r
+                exclude-result-prefixes="doc exsl set">\r
+\r
+  <xsl:import href="../../../system/custom-xsl/singlehtml-book.xsl"/>\r
+  <xsl:import href="common.xsl"/>\r
+\r
+</xsl:stylesheet>
\ No newline at end of file
diff --git a/doc/build/custom-cfg/singlexhtml.xsl b/doc/build/custom-cfg/singlexhtml.xsl
new file mode 100644 (file)
index 0000000..2468973
--- /dev/null
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="UTF-8"?>\r
+\r
+<!-- This file is part of DobuDish                                           -->\r
+\r
+<!-- DobuDish is free software; you can redistribute it and/or modify        -->\r
+<!-- it under the terms of the GNU General Public License as published by    -->\r
+<!-- the Free Software Foundation; either version 2 of the License, or       -->\r
+<!-- (at your option) any later version.                                     -->\r
+\r
+<!-- DobuDish is distributed in the hope that it will be useful,             -->\r
+<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of          -->\r
+<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the           -->\r
+<!-- GNU General Public License for more details.                            -->\r
+\r
+<!-- You should have received a copy of the GNU General Public License       -->\r
+<!-- along with DobuDish; if not, write to the Free Software                 -->\r
+<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->\r
+\r
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"\r
+                xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"\r
+                xmlns:exsl="http://exslt.org/common"\r
+                xmlns:set="http://exslt.org/sets"\r
+               version="1.0"\r
+                exclude-result-prefixes="doc exsl set">\r
+\r
+  <xsl:import href="../../../system/custom-xsl/singlexhtml-book.xsl"/>\r
+  <xsl:import href="common.xsl"/>\r
+\r
+</xsl:stylesheet>\r
diff --git a/doc/build/custom-cfg/slides.xsl b/doc/build/custom-cfg/slides.xsl
new file mode 100644 (file)
index 0000000..0153586
--- /dev/null
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="UTF-8"?>\r
+\r
+<!-- This file is part of DobuDish                                           -->\r
+\r
+<!-- DobuDish is free software; you can redistribute it and/or modify        -->\r
+<!-- it under the terms of the GNU General Public License as published by    -->\r
+<!-- the Free Software Foundation; either version 2 of the License, or       -->\r
+<!-- (at your option) any later version.                                     -->\r
+\r
+<!-- DobuDish is distributed in the hope that it will be useful,             -->\r
+<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of          -->\r
+<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the           -->\r
+<!-- GNU General Public License for more details.                            -->\r
+\r
+<!-- You should have received a copy of the GNU General Public License       -->\r
+<!-- along with DobuDish; if not, write to the Free Software                 -->\r
+<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->\r
+\r
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"\r
+                xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"\r
+                xmlns:exsl="http://exslt.org/common"\r
+                xmlns:set="http://exslt.org/sets"\r
+                version="1.0"\r
+                exclude-result-prefixes="doc exsl set">\r
+\r
+  <xsl:import href="../../../system/custom-xsl/slides.xsl"/>\r
+  <xsl:import href="common.xsl"/>\r
+\r
+</xsl:stylesheet>\r
diff --git a/doc/build/custom-cfg/style-common.css b/doc/build/custom-cfg/style-common.css
new file mode 100644 (file)
index 0000000..b001aba
--- /dev/null
@@ -0,0 +1,453 @@
+/* Basic Settings:                                                            */\r
+\r
+body {\r
+       background-color: White; /* black foreground */\r
+       color: Black; /* center the body content in browser window */\r
+       margin: auto; /* padding ("inner margin") leaves space between */\r
+       padding: 24px; /* set width according to browser window width */\r
+       width: auto; /* text alignment */\r
+       text-align: justify; /* text-align: left; */\r
+}\r
+\r
+/* para */\r
+p {\r
+  /* font size, line height, font */\r
+  /* list of fonts provides fallbacks if a font is not present */\r
+  font: 12px/18px Verdana, Arial, Helvetica, Sans-Serif;\r
+\r
+  /* margin (top - right - bottom - left) */\r
+  margin: 0 15px 6px 15px;\r
+}\r
+\r
+\r
+\r
+\r
+/* NEEDS TO BE CLEARED UP */\r
+\r
+\r
+p, td, li, dt, dd\r
+{\r
+  /* font size, line height, font */\r
+  /* list of fonts provides fallbacks if a font is not present */\r
+  font: 12px/18px Verdana, Arial, Helvetica, Sans-Serif;\r
+}\r
+\r
+\r
+\r
+/* set font for most elements                    */\r
+/* p: paragraphs (regular text, docbook <para>)  */\r
+/* (...) */\r
+/* body: anything else  */\r
+body, p, td, li, dt, dd,\r
+{\r
+/* set font size and line height                             */\r
+/* list of fonts provides fallbacks if a font is not present */\r
+font: 12px/18px Verdana, Arial, Helvetica, Sans-Serif;\r
+}\r
+\r
+/* images */\r
+/* docbook: <imageobject> */\r
+img {\r
+/* no margin */\r
+margin: 0;\r
+\r
+/* no padding ("inner margin") */\r
+padding: 0;\r
+\r
+/* no border */\r
+border: 0;\r
+}\r
+\r
+\r
+/* emphasized text, can occur in most places */\r
+/* docbook: <emphasis> */\r
+em {\r
+/* bold face, higher number is more bold */\r
+font-weight: 600;\r
+/* italic */\r
+font-style: italic;\r
+}\r
+\r
+\r
+/* sect(ion)1 title */\r
+h2 {\r
+       font-family: Georgia, Verdana, Arial, Helvetica, Sans-Serif; /* font size, relative to body font size */\r
+       font-size: 125%; /* bold face, higher number is more bold */\r
+       font-weight: 600; /* underlined text */\r
+       text-decoration: none; /* foreground color: dark blue */\r
+       color: Black; /* background color: gray */\r
+       background-color: Orange; /* margin settings are top - right - bottom - left (think clockwise) */\r
+       margin: 15px 0 15px 0; /* padding ("inner margin") settings are top - right - bottom - left */\r
+/* (think clockwise)                                                 */\r
+       padding: 8px 15px 8px 15px; \r
+       /* border: 1px solid #000; */\r
+}\r
+\r
+\r
+/* sect(ion)2 title */\r
+h3 {\r
+       font-family: Georgia, Verdana, Arial, Helvetica, Sans-Serif; /* font size, relative to body font size */\r
+       font-size: 110%; /* bold face, higher number is more bold */\r
+       font-weight: 600; /* underlined text */\r
+       text-decoration: none; /* foreground color: dark blue */\r
+       color: Black; /* background-color is a very light grey */\r
+       background-color: #fefefe; /* padding ("inner margin") settings are top - right - bottom - left */\r
+/* (think clockwise)                                                 */\r
+       padding: 0 0 0 15px;\r
+}\r
+\r
+\r
+/* sect(ion)3 title */\r
+h4 {\r
+       font-family: Georgia, Verdana, Arial, Helvetica, Sans-Serif; /* font size, relative to body font size */\r
+       font-size: 100%; /* bold face, higher number is more bold */\r
+       font-weight: 600; /* underlined text */\r
+       text-decoration: none; /* foreground color: dark blue */\r
+       color: Black; /* background-color is a very light grey */\r
+       background-color: #fefefe; /* padding ("inner margin") settings are top - right - bottom - left */\r
+/* (think clockwise)                                                 */\r
+       padding: 0 0 0 15px;\r
+}\r
+\r
+\r
+/* sect(ion)4 title */\r
+h5 {\r
+       font-family: Georgia, Verdana, Arial, Helvetica, Sans-Serif; /* font size, relative to body font size */\r
+       font-size: 100%; /* bold face, higher number is more bold */\r
+       font-weight: 300; /* not underlined */\r
+       text-decoration: none; /* foreground color: dark blue */\r
+       color: Black; /* background-color is a very light grey */\r
+       background-color: #fefefe; /* padding ("inner margin") settings are top - right - bottom - left */\r
+/* (think clockwise)                                                 */\r
+       padding: 0 0 0 15px;\r
+}\r
+\r
+/* the following formats refer to the docbook tags of the same name           */\r
+/* for more information, see the docbook reference at                         */\r
+/* http://www.docbook.org/tdg/en/html/docbook.html                            */\r
+\r
+.mediaobject\r
+{\r
+/* center */\r
+text-align: center;\r
+}\r
+\r
+\r
+/*  */\r
+.calloutlist, .figure, .table\r
+{\r
+/* margin settings are top - right - bottom - left (think clockwise) */\r
+margin: 15px 30px 15px 30px;\r
+}\r
+\r
+\r
+/*  */\r
+.itemizedlist, .variablelist {\r
+/* margin settings are top - right - bottom - left (think clockwise) */\r
+margin: 15px 30px 15px 15px;\r
+}\r
+\r
+/* blockquote formatting is a little more complex    */\r
+/* because block quotes are rendered as a html table */\r
+\r
+/* blockquote block */\r
+.blockquote\r
+{\r
+/* override bottom margin, the other margins are inherited */\r
+margin-bottom: 30px;\r
+}\r
+\r
+.blockquote p, .blockquote td\r
+{\r
+/* set font size and line height                             */\r
+/* list of fonts provides fallbacks if a font is not present */\r
+font: 12px/18px Verdana, Arial, Helvetica, Sans-Serif;\r
+\r
+/* bold face, higher number is more bold */\r
+font-weight: 450;\r
+}\r
+\r
+\r
+.epigraph\r
+{\r
+/* override bottom margin, the other margins are inherited */\r
+margin-bottom: 30px;\r
+}\r
+\r
+.epigraph p, .epigraph td\r
+{\r
+/* set font size and line height                             */\r
+/* list of fonts provides fallbacks if a font is not present */\r
+font: 10px/14px Verdana, Arial, Helvetica, Sans-Serif;\r
+\r
+/* bold face, higher number is more bold */\r
+font-weight: 600;\r
+}\r
+\r
+\r
+\r
+/* custom header and footer that are displayed on all pages */\r
+#customheader, #customfooter\r
+{\r
+/* list of fonts provides fallbacks if a font is not present */\r
+font-family: Verdana, Arial, Helvetica, Sans-Serif;\r
+\r
+/* font size, relative to body font size */\r
+font-size: 80%;\r
+\r
+/* line height, relative to body font size */\r
+line-height: 200%;\r
+\r
+\r
+text-align: center;\r
+vertical-align: middle;\r
+color: #fff;\r
+background-color: #009;\r
+}\r
+\r
+\r
+/* leave more space between last paragraph and footer  */\r
+/* some browser do not add up the bottom margin of the prior element */\r
+/* and the top margin of the footer */\r
+#customfooter {\r
+margin-top: 15px;\r
+}\r
+\r
+\r
+\r
+/* table { margin: 0 15px 6px 15px; } */\r
+\r
+\r
+/* title and navigation links in header and footer */\r
+.navheader th, .navheader td, .navfooter th, .navfooter td\r
+{\r
+font-size: 11px;\r
+font-weight: 450;\r
+}\r
+\r
+\r
+/* table of contents, list of figures and list of tables */\r
+.toc, .list-of-figures, .list-of-tables, .list-of-examples\r
+{\r
+/* margin settings are top - right - bottom - left (think clockwise) */\r
+margin: 15px 30px 15px 15px;\r
+}\r
+\r
+\r
+/* the "headings" are rendered as paragraphs */\r
+.toc p, .list-of-figures p, .list-of-tables p, .list-of-examples p\r
+{\r
+/* no margin */\r
+margin: 0;\r
+}\r
+\r
+\r
+.figure\r
+{\r
+/* margin settings are top - right - bottom - left (think clockwise) */\r
+margin: 5px 5px 5px 5px;\r
+\r
+/* no padding ("inner border") */\r
+padding: 0;\r
+\r
+/* no border */\r
+border: 0;\r
+\r
+/* center text */\r
+text-align: center;\r
+}\r
+\r
+\r
+/* figure title */\r
+.figure p, .table p, .example p\r
+{\r
+font-size: 80%;\r
+}\r
+\r
+\r
+/*\r
+acronym {\r
+      border-bottom: 1px dashed #00cc00;\r
+      cursor: help;\r
+}\r
+*/\r
+\r
+\r
+/* admonition headings */\r
+div.note, div.important, div.warning, div.caution, div.tip\r
+{\r
+padding: 0px 15px 0px 0px;\r
+}\r
+\r
+div.note th, div.important th, div.warning th, div.caution th, div.tip th\r
+{\r
+/* set font size and line height                             */\r
+/* list of fonts provides fallbacks if a font is not present */\r
+font: 12px/18px Verdana, Arial, Helvetica, Sans-Serif;\r
+\r
+font-weight: 600;\r
+\r
+text-decoration: underline;\r
+\r
+/* left align */\r
+text-align: left;\r
+}\r
+\r
+.note p, .important p, .warning p, .caution p, .tip p\r
+{\r
+margin: 0;\r
+}\r
+\r
+.note img, .important img, .warning img, .caution img, .tip img\r
+{\r
+margin: 0px 15px 0px 15px;\r
+}\r
+\r
+\r
+/* programlisting */\r
+pre.programlisting\r
+{\r
+/* non-proportional font */\r
+/* list of fonts provides fallbacks if a font is not present */\r
+font-family: "Courier New", Courier, Monospace;\r
+\r
+/* color: black */\r
+color: #000;\r
+\r
+/* background color: gray */\r
+background-color: #eee;\r
+\r
+/* no margin */\r
+margin: 0;\r
+\r
+/* gray dotted border, 1 px wide */\r
+border: 1px dotted #ddd;\r
+\r
+/* padding ("inner margin") settings are top - right - bottom - left */\r
+/* (think clockwise)                                                 */\r
+padding: 6px 6px 6px 6px;\r
+}\r
+\r
+\r
+/* title page */\r
+\r
+\r
+/* heading1 is used for document title */\r
+h1\r
+{\r
+       font-family: Georgia,Verdana, Arial, Helvetica, Sans-Serif; /* font size, relative to body font size */\r
+       font-size: 150%; /* bold face, higher number is more bold */\r
+       font-weight: 600; /* line height, relative to body line height */\r
+       line-height: 250%; /* center */\r
+       text-align: center; /* foreground color: dark blue */\r
+       color: Black; /* background color: gray */\r
+       background-color: Orange; /* margin settings are top - right - bottom - left (think clockwise) */\r
+       margin: 15px 0 15px 0; /* no padding ("inner margin") */\r
+       padding: 15;\r
+       border: 1px solid #000; \r
+}\r
+\r
+\r
+\r
+/* author on title page is formatted as h3          */\r
+/* these settings overwrite the regular h3 settings */\r
+h3.author {\r
+/* set font size and line height                             */\r
+/* list of fonts provides fallbacks in case selected fonts are not present */\r
+font: 12px/18px Verdana, Arial, Helvetica, Sans-Serif;\r
+\r
+/* bold face, higher number is more bold */\r
+font-weight: 600;\r
+\r
+/* do not underline */\r
+text-decoration: none;\r
+\r
+/* center text */\r
+text-align: center;\r
+\r
+/* color: black */\r
+color: #000;\r
+\r
+/* background-color is a very light grey */\r
+/* alternative: #fff = white             */\r
+background-color: #fefefe;\r
+\r
+/* margin settings are top - right - bottom - left (think clockwise) */\r
+margin: 0 15px 15px 15px;\r
+\r
+/* no padding */\r
+padding: 0;\r
+\r
+/* no border */\r
+border: 0;\r
+}\r
+\r
+\r
+/* copyright and date */\r
+.copyright, .pubdate\r
+{\r
+/* list of fonts provides fallbacks if a font is not present */\r
+font-family: Verdana, Arial, Helvetica, Sans-Serif;\r
+\r
+/* font size, relative to body font size */\r
+font-size: 90%;\r
+\r
+/* center */\r
+text-align: center;\r
+\r
+/* margin settings are top - right - bottom - left (think clockwise) */\r
+margin: 15px 15px 15px 15px;\r
+\r
+/* no padding ("inner margin") */\r
+padding: 0;\r
+\r
+/* no border */\r
+border: 0;\r
+}\r
+\r
+\r
+/* legal notice box */\r
+div.legalnotice\r
+{\r
+       font-family: Verdana, Arial, Helvetica, Sans-Serif; /* font size, relative to body font size */\r
+       font-size: 90%; /* color: black */\r
+       color: #000; /* background color: gray */\r
+       background-color: Orange; /* margin settings are top - right - bottom - left (think clockwise) */\r
+       margin: 10px 45px 10px 45px; /* padding ("inner margin") settings are top - right - bottom - left */\r
+       padding: 5px 5px 5px 5px; /* solid black border, 1px wide */\r
+       border: 1px solid #000;\r
+}\r
+\r
+\r
+table {\r
+       /* border: thin solid orange; */\r
+       border-spacing: 0pt;\r
+       margin-top: 5;\r
+       margin-bottom: 5;\r
+}\r
+\r
+td {\r
+       font-family: SansSerif, Arial, Helvetica, sans-serif;\r
+    padding-left: 1;\r
+    padding-right: 1;\r
+    padding-top: 1;\r
+    padding-bottom: 1  \r
+}\r
+\r
+th {\r
+        /* border: thin solid orange; */        \r
+    padding-left: 1;\r
+    padding-right: 1;\r
+    padding-top: 1;\r
+    padding-bottom: 1  \r
+}\r
+\r
+.informaltable {\r
+   border-collapse: collapse;\r
+       table-layout: auto;\r
+}\r
+\r
+.revhistory {\r
+   border-collapse: collapse;\r
+       table-layout: auto;\r
+}
\ No newline at end of file
diff --git a/doc/build/custom-cfg/style-eclipse.css b/doc/build/custom-cfg/style-eclipse.css
new file mode 100644 (file)
index 0000000..f43bf3e
--- /dev/null
@@ -0,0 +1,109 @@
+body  {font-size: 10pt;\r
+       font-family: SansSerif, Arial, Helvetica, sans-serif;\r
+       margin-left: 10;\r
+       margin-right: 5;\r
+       color: Black;\r
+       background-color: White}\r
+\r
+h1 {\r
+  font-size: 18pt;\r
+}\r
+\r
+h2 {\r
+  font-size: 16pt;\r
+}\r
+\r
+h3 {\r
+  font-size: 14pt;\r
+}\r
+\r
+h4 {\r
+  font-size: 12pt;\r
+}\r
+\r
+table {\r
+  font-size: 10pt;\r
+  border-style: none;\r
+  border-color: silver;\r
+  margin-top: 5;\r
+  margin-bottom: 5\r
+}\r
+\r
+td {font-size: 10pt;\r
+    font-family: SansSerif, Arial, Helvetica, sans-serif;\r
+    border-color: silver;\r
+    padding-left: 1;\r
+    padding-right: 1;\r
+    padding-top: 1;\r
+    padding-bottom: 1}\r
+\r
+th {border-style: none;\r
+    font-weight: bold;\r
+    border-color: silver;\r
+    padding-left: 1;\r
+    padding-right: 1;\r
+    padding-top: 1;\r
+    padding-bottom: 1}\r
+\r
+kbd {\r
+  font-family: monospace;\r
+  font-weight: bold;\r
+}\r
+\r
+var {\r
+  font-style: italic;\r
+}\r
+\r
+ol {\r
+  margin-bottom: 1em;\r
+}\r
+\r
+dt {\r
+  font-weight: bold;\r
+  margin-top: 1em;\r
+}\r
+\r
+li {\r
+  margin-top: 1em;\r
+}\r
+\r
+span.control {\r
+  font-weight: bold;\r
+}\r
+\r
+span.name {\r
+  font-style: italic;\r
+  font-weight: bold;\r
+}\r
+\r
+span.action {\r
+  font-style: italic;\r
+}\r
+\r
+span.code {\r
+  font-family: monospace;\r
+}\r
+\r
+span.menu {\r
+  color: #660033;\r
+  font-weight: bold;\r
+}\r
+\r
+span.filefolder {\r
+  font-family: monospace;\r
+}\r
+\r
+blockquote {\r
+  background-color: #e8e8e8;\r
+  border: 1pt black;\r
+  margin: 2em; border: 1px solid black;\r
+  padding: 1em;\r
+}\r
+\r
+.tasks, .reference, .faq {\r
+  padding-left: 18px;\r
+  font-size: 14pt;\r
+  background-image:url(images/bullet14.png);\r
+  background-repeat: no-repeat;\r
+  background-position: left;\r
+ }
\ No newline at end of file
diff --git a/doc/build/custom-cfg/style-javahelp.css b/doc/build/custom-cfg/style-javahelp.css
new file mode 100644 (file)
index 0000000..29440e5
--- /dev/null
@@ -0,0 +1,76 @@
+/*\r
+ * jhexamples.css      06/17/2003\r
+ *\r
+ * Copyright 2002 Sun Microsystems, Inc. All rights reserved.\r
+ * Use is subject to license terms.\r
+ *\r
+ */\r
+\r
+body  {font-size: 12pt;\r
+       font-family: SansSerif, Arial, Helvetica, sans-serif;\r
+       margin-left: 10;\r
+       margin-right: 5;\r
+       color: Black;\r
+       background-color: White}\r
+\r
+p  {font-size: 12pt;\r
+     margin-top: 5;\r
+     margin-bottom: 5}\r
+\r
+\r
+h1 { font-size: 22pt;\r
+     font-weight: bold;\r
+     margin-top: 0;\r
+     margin-bottom: 10}\r
+\r
+h2 { font-size: 18pt;\r
+     font-weight: bold;\r
+     margin-top: 20;\r
+     margin-bottom: 10}\r
+\r
+h3 { font-size: 14pt;\r
+     font-weight: bold;\r
+     margin-top: 10;\r
+     margin-bottom: 5}\r
+\r
+h4 { font-size: 12pt;\r
+     font-weight: bold;\r
+     margin-top: 10;\r
+     margin-bottom: 5}\r
+\r
+ol {margin-top: 5;\r
+     margin-bottom: 0;\r
+     margin-left: 30}\r
+\r
+li {margin-top: 0;\r
+    margin-bottom: 5}\r
+        \r
+li p{margin-top: 5;\r
+        margin-bottom: 0}\r
+\r
+ul {margin-top: 5;\r
+    margin-bottom: 0;\r
+    margin-left: 30}\r
+        \r
+table {border-style: none;\r
+       border-color: silver;\r
+       margin-top: 5;\r
+       margin-bottom: 5}\r
+\r
+td {font-size: 12pt;\r
+    font-family: SansSerif, Arial, Helvetica, sans-serif;\r
+    border-color: silver;\r
+    padding-left: 1;\r
+    padding-right: 1;\r
+    padding-top: 1;\r
+    padding-bottom: 1}\r
+\r
+th {border-style: none;\r
+    border-color: silver;\r
+    padding-left: 1;\r
+    padding-right: 1;\r
+    padding-top: 1;\r
+    padding-bottom: 1}\r
+\r
+small {font-size: x-small}\r
+\r
diff --git a/doc/build/custom-cfg/wordml.xsl b/doc/build/custom-cfg/wordml.xsl
new file mode 100644 (file)
index 0000000..3eecdf5
--- /dev/null
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="UTF-8"?>\r
+\r
+<!-- This file is part of DobuDish                                           -->\r
+\r
+<!-- DobuDish is free software; you can redistribute it and/or modify        -->\r
+<!-- it under the terms of the GNU General Public License as published by    -->\r
+<!-- the Free Software Foundation; either version 2 of the License, or       -->\r
+<!-- (at your option) any later version.                                     -->\r
+\r
+<!-- DobuDish is distributed in the hope that it will be useful,             -->\r
+<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of          -->\r
+<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the           -->\r
+<!-- GNU General Public License for more details.                            -->\r
+\r
+<!-- You should have received a copy of the GNU General Public License       -->\r
+<!-- along with DobuDish; if not, write to the Free Software                 -->\r
+<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->\r
+\r
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"\r
+                xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"\r
+                xmlns:exsl="http://exslt.org/common"\r
+                xmlns:set="http://exslt.org/sets"\r
+                version="1.0"\r
+                exclude-result-prefixes="doc exsl set">\r
+\r
+  <xsl:import href="../../../system/custom-xsl/wordml-book.xsl"/>\r
+  <xsl:import href="common.xsl"/>\r
+\r
+</xsl:stylesheet>\r
diff --git a/doc/build/custom-cfg/xhtml.xsl b/doc/build/custom-cfg/xhtml.xsl
new file mode 100644 (file)
index 0000000..2ced74b
--- /dev/null
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="UTF-8"?>\r
+\r
+<!-- This file is part of DobuDish                                           -->\r
+\r
+<!-- DobuDish is free software; you can redistribute it and/or modify        -->\r
+<!-- it under the terms of the GNU General Public License as published by    -->\r
+<!-- the Free Software Foundation; either version 2 of the License, or       -->\r
+<!-- (at your option) any later version.                                     -->\r
+\r
+<!-- DobuDish is distributed in the hope that it will be useful,             -->\r
+<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of          -->\r
+<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the           -->\r
+<!-- GNU General Public License for more details.                            -->\r
+\r
+<!-- You should have received a copy of the GNU General Public License       -->\r
+<!-- along with DobuDish; if not, write to the Free Software                 -->\r
+<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->\r
+\r
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"\r
+                xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"\r
+                xmlns:exsl="http://exslt.org/common"\r
+                xmlns:set="http://exslt.org/sets"\r
+               version="1.0"\r
+                exclude-result-prefixes="doc exsl set">\r
+\r
+  <xsl:import href="../../../system/custom-xsl/xhtml-book.xsl"/>\r
+  <xsl:import href="common.xsl"/>\r
+\r
+</xsl:stylesheet>\r
index 9e57a96..b2bc708 100644 (file)
@@ -5429,5 +5429,96 @@ $some_hash{42}    = 54;</programlisting>
        </listitem>
       </orderedlist>
     </sect1>
+
+    <sect1 id="devel.build-doc" xreflabel="Dokumentation erstellen">
+     <title>Dokumentation erstellen</title>
+
+     <sect2 id="devel.build-doc.introduction">
+      <title>Einführung</title>
+
+      <para>
+       Diese Dokumentation ist in <productname>DocBook</productname> XML geschrieben. Zum Bearbeiten reicht grundsätzlich ein
+       Text-Editor. Mehr Komfort bekommt man, wenn man einen dedizierten XML-fähigen Editor nutzt, der spezielle Unterstützung für
+       <productname>DocBook</productname> mitbringt. Wir empfehlen dafür den <ulink url="http://www.xmlmind.com/xmleditor/">XMLmind XML
+       Editor</ulink>, der bei nicht kommerzieller Nutzung kostenlos ist.
+      </para>
+     </sect2>
+
+     <sect2 id="devel.build-doc.required-software">
+      <title>Benötigte Software</title>
+
+      <para>
+       Bei <productname>DocBook</productname> ist Prinzip, dass ausschließlich die XML-Quelldatei bearbeitet wird. Aus dieser werden dann
+       mit entsprechenden Stylesheets andere Formate wie PDF oder HTML erzeugt. Bei Lx-Office übernimmt diese Aufgabe das Shell-Script
+       <command>scripts/build_doc.sh</command>.
+      </para>
+
+      <para>
+       Das Script benötigt zur Konvertierung verschiedene Softwarekomponenten, die im normalen Lx-Office-Betrieb nicht benötigt werden:
+      </para>
+
+      <itemizedlist>
+       <listitem>
+        <para>
+         <ulink url="http://www.oracle.com/technetwork/java/index.html">Java</ulink> in einer halbwegs aktuellen Version
+        </para>
+       </listitem>
+
+       <listitem>
+        <para>
+         Das Java-Build-System <ulink url="http://ant.apache.org/">Apache Ant</ulink>
+        </para>
+       </listitem>
+
+       <listitem>
+        <para>
+         Das Dokumentations-System Dobudish für <productname>DocBook</productname> 4.5, eine Zusammenstellung diverser Stylesheets und
+         Grafiken zur Konvertierung von <productname>DocBook</productname> XML in andere Formate. Das Paket, das benötigt wird, ist zum
+         Zeitpunkt der Dokumentationserstellung <filename>dobudish-nojre-1.1.4.zip</filename>, aus auf <ulink
+         url="http://code.google.com/p/dobudish/downloads/list">code.google.com</ulink> bereitsteht.
+        </para>
+       </listitem>
+      </itemizedlist>
+
+      <para>
+       Apache Ant sowie ein dazu passendes Java Runtime Environment sind auf allen gängigen Plattformen verfügbar. Beispiel für
+       Debian/Ubuntu:
+      </para>
+
+      <programlisting>apt-get install ant openjdk-7-jre</programlisting>
+
+      <para>
+       Nach dem Download von Dobudish muss Dobudish im Unterverzeichnis <filename>doc/build</filename> entpackt werden. Beispiel unter der
+       Annahme, das <productname>Dobudish</productname> in <filename>$HOME/Downloads</filename> heruntergeladen wurde:
+      </para>
+
+      <programlisting>cd doc/build
+unzip $HOME/Downloads/dobudish-nojre-1.1.4.zip</programlisting>
+     </sect2>
+
+     <sect2 id="devel.build-doc.build">
+      <title>PDFs und HTML-Seiten erstellen</title>
+
+      <para>
+       Die eigentliche Konvertierung erfolgt nach Installation der benötigten Software mit einem einfachen Aufruf direkt aus dem
+       Lx-Office-Installationsverzeichnis heraus:
+      </para>
+
+      <programlisting>./scripts/build_doc.sh</programlisting>
+     </sect2>
+
+     <sect2 id="devel.build-doc.repository">
+      <title>Einchecken in das Git-Repository</title>
+
+      <para>
+       Sowohl die XML-Datei als auch die erzeugten PDF- und HTML-Dateien sind Bestandteil des Git-Repositories. Daraus folgt, dass nach
+       Änderungen am XML die PDF- und HTML-Dokumente ebenfalls gebaut und alles zusammen in einem Commit eingecheckt werden sollten.
+      </para>
+
+      <para>
+       Die "<filename>dobudish</filename>"-Verzeichnisse bzw. symbolischen Links gehören hingegen nicht in das Repository.
+      </para>
+     </sect2>
+    </sect1>
   </chapter>
 </book>
diff --git a/scripts/build_doc.sh b/scripts/build_doc.sh
new file mode 100755 (executable)
index 0000000..0db7bf3
--- /dev/null
@@ -0,0 +1,40 @@
+#!/bin/bash
+
+# Usage:
+#   cd /path/to/lx-office
+#   ./scripts/build_doc.sh
+
+set -e
+
+if [[ ! -d doc ]]; then
+  echo "Please run this from the installation directory."
+  exit 1
+fi
+
+dobudish=$(ls -d doc/build/dobudish* 2> /dev/null)
+
+if [[ -z $dobudish ]] || [[ ! -d ${dobudish} ]]; then
+  echo "There's no dobudish directory inside doc/build."
+  exit 1
+fi
+
+cd ${dobudish}
+
+base=documents/dokumentation
+if [[ ! -d $base ]]; then
+  ./generator.sh dokumentation create book
+fi
+
+input=${base}/input
+output=${base}/output
+custom=${base}/custom-cfg
+
+rm -f ${input}/*.xml
+cp ../../dokumentation.xml ${input}/
+
+rm -f ${custom}/*
+cp -R ../custom-cfg/* ${custom}/
+
+./generator.sh dokumentation pdf
+
+cp ${output}/pdf/dokumentation.pdf ../../