Projekt

Allgemein

Profil

« Zurück | Weiter » 

Revision 27f054b7

Von Moritz Bunkus vor etwa 13 Jahren hinzugefügt

  • ID 27f054b7e2b2a0847a3812a24324fcc48779641f
  • Vorgänger 90baed86
  • Nachfolger 656b6e1d

Script zum Bauen der Dokumentation sowie Dobudish-Custom-CFGs

Unterschiede anzeigen:

.gitignore
/config/lx_office.conf
/doc/online/*/*.html
pod2html*
/doc/build/dobudish*
doc/build/custom-cfg/common.xsl
<?xml version="1.0" encoding="UTF-8"?>
<!-- This file is part of DobuDish -->
<!-- DobuDish is free software; you can redistribute it and/or modify -->
<!-- it under the terms of the GNU General Public License as published by -->
<!-- the Free Software Foundation; either version 2 of the License, or -->
<!-- (at your option) any later version. -->
<!-- DobuDish is distributed in the hope that it will be useful, -->
<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of -->
<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -->
<!-- GNU General Public License for more details. -->
<!-- You should have received a copy of the GNU General Public License -->
<!-- along with DobuDish; if not, write to the Free Software -->
<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:fo="http://www.w3.org/1999/XSL/Format"
version='1.0'>
</xsl:stylesheet>
doc/build/custom-cfg/eclipse.xsl
<?xml version="1.0" encoding="UTF-8"?>
<!-- This file is part of DobuDish -->
<!-- DobuDish is free software; you can redistribute it and/or modify -->
<!-- it under the terms of the GNU General Public License as published by -->
<!-- the Free Software Foundation; either version 2 of the License, or -->
<!-- (at your option) any later version. -->
<!-- DobuDish is distributed in the hope that it will be useful, -->
<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of -->
<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -->
<!-- GNU General Public License for more details. -->
<!-- You should have received a copy of the GNU General Public License -->
<!-- along with DobuDish; if not, write to the Free Software -->
<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"
xmlns:exsl="http://exslt.org/common"
xmlns:set="http://exslt.org/sets"
version="1.0"
exclude-result-prefixes="doc exsl set">
<xsl:import href="../../../system/custom-xsl/eclipse-book.xsl"/>
<xsl:import href="common.xsl"/>
</xsl:stylesheet>
doc/build/custom-cfg/epub.xsl
<?xml version="1.0" encoding="UTF-8"?>
<!-- This file is part of DobuDish -->
<!-- DobuDish is free software; you can redistribute it and/or modify -->
<!-- it under the terms of the GNU General Public License as published by -->
<!-- the Free Software Foundation; either version 2 of the License, or -->
<!-- (at your option) any later version. -->
<!-- DobuDish is distributed in the hope that it will be useful, -->
<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of -->
<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -->
<!-- GNU General Public License for more details. -->
<!-- You should have received a copy of the GNU General Public License -->
<!-- along with DobuDish; if not, write to the Free Software -->
<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"
xmlns:exsl="http://exslt.org/common"
xmlns:set="http://exslt.org/sets"
version="1.0"
exclude-result-prefixes="doc exsl set">
<xsl:import href="../../../system/custom-xsl/epub-book.xsl"/>
<xsl:import href="common.xsl"/>
</xsl:stylesheet>
doc/build/custom-cfg/fo.xsl
<?xml version="1.0" encoding="UTF-8"?>
<!-- This file is part of DobuDish -->
<!-- DobuDish is free software; you can redistribute it and/or modify -->
<!-- it under the terms of the GNU General Public License as published by -->
<!-- the Free Software Foundation; either version 2 of the License, or -->
<!-- (at your option) any later version. -->
<!-- DobuDish is distributed in the hope that it will be useful, -->
<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of -->
<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -->
<!-- GNU General Public License for more details. -->
<!-- You should have received a copy of the GNU General Public License -->
<!-- along with DobuDish; if not, write to the Free Software -->
<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:fo="http://www.w3.org/1999/XSL/Format"
version='1.0'>
<xsl:import href="../../../system/custom-xsl/fo-book.xsl"/>
<xsl:import href="common.xsl"/>
</xsl:stylesheet>
doc/build/custom-cfg/html.xsl
<?xml version="1.0" encoding="UTF-8"?>
<!-- This file is part of DobuDish -->
<!-- DobuDish is free software; you can redistribute it and/or modify -->
<!-- it under the terms of the GNU General Public License as published by -->
<!-- the Free Software Foundation; either version 2 of the License, or -->
<!-- (at your option) any later version. -->
<!-- DobuDish is distributed in the hope that it will be useful, -->
<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of -->
<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -->
<!-- GNU General Public License for more details. -->
<!-- You should have received a copy of the GNU General Public License -->
<!-- along with DobuDish; if not, write to the Free Software -->
<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"
xmlns:exsl="http://exslt.org/common"
xmlns:set="http://exslt.org/sets"
version="1.0"
exclude-result-prefixes="doc exsl set">
<xsl:import href="../../../system/custom-xsl/html-book.xsl"/>
<xsl:import href="common.xsl"/>
</xsl:stylesheet>
doc/build/custom-cfg/htmlhelp.xsl
<?xml version="1.0" encoding="UTF-8"?>
<!-- This file is part of DobuDish -->
<!-- DobuDish is free software; you can redistribute it and/or modify -->
<!-- it under the terms of the GNU General Public License as published by -->
<!-- the Free Software Foundation; either version 2 of the License, or -->
<!-- (at your option) any later version. -->
<!-- DobuDish is distributed in the hope that it will be useful, -->
<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of -->
<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -->
<!-- GNU General Public License for more details. -->
<!-- You should have received a copy of the GNU General Public License -->
<!-- along with DobuDish; if not, write to the Free Software -->
<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"
xmlns:exsl="http://exslt.org/common"
xmlns:set="http://exslt.org/sets"
version="1.0"
exclude-result-prefixes="doc exsl set">
<xsl:import href="../../../system/custom-xsl/htmlhelp-book.xsl"/>
<xsl:import href="common.xsl"/>
</xsl:stylesheet>
doc/build/custom-cfg/javahelp.xsl
<?xml version="1.0" encoding="UTF-8"?>
<!-- This file is part of DobuDish -->
<!-- DobuDish is free software; you can redistribute it and/or modify -->
<!-- it under the terms of the GNU General Public License as published by -->
<!-- the Free Software Foundation; either version 2 of the License, or -->
<!-- (at your option) any later version. -->
<!-- DobuDish is distributed in the hope that it will be useful, -->
<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of -->
<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -->
<!-- GNU General Public License for more details. -->
<!-- You should have received a copy of the GNU General Public License -->
<!-- along with DobuDish; if not, write to the Free Software -->
<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"
xmlns:exsl="http://exslt.org/common"
xmlns:set="http://exslt.org/sets"
version="1.0"
exclude-result-prefixes="doc exsl set">
<xsl:import href="../../../system/custom-xsl/javahelp-book.xsl"/>
<xsl:import href="common.xsl"/>
</xsl:stylesheet>
doc/build/custom-cfg/local-entities.xml
<?xml version="1.0" encoding="UTF-8"?>
<!-- This file is part of DobuDish -->
<!-- DobuDish is free software; you can redistribute it and/or modify -->
<!-- it under the terms of the GNU General Public License as published by -->
<!-- the Free Software Foundation; either version 2 of the License, or -->
<!-- (at your option) any later version. -->
<!-- DobuDish is distributed in the hope that it will be useful, -->
<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of -->
<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -->
<!-- GNU General Public License for more details. -->
<!-- You should have received a copy of the GNU General Public License -->
<!-- along with DobuDish; if not, write to the Free Software -->
<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->
<!ENTITY local_entity "local entity (defined per document)">
doc/build/custom-cfg/localbuild.properties
# BEGIN Do not overwrite
document.type = book
# END Do not overwrite
# Overwrite properties here
# If you happen to have sub documents you can set here the document type of each one of those.
#document.<sub_document_name>.type = article|book|set|website|slides...
# These are needed for the 'eclipse' target
eclipse.plugin.id=com.mycompany
eclipse.plugin.name=Document Name
eclipse.plugin.provider=My Company
# The version of the eclipse plugin
eclipse.plugin.version=${document.version}
# The version of the document
document.version = 1.0
# The name of the folder whose content will be carbon copied to the output directory
special.folder.name.carbonCopy=copy_to_output
doc/build/custom-cfg/localbuild.xml
<?xml version="1.0" encoding="UTF-8"?>
<!-- This file is part of DobuDish -->
<!-- DobuDish is free software; you can redistribute it and/or modify -->
<!-- it under the terms of the GNU General Public License as published by -->
<!-- the Free Software Foundation; either version 2 of the License, or -->
<!-- (at your option) any later version. -->
<!-- DobuDish is distributed in the hope that it will be useful, -->
<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of -->
<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -->
<!-- GNU General Public License for more details. -->
<!-- You should have received a copy of the GNU General Public License -->
<!-- along with DobuDish; if not, write to the Free Software -->
<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->
<project>
<!--
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>
-->
</project>
doc/build/custom-cfg/manpages.xsl
<?xml version="1.0" encoding="UTF-8"?>
<!-- This file is part of DobuDish -->
<!-- DobuDish is free software; you can redistribute it and/or modify -->
<!-- it under the terms of the GNU General Public License as published by -->
<!-- the Free Software Foundation; either version 2 of the License, or -->
<!-- (at your option) any later version. -->
<!-- DobuDish is distributed in the hope that it will be useful, -->
<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of -->
<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -->
<!-- GNU General Public License for more details. -->
<!-- You should have received a copy of the GNU General Public License -->
<!-- along with DobuDish; if not, write to the Free Software -->
<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"
xmlns:exsl="http://exslt.org/common"
xmlns:set="http://exslt.org/sets"
version="1.0"
exclude-result-prefixes="doc exsl set">
<xsl:import href="../../../system/custom-xsl/manpages.xsl"/>
<xsl:import href="common.xsl"/>
</xsl:stylesheet>
doc/build/custom-cfg/rtf.xsl
<?xml version="1.0" encoding="UTF-8"?>
<!-- This file is part of DobuDish -->
<!-- DobuDish is free software; you can redistribute it and/or modify -->
<!-- it under the terms of the GNU General Public License as published by -->
<!-- the Free Software Foundation; either version 2 of the License, or -->
<!-- (at your option) any later version. -->
<!-- DobuDish is distributed in the hope that it will be useful, -->
<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of -->
<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -->
<!-- GNU General Public License for more details. -->
<!-- You should have received a copy of the GNU General Public License -->
<!-- along with DobuDish; if not, write to the Free Software -->
<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"
xmlns:exsl="http://exslt.org/common"
xmlns:set="http://exslt.org/sets"
version="1.0"
exclude-result-prefixes="doc exsl set">
<xsl:import href="../../../system/custom-xsl/rtf-book.xsl"/>
<xsl:import href="common.xsl"/>
</xsl:stylesheet>
doc/build/custom-cfg/singlehtml.xsl
<?xml version="1.0" encoding="UTF-8"?>
<!-- This file is part of DobuDish -->
<!-- DobuDish is free software; you can redistribute it and/or modify -->
<!-- it under the terms of the GNU General Public License as published by -->
<!-- the Free Software Foundation; either version 2 of the License, or -->
<!-- (at your option) any later version. -->
<!-- DobuDish is distributed in the hope that it will be useful, -->
<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of -->
<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -->
<!-- GNU General Public License for more details. -->
<!-- You should have received a copy of the GNU General Public License -->
<!-- along with DobuDish; if not, write to the Free Software -->
<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"
xmlns:exsl="http://exslt.org/common"
xmlns:set="http://exslt.org/sets"
version="1.0"
exclude-result-prefixes="doc exsl set">
<xsl:import href="../../../system/custom-xsl/singlehtml-book.xsl"/>
<xsl:import href="common.xsl"/>
</xsl:stylesheet>
doc/build/custom-cfg/singlexhtml.xsl
<?xml version="1.0" encoding="UTF-8"?>
<!-- This file is part of DobuDish -->
<!-- DobuDish is free software; you can redistribute it and/or modify -->
<!-- it under the terms of the GNU General Public License as published by -->
<!-- the Free Software Foundation; either version 2 of the License, or -->
<!-- (at your option) any later version. -->
<!-- DobuDish is distributed in the hope that it will be useful, -->
<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of -->
<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -->
<!-- GNU General Public License for more details. -->
<!-- You should have received a copy of the GNU General Public License -->
<!-- along with DobuDish; if not, write to the Free Software -->
<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"
xmlns:exsl="http://exslt.org/common"
xmlns:set="http://exslt.org/sets"
version="1.0"
exclude-result-prefixes="doc exsl set">
<xsl:import href="../../../system/custom-xsl/singlexhtml-book.xsl"/>
<xsl:import href="common.xsl"/>
</xsl:stylesheet>
doc/build/custom-cfg/slides.xsl
<?xml version="1.0" encoding="UTF-8"?>
<!-- This file is part of DobuDish -->
<!-- DobuDish is free software; you can redistribute it and/or modify -->
<!-- it under the terms of the GNU General Public License as published by -->
<!-- the Free Software Foundation; either version 2 of the License, or -->
<!-- (at your option) any later version. -->
<!-- DobuDish is distributed in the hope that it will be useful, -->
<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of -->
<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -->
<!-- GNU General Public License for more details. -->
<!-- You should have received a copy of the GNU General Public License -->
<!-- along with DobuDish; if not, write to the Free Software -->
<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"
xmlns:exsl="http://exslt.org/common"
xmlns:set="http://exslt.org/sets"
version="1.0"
exclude-result-prefixes="doc exsl set">
<xsl:import href="../../../system/custom-xsl/slides.xsl"/>
<xsl:import href="common.xsl"/>
</xsl:stylesheet>
doc/build/custom-cfg/style-common.css
/* Basic Settings: */
body {
background-color: White; /* black foreground */
color: Black; /* center the body content in browser window */
margin: auto; /* padding ("inner margin") leaves space between */
padding: 24px; /* set width according to browser window width */
width: auto; /* text alignment */
text-align: justify; /* text-align: left; */
}
/* para */
p {
/* font size, line height, font */
/* list of fonts provides fallbacks if a font is not present */
font: 12px/18px Verdana, Arial, Helvetica, Sans-Serif;
/* margin (top - right - bottom - left) */
margin: 0 15px 6px 15px;
}
/* NEEDS TO BE CLEARED UP */
p, td, li, dt, dd
{
/* font size, line height, font */
/* list of fonts provides fallbacks if a font is not present */
font: 12px/18px Verdana, Arial, Helvetica, Sans-Serif;
}
/* set font for most elements */
/* p: paragraphs (regular text, docbook <para>) */
/* (...) */
/* body: anything else */
body, p, td, li, dt, dd,
{
/* set font size and line height */
/* list of fonts provides fallbacks if a font is not present */
font: 12px/18px Verdana, Arial, Helvetica, Sans-Serif;
}
/* images */
/* docbook: <imageobject> */
img {
/* no margin */
margin: 0;
/* no padding ("inner margin") */
padding: 0;
/* no border */
border: 0;
}
/* emphasized text, can occur in most places */
/* docbook: <emphasis> */
em {
/* bold face, higher number is more bold */
font-weight: 600;
/* italic */
font-style: italic;
}
/* sect(ion)1 title */
h2 {
font-family: Georgia, Verdana, Arial, Helvetica, Sans-Serif; /* font size, relative to body font size */
font-size: 125%; /* bold face, higher number is more bold */
font-weight: 600; /* underlined text */
text-decoration: none; /* foreground color: dark blue */
color: Black; /* background color: gray */
background-color: Orange; /* margin settings are top - right - bottom - left (think clockwise) */
margin: 15px 0 15px 0; /* padding ("inner margin") settings are top - right - bottom - left */
/* (think clockwise) */
padding: 8px 15px 8px 15px;
/* border: 1px solid #000; */
}
/* sect(ion)2 title */
h3 {
font-family: Georgia, Verdana, Arial, Helvetica, Sans-Serif; /* font size, relative to body font size */
font-size: 110%; /* bold face, higher number is more bold */
font-weight: 600; /* underlined text */
text-decoration: none; /* foreground color: dark blue */
color: Black; /* background-color is a very light grey */
background-color: #fefefe; /* padding ("inner margin") settings are top - right - bottom - left */
/* (think clockwise) */
padding: 0 0 0 15px;
}
/* sect(ion)3 title */
h4 {
font-family: Georgia, Verdana, Arial, Helvetica, Sans-Serif; /* font size, relative to body font size */
font-size: 100%; /* bold face, higher number is more bold */
font-weight: 600; /* underlined text */
text-decoration: none; /* foreground color: dark blue */
color: Black; /* background-color is a very light grey */
background-color: #fefefe; /* padding ("inner margin") settings are top - right - bottom - left */
/* (think clockwise) */
padding: 0 0 0 15px;
}
/* sect(ion)4 title */
h5 {
font-family: Georgia, Verdana, Arial, Helvetica, Sans-Serif; /* font size, relative to body font size */
font-size: 100%; /* bold face, higher number is more bold */
font-weight: 300; /* not underlined */
text-decoration: none; /* foreground color: dark blue */
color: Black; /* background-color is a very light grey */
background-color: #fefefe; /* padding ("inner margin") settings are top - right - bottom - left */
/* (think clockwise) */
padding: 0 0 0 15px;
}
/* the following formats refer to the docbook tags of the same name */
/* for more information, see the docbook reference at */
/* http://www.docbook.org/tdg/en/html/docbook.html */
.mediaobject
{
/* center */
text-align: center;
}
/* */
.calloutlist, .figure, .table
{
/* margin settings are top - right - bottom - left (think clockwise) */
margin: 15px 30px 15px 30px;
}
/* */
.itemizedlist, .variablelist {
/* margin settings are top - right - bottom - left (think clockwise) */
margin: 15px 30px 15px 15px;
}
/* blockquote formatting is a little more complex */
/* because block quotes are rendered as a html table */
/* blockquote block */
.blockquote
{
/* override bottom margin, the other margins are inherited */
margin-bottom: 30px;
}
.blockquote p, .blockquote td
{
/* set font size and line height */
/* list of fonts provides fallbacks if a font is not present */
font: 12px/18px Verdana, Arial, Helvetica, Sans-Serif;
/* bold face, higher number is more bold */
font-weight: 450;
}
.epigraph
{
/* override bottom margin, the other margins are inherited */
margin-bottom: 30px;
}
.epigraph p, .epigraph td
{
/* set font size and line height */
/* list of fonts provides fallbacks if a font is not present */
font: 10px/14px Verdana, Arial, Helvetica, Sans-Serif;
/* bold face, higher number is more bold */
font-weight: 600;
}
/* custom header and footer that are displayed on all pages */
#customheader, #customfooter
{
/* list of fonts provides fallbacks if a font is not present */
font-family: Verdana, Arial, Helvetica, Sans-Serif;
/* font size, relative to body font size */
font-size: 80%;
/* line height, relative to body font size */
line-height: 200%;
text-align: center;
vertical-align: middle;
color: #fff;
background-color: #009;
}
/* leave more space between last paragraph and footer */
/* some browser do not add up the bottom margin of the prior element */
/* and the top margin of the footer */
#customfooter {
margin-top: 15px;
}
/* table { margin: 0 15px 6px 15px; } */
/* title and navigation links in header and footer */
.navheader th, .navheader td, .navfooter th, .navfooter td
{
font-size: 11px;
font-weight: 450;
}
/* table of contents, list of figures and list of tables */
.toc, .list-of-figures, .list-of-tables, .list-of-examples
{
/* margin settings are top - right - bottom - left (think clockwise) */
margin: 15px 30px 15px 15px;
}
/* the "headings" are rendered as paragraphs */
.toc p, .list-of-figures p, .list-of-tables p, .list-of-examples p
{
/* no margin */
margin: 0;
}
.figure
{
/* margin settings are top - right - bottom - left (think clockwise) */
margin: 5px 5px 5px 5px;
/* no padding ("inner border") */
padding: 0;
/* no border */
border: 0;
/* center text */
text-align: center;
}
/* figure title */
.figure p, .table p, .example p
{
font-size: 80%;
}
/*
acronym {
border-bottom: 1px dashed #00cc00;
cursor: help;
}
*/
/* admonition headings */
div.note, div.important, div.warning, div.caution, div.tip
{
padding: 0px 15px 0px 0px;
}
div.note th, div.important th, div.warning th, div.caution th, div.tip th
{
/* set font size and line height */
/* list of fonts provides fallbacks if a font is not present */
font: 12px/18px Verdana, Arial, Helvetica, Sans-Serif;
font-weight: 600;
text-decoration: underline;
/* left align */
text-align: left;
}
.note p, .important p, .warning p, .caution p, .tip p
{
margin: 0;
}
.note img, .important img, .warning img, .caution img, .tip img
{
margin: 0px 15px 0px 15px;
}
/* programlisting */
pre.programlisting
{
/* non-proportional font */
/* list of fonts provides fallbacks if a font is not present */
font-family: "Courier New", Courier, Monospace;
/* color: black */
color: #000;
/* background color: gray */
background-color: #eee;
/* no margin */
margin: 0;
/* gray dotted border, 1 px wide */
border: 1px dotted #ddd;
/* padding ("inner margin") settings are top - right - bottom - left */
/* (think clockwise) */
padding: 6px 6px 6px 6px;
}
/* title page */
/* heading1 is used for document title */
h1
{
font-family: Georgia,Verdana, Arial, Helvetica, Sans-Serif; /* font size, relative to body font size */
font-size: 150%; /* bold face, higher number is more bold */
font-weight: 600; /* line height, relative to body line height */
line-height: 250%; /* center */
text-align: center; /* foreground color: dark blue */
color: Black; /* background color: gray */
background-color: Orange; /* margin settings are top - right - bottom - left (think clockwise) */
margin: 15px 0 15px 0; /* no padding ("inner margin") */
padding: 15;
border: 1px solid #000;
}
/* author on title page is formatted as h3 */
/* these settings overwrite the regular h3 settings */
h3.author {
/* set font size and line height */
/* list of fonts provides fallbacks in case selected fonts are not present */
font: 12px/18px Verdana, Arial, Helvetica, Sans-Serif;
/* bold face, higher number is more bold */
font-weight: 600;
/* do not underline */
text-decoration: none;
/* center text */
text-align: center;
/* color: black */
color: #000;
/* background-color is a very light grey */
/* alternative: #fff = white */
background-color: #fefefe;
/* margin settings are top - right - bottom - left (think clockwise) */
margin: 0 15px 15px 15px;
/* no padding */
padding: 0;
/* no border */
border: 0;
}
/* copyright and date */
.copyright, .pubdate
{
/* list of fonts provides fallbacks if a font is not present */
font-family: Verdana, Arial, Helvetica, Sans-Serif;
/* font size, relative to body font size */
font-size: 90%;
/* center */
text-align: center;
/* margin settings are top - right - bottom - left (think clockwise) */
margin: 15px 15px 15px 15px;
/* no padding ("inner margin") */
padding: 0;
/* no border */
border: 0;
}
/* legal notice box */
div.legalnotice
{
font-family: Verdana, Arial, Helvetica, Sans-Serif; /* font size, relative to body font size */
font-size: 90%; /* color: black */
color: #000; /* background color: gray */
background-color: Orange; /* margin settings are top - right - bottom - left (think clockwise) */
margin: 10px 45px 10px 45px; /* padding ("inner margin") settings are top - right - bottom - left */
padding: 5px 5px 5px 5px; /* solid black border, 1px wide */
border: 1px solid #000;
}
table {
/* border: thin solid orange; */
border-spacing: 0pt;
margin-top: 5;
margin-bottom: 5;
}
td {
font-family: SansSerif, Arial, Helvetica, sans-serif;
padding-left: 1;
padding-right: 1;
padding-top: 1;
padding-bottom: 1
}
th {
/* border: thin solid orange; */
padding-left: 1;
padding-right: 1;
padding-top: 1;
padding-bottom: 1
}
.informaltable {
border-collapse: collapse;
table-layout: auto;
}
.revhistory {
border-collapse: collapse;
table-layout: auto;
}
doc/build/custom-cfg/style-eclipse.css
body {font-size: 10pt;
font-family: SansSerif, Arial, Helvetica, sans-serif;
margin-left: 10;
margin-right: 5;
color: Black;
background-color: White}
h1 {
font-size: 18pt;
}
h2 {
font-size: 16pt;
}
h3 {
font-size: 14pt;
}
h4 {
font-size: 12pt;
}
table {
font-size: 10pt;
border-style: none;
border-color: silver;
margin-top: 5;
margin-bottom: 5
}
td {font-size: 10pt;
font-family: SansSerif, Arial, Helvetica, sans-serif;
border-color: silver;
padding-left: 1;
padding-right: 1;
padding-top: 1;
padding-bottom: 1}
th {border-style: none;
font-weight: bold;
border-color: silver;
padding-left: 1;
padding-right: 1;
padding-top: 1;
padding-bottom: 1}
kbd {
font-family: monospace;
font-weight: bold;
}
var {
font-style: italic;
}
ol {
margin-bottom: 1em;
}
dt {
font-weight: bold;
margin-top: 1em;
}
li {
margin-top: 1em;
}
span.control {
font-weight: bold;
}
span.name {
font-style: italic;
font-weight: bold;
}
span.action {
font-style: italic;
}
span.code {
font-family: monospace;
}
span.menu {
color: #660033;
font-weight: bold;
}
span.filefolder {
font-family: monospace;
}
blockquote {
background-color: #e8e8e8;
border: 1pt black;
margin: 2em; border: 1px solid black;
padding: 1em;
}
.tasks, .reference, .faq {
padding-left: 18px;
font-size: 14pt;
background-image:url(images/bullet14.png);
background-repeat: no-repeat;
background-position: left;
}
doc/build/custom-cfg/style-javahelp.css
/*
* jhexamples.css 06/17/2003
*
* Copyright 2002 Sun Microsystems, Inc. All rights reserved.
* Use is subject to license terms.
*
*/
body {font-size: 12pt;
font-family: SansSerif, Arial, Helvetica, sans-serif;
margin-left: 10;
margin-right: 5;
color: Black;
background-color: White}
p {font-size: 12pt;
margin-top: 5;
margin-bottom: 5}
h1 { font-size: 22pt;
font-weight: bold;
margin-top: 0;
margin-bottom: 10}
h2 { font-size: 18pt;
font-weight: bold;
margin-top: 20;
margin-bottom: 10}
h3 { font-size: 14pt;
font-weight: bold;
margin-top: 10;
margin-bottom: 5}
h4 { font-size: 12pt;
font-weight: bold;
margin-top: 10;
margin-bottom: 5}
ol {margin-top: 5;
margin-bottom: 0;
margin-left: 30}
li {margin-top: 0;
margin-bottom: 5}
li p{margin-top: 5;
margin-bottom: 0}
ul {margin-top: 5;
margin-bottom: 0;
margin-left: 30}
table {border-style: none;
border-color: silver;
margin-top: 5;
margin-bottom: 5}
td {font-size: 12pt;
font-family: SansSerif, Arial, Helvetica, sans-serif;
border-color: silver;
padding-left: 1;
padding-right: 1;
padding-top: 1;
padding-bottom: 1}
th {border-style: none;
border-color: silver;
padding-left: 1;
padding-right: 1;
padding-top: 1;
padding-bottom: 1}
small {font-size: x-small}
doc/build/custom-cfg/wordml.xsl
<?xml version="1.0" encoding="UTF-8"?>
<!-- This file is part of DobuDish -->
<!-- DobuDish is free software; you can redistribute it and/or modify -->
<!-- it under the terms of the GNU General Public License as published by -->
<!-- the Free Software Foundation; either version 2 of the License, or -->
<!-- (at your option) any later version. -->
<!-- DobuDish is distributed in the hope that it will be useful, -->
<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of -->
<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -->
<!-- GNU General Public License for more details. -->
<!-- You should have received a copy of the GNU General Public License -->
<!-- along with DobuDish; if not, write to the Free Software -->
<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"
xmlns:exsl="http://exslt.org/common"
xmlns:set="http://exslt.org/sets"
version="1.0"
exclude-result-prefixes="doc exsl set">
<xsl:import href="../../../system/custom-xsl/wordml-book.xsl"/>
<xsl:import href="common.xsl"/>
</xsl:stylesheet>
doc/build/custom-cfg/xhtml.xsl
<?xml version="1.0" encoding="UTF-8"?>
<!-- This file is part of DobuDish -->
<!-- DobuDish is free software; you can redistribute it and/or modify -->
<!-- it under the terms of the GNU General Public License as published by -->
<!-- the Free Software Foundation; either version 2 of the License, or -->
<!-- (at your option) any later version. -->
<!-- DobuDish is distributed in the hope that it will be useful, -->
<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of -->
<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -->
<!-- GNU General Public License for more details. -->
<!-- You should have received a copy of the GNU General Public License -->
<!-- along with DobuDish; if not, write to the Free Software -->
<!-- Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"
xmlns:exsl="http://exslt.org/common"
xmlns:set="http://exslt.org/sets"
version="1.0"
exclude-result-prefixes="doc exsl set">
<xsl:import href="../../../system/custom-xsl/xhtml-book.xsl"/>
<xsl:import href="common.xsl"/>
</xsl:stylesheet>
doc/dokumentation.xml
</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>
scripts/build_doc.sh
#!/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 ../../

Auch abrufbar als: Unified diff