Add Apache License headers and one or two Rat exclusions.
diff --git a/pom.xml b/pom.xml
index 6230365..536f171 100644
--- a/pom.xml
+++ b/pom.xml
@@ -24,6 +24,8 @@
<version>1.0-SNAPSHOT</version>
<packaging>pom</packaging>
<name>river-container</name>
+ <url>river.apache.org/river-container</url>
+
<modules>
<module>river-container-core</module>
<module>test-container</module>
@@ -69,6 +71,19 @@
<groupId>org.apache.rat</groupId>
<artifactId>apache-rat-plugin</artifactId>
<version>0.10</version>
+ <configuration>
+ <excludes>
+ <!-- Manifest files don't have comments -->
+ <exclude>**/*.MF</exclude>
+ <!-- Neither does the configuration provider resource -->
+ <exclude>**/META-INF/services/net.jini.config.Configuration</exclude>
+ </excludes>
+ </configuration>
+ </plugin>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-project-info-reports-plugin</artifactId>
+ <version>2.7</version>
</plugin>
</plugins>
</reporting>
diff --git a/river-container-core/pom.xml b/river-container-core/pom.xml
index ea41ea4..54ffb55 100644
--- a/river-container-core/pom.xml
+++ b/river-container-core/pom.xml
@@ -32,6 +32,7 @@
<url>http://maven.apache.org</url>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+ <owb.version>1.2.0</owb.version>
</properties>
<dependencies>
<dependency>
@@ -66,6 +67,29 @@
<scope>test</scope>
</dependency>
+
+ <!-- Added for Open Web Beans -->
+ <dependency>
+ <groupId>org.apache.openwebbeans</groupId>
+ <artifactId>openwebbeans-spi</artifactId>
+ <version>${owb.version}</version>
+ <scope>compile</scope>
+ </dependency>
+
+ <dependency>
+ <groupId>org.apache.openwebbeans</groupId>
+ <artifactId>openwebbeans-impl</artifactId>
+ <version>${owb.version}</version>
+ <scope>compile</scope>
+ </dependency>
+
+ <dependency>
+ <groupId>org.apache.openwebbeans</groupId>
+ <artifactId>openwebbeans-el22</artifactId>
+ <version>${owb.version}</version>
+ <scope>compile</scope>
+ </dependency>
+
</dependencies>
<build>
<plugins>
diff --git a/river-container-maven-plugin/pom.xml b/river-container-maven-plugin/pom.xml
index 5373d9e..161fe36 100644
--- a/river-container-maven-plugin/pom.xml
+++ b/river-container-maven-plugin/pom.xml
@@ -28,7 +28,7 @@
<version>1.0-SNAPSHOT</version>
<packaging>maven-plugin</packaging>
- <name>river-container-maven-plugin Maven Plugin</name>
+ <name>river-container-maven-plugin</name>
<!-- FIXME change it to the project's website -->
<url>http://maven.apache.org</url>
diff --git a/user-docs/pom.xml b/user-docs/pom.xml
index 4d0659b..d6cd85f 100644
--- a/user-docs/pom.xml
+++ b/user-docs/pom.xml
@@ -18,22 +18,110 @@
-->
<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
- <modelVersion>4.0.0</modelVersion>
- <parent>
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+ <modelVersion>4.0.0</modelVersion>
+ <parent>
+ <groupId>org.apache.river.container</groupId>
+ <artifactId>river-container</artifactId>
+ <version>1.0-SNAPSHOT</version>
+ </parent>
<groupId>org.apache.river.container</groupId>
- <artifactId>river-container</artifactId>
+ <artifactId>user-docs</artifactId>
<version>1.0-SNAPSHOT</version>
- </parent>
- <groupId>org.apache.river.container</groupId>
- <artifactId>user-docs</artifactId>
- <version>1.0-SNAPSHOT</version>
- <name>user-docs</name>
- <url>http://maven.apache.org</url>
- <properties>
- <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
- </properties>
- <dependencies>
+ <name>user-docs</name>
+ <url>http://maven.apache.org</url>
+ <properties>
+ <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+ </properties>
+ <dependencies>
- </dependencies>
+ </dependencies>
+
+
+ <build>
+ <plugins>
+ <!-- Maven docbook configuration -->
+ <plugin>
+ <groupId>com.agilejava.docbkx</groupId>
+ <artifactId>docbkx-maven-plugin</artifactId>
+ <version>2.0.14</version>
+ <executions>
+ <execution>
+ <id>single-pdf-page</id>
+ <goals>
+ <goal>generate-pdf</goal>
+ </goals>
+ <configuration>
+ <calloutGraphicsPath>src/docbkx/resources/images/callouts/</calloutGraphicsPath>
+ <admonGraphicsPath>src/docbkx/resources/images/admons/</admonGraphicsPath>
+ <imgSrcPath>src/docbkx/resources/images/</imgSrcPath>
+ <foCustomization>${basedir}/src/docbkx/resources/xsl/fopdf.xsl</foCustomization>
+ <draftMode>1</draftMode>
+ <postProcess>
+ <copy todir="${basedir}/target/site">
+ <fileset dir="${basedir}/target/docbkx">
+ <include name="**/*.pdf" />
+ </fileset>
+ </copy>
+ </postProcess>
+ </configuration>
+ <phase>site</phase>
+ </execution>
+ <execution>
+ <id>single-html-page</id>
+ <goals>
+ <goal>generate-html</goal>
+ </goals>
+ <configuration>
+ <imgSrcPath>images/</imgSrcPath>
+ <chunkedOutput>false</chunkedOutput>
+ <targetDirectory>${basedir}/target/docbkx/html-single</targetDirectory>
+ <htmlStylesheet>css/html.css</htmlStylesheet>
+ <htmlCustomization>${basedir}/src/docbkx/resources/xsl/html.xsl</htmlCustomization>
+ <!--
+ Just because it's sometimes time costly, I
+ delete only this directory to allow re
+ generation by docbkx plugin During documentation
+ phase, it's useful because it allows a quick and
+ nice overview without costly pdf generation and
+ all packaging.
+ -->
+ <preProcess>
+ <delete dir="${basedir}/target/docbkx/html-single" />
+ </preProcess>
+ <postProcess>
+ <copy todir="${basedir}/target/site/html-single">
+ <fileset dir="${basedir}/target/docbkx/html-single">
+ <include name="**/*.html" />
+ </fileset>
+ </copy>
+ <copy todir="${basedir}/target/site/html-single">
+ <fileset dir="${basedir}/src/docbkx/resources">
+ <include name="**/*.css" />
+ <include name="**/*.png" />
+ <include name="**/*.gif" />
+ <include name="**/*.jpg" />
+ </fileset>
+ </copy>
+ </postProcess>
+ </configuration>
+ <phase>site</phase>
+ </execution>
+ </executions>
+ <configuration>
+ <xincludeSupported>true</xincludeSupported>
+ </configuration>
+ <dependencies>
+ <dependency>
+ <groupId>org.docbook</groupId>
+ <artifactId>docbook-xml</artifactId>
+ <version>4.4</version>
+ <scope>runtime</scope>
+ </dependency>
+ </dependencies>
+ </plugin>
+ </plugins>
+ </build>
+
+
</project>
diff --git a/user-docs/src/docbkx/common/abstract.xml b/user-docs/src/docbkx/common/abstract.xml
new file mode 100644
index 0000000..6426add
--- /dev/null
+++ b/user-docs/src/docbkx/common/abstract.xml
@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="UTF-8"?>
+ <!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership. The
+ ASF licenses this file to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance with the
+ License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable
+ law or agreed to in writing, software distributed under the License is
+ distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the specific
+ language governing permissions and limitations under the License.
+-->
+<!DOCTYPE abstract PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+ "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+
+ <!ENTITY % entities SYSTEM "../entities.ent" >
+ %entities;
+]>
+
+<abstract>
+ <para>
+ &productname; is a container for services using the Jini
+ Service Oriented ArchitectureÏ.
+ </para>
+ <para>
+ Jini is a technology for implementing Service Oriented Architectures
+ based on the concept of Java proxies to services. The fundamental idea
+ is that service consumers are implemented in Java. In order to use a service,
+ the consumer loads a serialized proxy from a lookup service, or Registrar.
+ </para>
+ <para>
+ Since the proxy is loaded using Java dynamic class loading, it can implement
+ any protocol required by the service implementation. As a result, Jini services
+ do not depend on any particular protocol, and each service is free to
+ choose a protocol and implementation options that suit the service.
+ </para>
+</abstract>
+
\ No newline at end of file
diff --git a/user-docs/src/docbkx/common/legalnotes.xml b/user-docs/src/docbkx/common/legalnotes.xml
new file mode 100644
index 0000000..03c1888
--- /dev/null
+++ b/user-docs/src/docbkx/common/legalnotes.xml
@@ -0,0 +1,47 @@
+<?xml version="1.0" encoding="UTF-8"?>
+ <!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership. The
+ ASF licenses this file to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance with the
+ License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable
+ law or agreed to in writing, software distributed under the License is
+ distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the specific
+ language governing permissions and limitations under the License.
+ -->
+<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+ "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+
+ <!ENTITY % entities SYSTEM "../entities.ent" >
+ %entities;
+]>
+
+<appendix id="legal.notes">
+ <title>Legal notes</title>
+ <para>
+ <productname class="registered">&productnamecomplete;</productname> is a registered trademark.
+ </para>
+ <para>
+ All rights, including in respect of the translation, printing and
+ duplication of this document or parts thereof, are retained.
+ No part of this document may be reproduced or processed with or
+ without electronic means, in any form, without the prior written permission of
+ <orgname>&companyname;</orgname>.
+ This includes for training purposes.
+ </para>
+ <para>
+ <productname class="trade">Java</productname>
+ and all Java-based trademarks and logos are trademarks or registered trademarks of
+ <orgname>Sun Microsystems, Inc</orgname>.
+ in the United States and other countries.
+ </para>
+ <para>
+ All other brand names, designs, service marks and trademarks (whether or not registered)
+ referenced or used herein are the property of their respective owners.
+ </para>
+</appendix>
+
diff --git a/user-docs/src/docbkx/common/thirdparty.xml b/user-docs/src/docbkx/common/thirdparty.xml
new file mode 100644
index 0000000..b374f75
--- /dev/null
+++ b/user-docs/src/docbkx/common/thirdparty.xml
@@ -0,0 +1,75 @@
+<?xml version="1.0" encoding="UTF-8"?>
+ <!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership. The
+ ASF licenses this file to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance with the
+ License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable
+ law or agreed to in writing, software distributed under the License is
+ distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the specific
+ language governing permissions and limitations under the License.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+ "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+
+ <!ENTITY % entities SYSTEM "../entities.ent" >
+ %entities;
+]>
+
+<refentry id="thirdparty">
+ <indexterm zone="thirdparty">
+ <primary>Requirements</primary>
+ <secondary>3rd party libraries</secondary>
+ </indexterm>
+ <indexterm zone="thirdparty">
+ <primary>Licenses</primary>
+ </indexterm>
+ <refnamediv>
+ <refname>
+ Third Party Libraries and Licenses
+ </refname>
+ <refpurpose>
+ Third party libraries were chosen for their wide
+ acceptance, feature set, stability and ease of use.
+ </refpurpose>
+ </refnamediv>
+
+ <refsection>
+ <title>Third Party Libraries used by &productname; and their respective Licenses
+ </title>
+ <para>
+ The &productname; uses the following 3rd party libraries:
+ <informaltable frame="all">
+
+ <tgroup cols="3" align="left" colsep="1" rowsep="1">
+ <colspec colname="lib" colwidth="2*" align="left" />
+ <colspec colname="version" colwidth="1*" align="center" />
+ <colspec colname="license" colwidth="3*" align="left" />
+ <thead>
+ <row>
+ <entry>Library</entry>
+ <entry>Version</entry>
+ <entry>License</entry>
+ </row>
+ </thead>
+ <tbody>
+
+ <row>
+ <entry>
+ Apache <classname>To Be Determined</classname>
+ </entry>
+ <entry>3.1.2</entry>
+ <entry>Apache Software License 2.0</entry>
+ </row>
+
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsection>
+</refentry>
+
diff --git a/user-docs/src/docbkx/entities.ent b/user-docs/src/docbkx/entities.ent
new file mode 100644
index 0000000..a7872bf
--- /dev/null
+++ b/user-docs/src/docbkx/entities.ent
@@ -0,0 +1,33 @@
+<!ENTITY productversion "0.1">
+<!ENTITY productname "<application>River Container</application>">
+<!ENTITY productnamecomplete "<application>Apache River Container</application>">
+<!ENTITY companyname "The Apache Software Foundation">
+<!ENTITY departmentname "##TODO##">
+<!ENTITY companyaddress1 "<street>##TODO##</street>">
+<!ENTITY companyaddress2 "<country>##TODO##</country>-<postcode>##TODO##</postcode> <city>##TODO##</city>">
+<!ENTITY copyrightyear "<year>2013</year>">
+<!ENTITY legalnotice "
+ <para>
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ </para>
+ <para role='center'>
+ http://www.apache.org/licenses/LICENSE-2.0
+ </para>
+ <para>
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+ </para>">
+
+
+
+
\ No newline at end of file
diff --git a/user-docs/src/docbkx/resources/css/apache.css b/user-docs/src/docbkx/resources/css/apache.css
new file mode 100644
index 0000000..3c089e4
--- /dev/null
+++ b/user-docs/src/docbkx/resources/css/apache.css
@@ -0,0 +1,374 @@
+/*
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership. The
+ ASF licenses this file to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance with the
+ License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable
+ law or agreed to in writing, software distributed under the License is
+ distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the specific
+ language governing permissions and limitations under the License.
+*/
+/* General formatting */
+html {
+ padding-right: 0px;
+ padding-left: 0px;
+ padding-bottom: 0px;
+ margin: 0px;
+ color: #333333;
+ padding-top: 0px;
+ font-family: Arial, Helvetica, sans-serif;
+ border: dotted 0px red;
+}
+
+body {
+ font-size: 12px;
+ font-family: Arial, Helvetica, sans-serif;
+ color: #333333;
+ background: #FFFFFF;
+ border: dotted 0px blue;
+ height: auto;
+ overflow: auto;
+ margin-top: 0px;
+ margin-left: 0px;
+ margin-right: 0px;
+ padding-right: 0px;
+ padding-left: 0px;
+ padding-bottom: 0px;
+ padding-top: 0px;
+}
+
+a,
+a:link,
+a:active {
+ color: #003399;
+ text-decoration: underline;
+}
+
+a:visited {
+ color: #991B00;
+ text-decoration: underline;
+}
+
+a:hover {
+ color: #6699FF;
+ text-decoration: underline;
+}
+
+a.navigation {
+ text-decoration: none;
+ color: #333333;
+}
+
+a.navigation:hover {
+ text-decoration: underline;
+ background-color: transparent;
+ color: #003399;
+}
+
+table {
+ margin-bottom: 8;
+ margin-top: 2;
+}
+
+table.admon {
+ width: 500px;
+ border: 1px solid #333333;
+ margin-left: 150px;
+ margin-right: 150px;
+ margin-bottom: 10px;
+ margin-top: 10px;
+ vertical-align: top;
+ background-color: #F0F0F0;
+}
+
+td {
+ font-family: Arial, Helvetica, sans-serif;
+ font-size: 12px;
+}
+
+td.name {
+ width: 25%;
+}
+
+td.desc {
+ width: 75%;
+}
+
+img {
+ border: none;
+ margin-bottom: 1px;
+ margin-left: 1px;
+ margin-right: 1px;
+ margin-top: 1px;
+}
+
+pre.screen {
+ background: #F0F0F0;
+ width: 700px;
+ padding-bottom: 2px;
+ padding-left: 2px;
+ padding-right: 2px;
+ padding-top: 2px;
+ margin-left: 10px;
+}
+
+pre.programlisting {
+ background: #F0F0F0;
+ border: thin dashed;
+ width: 800px;
+ padding-bottom: 5px;
+ padding-left: 5px;
+ padding-right: 5px;
+ padding-top: 5px;
+ margin-left: 40px;
+}
+
+code.replaceable {
+ font-style: normal;
+ font-weight: bolder;
+}
+
+DIV.example-output {
+ padding-left: 15px;
+ border-style: solid;
+ border-width: 0px;
+ border-left-width: 2px;
+ border-color: black;
+}
+
+div.example-source {
+ background: #F0F0F0;
+}
+
+div.refentry div.titlepage {
+ margin-left: 20px;
+}
+
+div.refentry div.titlepage h1.title {
+ margin-left: -20px;
+ margin-bottom: 0px;
+ font-size: 36pt;
+}
+
+div.biblioentry .title,
+div.bibliography .subtitle {
+ font-size: 12px;
+ font-family: Arial, Helvetica, sans-serif;
+ color: #333333;
+}
+
+div.table,
+div.informaltable {
+ padding-left: 10px;
+}
+
+div.navheader {
+ padding-top: 0px;
+ background-color: #F4F4F4;
+ padding-left: 10px;
+ padding-right: 10px;
+ font-weight: bold;
+ color: #333333;
+ text-decoration: none;
+ border-bottom: 1px solid black;
+ margin-bottom: 10px;
+ padding-bottom: 0px;
+}
+
+div.navfooter {
+ background-color: #F4F4F4;
+ border-top: 1px solid black;
+ margin-top: 10px;
+ padding-top: 0px;
+ margin-bottom: 0px;
+ padding-bottom: 0px;
+ padding-left: 10px;
+ padding-right: 10px;
+ font-size: 9px;
+ color: #8B8B8B;
+ text-decoration: none;
+}
+
+div.copyrightfooter {
+ background-color: #c6bec6;
+ margin-top: 0px;
+ padding-top: 0px;
+ padding-left: 10px;
+ padding-right: 10px;
+ padding-bottom: 2px;
+}
+
+div.copyrightfooter p {
+ margin-top: 0px;
+ padding-top: 10px;
+}
+
+div.refentry,
+div.preface,
+div.chapter,
+div.appendix,
+div.reference,
+div.part,
+div.bibliography,
+div.glossary,
+div.index,
+div.colophon,
+div.legalnotice,
+div.sect1,
+div.sect2,
+div.sect3,
+div.section
+ {
+ margin-left: 10px;
+ margin-right: 10px;
+}
+
+div.book {
+ margin-left: 10px;
+ margin-right: 10px;
+ margin-top: 5px;
+}
+
+p {
+ max-width: 800px;
+ font-size: 12px;
+}
+
+p.publisher {
+ text-align: center;
+}
+
+.company {
+ font-size: 9px;
+ color: #DF0141;
+ text-decoration: none
+}
+
+.contact {
+ font-size: 11px;
+ color: #0000CC;
+ text-decoration: none
+}
+
+.copy {
+ color: #BEBEBE;
+ text-decoration: none
+}
+
+.legal {
+ color: #8B8B8B;
+ text-decoration: none
+}
+
+.subtitle {
+ color: #990000;
+ font-weight: bold;
+ text-decoration: none;
+
+ border: 1px solid #aaaaaa;
+ background-color: #dddddd;
+}
+
+.title {
+ font-size: 16px;
+ color: #990000;
+ font-weight: bold;
+ text-decoration: none;
+
+ border: 1px solid #999999;
+ background-color: #eeeeee;
+}
+
+.epigraph {
+ font-style: italic;
+ text-align: right;
+}
+
+.topnav {
+ font-weight: bold;
+ color: #333333;
+ text-decoration: none;
+}
+
+.topnav:Hover {
+ font-weight: bold;
+ color: #333333;
+ text-decoration: none
+}
+
+.topnav:Visited {
+ font-weight: bold;
+ color: #333333
+}
+
+.copyright {
+ color: #7F7F7F;
+ font-size: 9px;
+}
+
+/* Navigation header formatting */
+.navheadtitle {
+ font-weight: bold;
+ font-size: 14px color : #333333;
+ text-decoration: none;
+ margin-top: 5px;
+ margin-bottom: 2px;
+}
+
+.navheadsubtitle {
+ font-weight: normal;
+ font-size: 10px color : #333333;
+ text-decoration: none;
+ margin-bottom: 2px;
+}
+
+.navhead hr.top-nav-sep {
+ display: none;
+}
+
+.navhead .slidestitle {
+ font-weight: normal;
+ font-size: 10pt;
+ font-style: italic;
+}
+
+/* Navigation footer formatting */
+.navfoot {
+ font-size: 9px;
+ color: #8B8B8B;
+ text-decoration: none;
+ border-top: 1px solid black;
+ margin-top: 10px;
+ padding-top: 4px;
+}
+
+.navfoot hr.bottom-nav-sep {
+ display: none;
+}
+
+/* General navigation formatting */
+.link-text {
+ font-weight: bold;
+ font-size: 10pt;
+}
+
+.link-text a {
+ text-decoration: none;
+}
+
+.link-text a:link {
+ color: blue;
+}
+
+.link-text a:visited {
+ color: blue;
+}
+
+.no-link-text {
+ color: #7F7F7F;
+}
+/* EOF */
\ No newline at end of file
diff --git a/user-docs/src/docbkx/resources/css/highlight.css b/user-docs/src/docbkx/resources/css/highlight.css
new file mode 100644
index 0000000..3044487
--- /dev/null
+++ b/user-docs/src/docbkx/resources/css/highlight.css
Binary files differ
diff --git a/user-docs/src/docbkx/resources/css/html.css b/user-docs/src/docbkx/resources/css/html.css
new file mode 100644
index 0000000..9cfdbf5
--- /dev/null
+++ b/user-docs/src/docbkx/resources/css/html.css
@@ -0,0 +1,16 @@
+/*
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership. The
+ ASF licenses this file to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance with the
+ License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable
+ law or agreed to in writing, software distributed under the License is
+ distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the specific
+ language governing permissions and limitations under the License.
+*/
+@IMPORT url("apache.css");
+@IMPORT url("highlight.css");
diff --git a/user-docs/src/docbkx/resources/images/admons/blank.png b/user-docs/src/docbkx/resources/images/admons/blank.png
new file mode 100644
index 0000000..764bf4f
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/admons/blank.png
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/admons/caution.gif b/user-docs/src/docbkx/resources/images/admons/caution.gif
new file mode 100644
index 0000000..d9f5e5b
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/admons/caution.gif
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/admons/caution.png b/user-docs/src/docbkx/resources/images/admons/caution.png
new file mode 100644
index 0000000..549c472
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/admons/caution.png
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/admons/caution.tif b/user-docs/src/docbkx/resources/images/admons/caution.tif
new file mode 100644
index 0000000..b727be8
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/admons/caution.tif
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/admons/draft.png b/user-docs/src/docbkx/resources/images/admons/draft.png
new file mode 100644
index 0000000..0084708
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/admons/draft.png
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/admons/home.gif b/user-docs/src/docbkx/resources/images/admons/home.gif
new file mode 100644
index 0000000..5bd0760
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/admons/home.gif
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/admons/home.png b/user-docs/src/docbkx/resources/images/admons/home.png
new file mode 100644
index 0000000..cbb711d
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/admons/home.png
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/admons/important.gif b/user-docs/src/docbkx/resources/images/admons/important.gif
new file mode 100644
index 0000000..6795d9a
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/admons/important.gif
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/admons/important.png b/user-docs/src/docbkx/resources/images/admons/important.png
new file mode 100644
index 0000000..bf67f22
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/admons/important.png
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/admons/important.tif b/user-docs/src/docbkx/resources/images/admons/important.tif
new file mode 100644
index 0000000..4da159d
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/admons/important.tif
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/admons/next.gif b/user-docs/src/docbkx/resources/images/admons/next.gif
new file mode 100644
index 0000000..7e1c777
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/admons/next.gif
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/admons/next.png b/user-docs/src/docbkx/resources/images/admons/next.png
new file mode 100644
index 0000000..45835bf
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/admons/next.png
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/admons/note.gif b/user-docs/src/docbkx/resources/images/admons/note.gif
new file mode 100644
index 0000000..f329d35
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/admons/note.gif
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/admons/note.png b/user-docs/src/docbkx/resources/images/admons/note.png
new file mode 100644
index 0000000..bf67f22
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/admons/note.png
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/admons/note.tif b/user-docs/src/docbkx/resources/images/admons/note.tif
new file mode 100644
index 0000000..4da159d
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/admons/note.tif
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/admons/prev.gif b/user-docs/src/docbkx/resources/images/admons/prev.gif
new file mode 100644
index 0000000..2cb2319
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/admons/prev.gif
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/admons/prev.png b/user-docs/src/docbkx/resources/images/admons/prev.png
new file mode 100644
index 0000000..cf24654
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/admons/prev.png
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/admons/tip.gif b/user-docs/src/docbkx/resources/images/admons/tip.gif
new file mode 100644
index 0000000..823f2b4
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/admons/tip.gif
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/admons/tip.png b/user-docs/src/docbkx/resources/images/admons/tip.png
new file mode 100644
index 0000000..bf67f22
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/admons/tip.png
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/admons/tip.tif b/user-docs/src/docbkx/resources/images/admons/tip.tif
new file mode 100644
index 0000000..4da159d
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/admons/tip.tif
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/admons/toc-blank.png b/user-docs/src/docbkx/resources/images/admons/toc-blank.png
new file mode 100644
index 0000000..6ffad17
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/admons/toc-blank.png
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/admons/toc-minus.png b/user-docs/src/docbkx/resources/images/admons/toc-minus.png
new file mode 100644
index 0000000..abbb020
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/admons/toc-minus.png
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/admons/toc-plus.png b/user-docs/src/docbkx/resources/images/admons/toc-plus.png
new file mode 100644
index 0000000..941312c
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/admons/toc-plus.png
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/admons/up.gif b/user-docs/src/docbkx/resources/images/admons/up.gif
new file mode 100644
index 0000000..333b5e3
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/admons/up.gif
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/admons/up.png b/user-docs/src/docbkx/resources/images/admons/up.png
new file mode 100644
index 0000000..07634de
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/admons/up.png
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/admons/warning.gif b/user-docs/src/docbkx/resources/images/admons/warning.gif
new file mode 100644
index 0000000..3adf191
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/admons/warning.gif
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/admons/warning.png b/user-docs/src/docbkx/resources/images/admons/warning.png
new file mode 100644
index 0000000..549c472
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/admons/warning.png
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/admons/warning.tif b/user-docs/src/docbkx/resources/images/admons/warning.tif
new file mode 100644
index 0000000..b727be8
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/admons/warning.tif
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/asf-logo.gif b/user-docs/src/docbkx/resources/images/asf-logo.gif
new file mode 100644
index 0000000..22eb9d7
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/asf-logo.gif
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/callouts/1.png b/user-docs/src/docbkx/resources/images/callouts/1.png
new file mode 100644
index 0000000..7d47343
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/callouts/1.png
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/callouts/10.png b/user-docs/src/docbkx/resources/images/callouts/10.png
new file mode 100644
index 0000000..997bbc8
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/callouts/10.png
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/callouts/11.png b/user-docs/src/docbkx/resources/images/callouts/11.png
new file mode 100644
index 0000000..ce47dac
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/callouts/11.png
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/callouts/12.png b/user-docs/src/docbkx/resources/images/callouts/12.png
new file mode 100644
index 0000000..31daf4e
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/callouts/12.png
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/callouts/13.png b/user-docs/src/docbkx/resources/images/callouts/13.png
new file mode 100644
index 0000000..14021a8
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/callouts/13.png
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/callouts/14.png b/user-docs/src/docbkx/resources/images/callouts/14.png
new file mode 100644
index 0000000..64014b7
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/callouts/14.png
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/callouts/15.png b/user-docs/src/docbkx/resources/images/callouts/15.png
new file mode 100644
index 0000000..0d65765
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/callouts/15.png
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/callouts/2.png b/user-docs/src/docbkx/resources/images/callouts/2.png
new file mode 100644
index 0000000..5d09341
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/callouts/2.png
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/callouts/3.png b/user-docs/src/docbkx/resources/images/callouts/3.png
new file mode 100644
index 0000000..ef7b700
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/callouts/3.png
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/callouts/4.png b/user-docs/src/docbkx/resources/images/callouts/4.png
new file mode 100644
index 0000000..adb8364
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/callouts/4.png
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/callouts/5.png b/user-docs/src/docbkx/resources/images/callouts/5.png
new file mode 100644
index 0000000..4d7eb46
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/callouts/5.png
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/callouts/6.png b/user-docs/src/docbkx/resources/images/callouts/6.png
new file mode 100644
index 0000000..0ba694a
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/callouts/6.png
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/callouts/7.png b/user-docs/src/docbkx/resources/images/callouts/7.png
new file mode 100644
index 0000000..472e96f
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/callouts/7.png
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/callouts/8.png b/user-docs/src/docbkx/resources/images/callouts/8.png
new file mode 100644
index 0000000..5e60973
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/callouts/8.png
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/callouts/9.png b/user-docs/src/docbkx/resources/images/callouts/9.png
new file mode 100644
index 0000000..a0676d2
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/callouts/9.png
Binary files differ
diff --git a/user-docs/src/docbkx/resources/images/river.png b/user-docs/src/docbkx/resources/images/river.png
new file mode 100644
index 0000000..2f5af02
--- /dev/null
+++ b/user-docs/src/docbkx/resources/images/river.png
Binary files differ
diff --git a/user-docs/src/docbkx/resources/xsl/customcommon/en.xml b/user-docs/src/docbkx/resources/xsl/customcommon/en.xml
new file mode 100644
index 0000000..3bde095
--- /dev/null
+++ b/user-docs/src/docbkx/resources/xsl/customcommon/en.xml
@@ -0,0 +1,31 @@
+<?xml version="1.0" encoding="UTF-8"?>
+ <!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership. The
+ ASF licenses this file to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance with the
+ License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable
+ law or agreed to in writing, software distributed under the License is
+ distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the specific
+ language governing permissions and limitations under the License.
+ -->
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
+
+ <xsl:param name="local.l10n.xml" select="document('')"/>
+ <l:i18n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0">
+ <l:l10n language="en">
+ <l:context name="xref">
+ <l:template name="page.citation" text=" (p. %p)"/>
+ </l:context>
+ <l:context name="glossary">
+ <l:template name="see" text="see %t"/>
+ <l:template name="seealso" text="See also %t"/>
+ </l:context>
+ </l:l10n>
+ </l:i18n>
+
+</xsl:stylesheet>
\ No newline at end of file
diff --git a/user-docs/src/docbkx/resources/xsl/customhtml/admon.xsl b/user-docs/src/docbkx/resources/xsl/customhtml/admon.xsl
new file mode 100644
index 0000000..01de5cf
--- /dev/null
+++ b/user-docs/src/docbkx/resources/xsl/customhtml/admon.xsl
@@ -0,0 +1,80 @@
+<?xml version="1.0" encoding="UTF-8"?>
+ <!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership. The
+ ASF licenses this file to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance with the
+ License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable
+ law or agreed to in writing, software distributed under the License is
+ distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the specific
+ language governing permissions and limitations under the License.
+ -->
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
+
+ <xsl:template match="*" mode="admon.graphic.width">
+ <xsl:param name="node" select="."/>
+ <xsl:text>40</xsl:text>
+ </xsl:template>
+
+ <xsl:template name="graphical.admonition">
+ <xsl:variable name="admon.type">
+ <xsl:choose>
+ <xsl:when test="local-name(.)='note'">Note</xsl:when>
+ <xsl:when test="local-name(.)='warning'">Warning</xsl:when>
+ <xsl:when test="local-name(.)='caution'">Caution</xsl:when>
+ <xsl:when test="local-name(.)='tip'">Tip</xsl:when>
+ <xsl:when test="local-name(.)='important'">Important</xsl:when>
+ <xsl:otherwise>Note</xsl:otherwise>
+ </xsl:choose>
+ </xsl:variable>
+ <xsl:variable name="alt">
+ <xsl:call-template name="gentext">
+ <xsl:with-param name="key" select="$admon.type"/>
+ </xsl:call-template>
+ </xsl:variable>
+ <div class="{name(.)}">
+ <xsl:if test="$admon.style != ''">
+ <xsl:attribute name="style">
+ <xsl:value-of select="$admon.style"/>
+ </xsl:attribute>
+ </xsl:if>
+ <table border="0" class="admon">
+ <xsl:attribute name="summary">
+ <xsl:value-of select="$admon.type"/>
+ <xsl:if test="title">
+ <xsl:text>: </xsl:text>
+ <xsl:value-of select="title"/>
+ </xsl:if>
+ </xsl:attribute>
+ <tr>
+ <td rowspan="2" align="center" valign="top">
+ <xsl:attribute name="width">
+ <xsl:apply-templates select="." mode="admon.graphic.width"/>
+ </xsl:attribute>
+ <img alt="[{$alt}]">
+ <xsl:attribute name="src">
+ <xsl:call-template name="admon.graphic"/>
+ </xsl:attribute>
+ </img>
+ </td>
+ <th align="left">
+ <xsl:call-template name="anchor"/>
+ <xsl:if test="$admon.textlabel != 0 or title">
+ <xsl:apply-templates select="." mode="object.title.markup"/>
+ </xsl:if>
+ </th>
+ </tr>
+ <tr>
+ <td align="left" valign="top">
+ <xsl:apply-templates/>
+ </td>
+ </tr>
+ </table>
+ </div>
+ </xsl:template>
+
+</xsl:stylesheet>
diff --git a/user-docs/src/docbkx/resources/xsl/customhtml/autoidx.xsl b/user-docs/src/docbkx/resources/xsl/customhtml/autoidx.xsl
new file mode 100644
index 0000000..a8bb09a
--- /dev/null
+++ b/user-docs/src/docbkx/resources/xsl/customhtml/autoidx.xsl
@@ -0,0 +1,131 @@
+<?xml version="1.0" encoding="UTF-8"?>
+ <!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership. The
+ ASF licenses this file to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance with the
+ License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable
+ law or agreed to in writing, software distributed under the License is
+ distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the specific
+ language governing permissions and limitations under the License.
+ -->
+<!DOCTYPE xsl:stylesheet [
+
+<!ENTITY lowercase "'abcdefghijklmnopqrstuvwxyz'">
+<!ENTITY uppercase "'ABCDEFGHIJKLMNOPQRSTUVWXYZ'">
+
+<!ENTITY primary 'normalize-space(concat(primary/@sortas, primary[not(@sortas)]))'>
+<!ENTITY secondary 'normalize-space(concat(secondary/@sortas, secondary[not(@sortas)]))'>
+<!ENTITY tertiary 'normalize-space(concat(tertiary/@sortas, tertiary[not(@sortas)]))'>
+
+<!ENTITY section '(ancestor-or-self::set
+ |ancestor-or-self::book
+ |ancestor-or-self::part
+ |ancestor-or-self::reference
+ |ancestor-or-self::partintro
+ |ancestor-or-self::chapter
+ |ancestor-or-self::appendix
+ |ancestor-or-self::preface
+ |ancestor-or-self::article
+ |ancestor-or-self::section
+ |ancestor-or-self::sect1
+ |ancestor-or-self::sect2
+ |ancestor-or-self::sect3
+ |ancestor-or-self::sect4
+ |ancestor-or-self::sect5
+ |ancestor-or-self::refentry
+ |ancestor-or-self::refsect1
+ |ancestor-or-self::refsect2
+ |ancestor-or-self::refsect3
+ |ancestor-or-self::simplesect
+ |ancestor-or-self::bibliography
+ |ancestor-or-self::glossary
+ |ancestor-or-self::index
+ |ancestor-or-self::webpage)[last()]'>
+
+<!ENTITY section.id 'generate-id(§ion;)'>
+<!ENTITY sep '" "'>
+<!ENTITY scope 'count(ancestor::node()|$scope) = count(ancestor::node())
+ and ($role = @role or $type = @type or
+ (string-length($role) = 0 and string-length($type) = 0))'>
+]>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
+
+ <xsl:key name="letter" match="indexterm"
+ use="translate(substring(&primary;, 1, 1),&lowercase;,&uppercase;)"/>
+
+ <xsl:key name="primary" match="indexterm" use="&primary;"/>
+
+ <xsl:key name="secondary" match="indexterm"
+ use="concat(&primary;, &sep;, &secondary;)"/>
+
+ <xsl:key name="tertiary" match="indexterm"
+ use="concat(&primary;, &sep;, &secondary;, &sep;, &tertiary;)"/>
+
+ <xsl:key name="endofrange" match="indexterm[@class='endofrange']" use="@startref"/>
+
+ <xsl:key name="primary-section" match="indexterm[not(secondary) and not(see)]"
+ use="concat(&primary;, &sep;, §ion.id;)"/>
+
+ <xsl:key name="secondary-section" match="indexterm[not(tertiary) and not(see)]"
+ use="concat(&primary;, &sep;, &secondary;, &sep;, §ion.id;)"/>
+
+ <xsl:key name="tertiary-section" match="indexterm[not(see)]"
+ use="concat(&primary;, &sep;, &secondary;, &sep;, &tertiary;, &sep;, §ion.id;)"/>
+
+ <xsl:key name="see-also" match="indexterm[seealso]"
+ use="concat(&primary;, &sep;, &secondary;, &sep;, &tertiary;, &sep;, seealso)"/>
+
+ <xsl:key name="see" match="indexterm[see]"
+ use="concat(&primary;, &sep;, &secondary;, &sep;, &tertiary;, &sep;, see)"/>
+
+ <xsl:key name="sections" match="*[@id]" use="@id"/>
+
+ <xsl:template match="indexterm" mode="reference">
+ <xsl:param name="scope" select="."/>
+ <xsl:param name="role" select="''"/>
+ <xsl:param name="type" select="''"/>
+ <xsl:param name="separator" select="', '"/>
+
+ <xsl:value-of select="$separator"/>
+ <xsl:choose>
+ <xsl:when test="@zone and string(@zone)">
+ <xsl:call-template name="reference">
+ <xsl:with-param name="zones" select="normalize-space(@zone)"/>
+ <xsl:with-param name="scope" select="$scope"/>
+ <xsl:with-param name="role" select="$role"/>
+ <xsl:with-param name="type" select="$type"/>
+ </xsl:call-template>
+ </xsl:when>
+ <xsl:otherwise>
+ <a>
+ <xsl:variable name="title">
+ <xsl:choose>
+ <xsl:when test="§ion;/titleabbrev and $index.prefer.titleabbrev != 0">
+ <xsl:apply-templates select="§ion;" mode="titleabbrev.markup"/>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:apply-templates select="§ion;" mode="title.markup"/>
+ </xsl:otherwise>
+ </xsl:choose>
+ </xsl:variable>
+
+ <xsl:attribute name="href">
+ <xsl:call-template name="href.target">
+ <xsl:with-param name="object" select="§ion;"/>
+ <xsl:with-param name="context" select="//index[&scope;][1]"/>
+ </xsl:call-template>
+ </xsl:attribute>
+
+ <xsl:value-of select="$title"/>
+ <!-- text only -->
+ </a>
+ </xsl:otherwise>
+ </xsl:choose>
+ </xsl:template>
+
+</xsl:stylesheet>
diff --git a/user-docs/src/docbkx/resources/xsl/customhtml/component.xsl b/user-docs/src/docbkx/resources/xsl/customhtml/component.xsl
new file mode 100644
index 0000000..6dd319d
--- /dev/null
+++ b/user-docs/src/docbkx/resources/xsl/customhtml/component.xsl
@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="UTF-8"?>
+ <!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership. The
+ ASF licenses this file to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance with the
+ License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable
+ law or agreed to in writing, software distributed under the License is
+ distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the specific
+ language governing permissions and limitations under the License.
+ -->
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
+
+ <xsl:template match="chapter">
+ <div class="{name(.)}">
+ <xsl:call-template name="language.attribute"/>
+ <xsl:if test="$generate.id.attributes != 0">
+ <xsl:attribute name="id">
+ <xsl:call-template name="object.id"/>
+ </xsl:attribute>
+ </xsl:if>
+
+ <xsl:call-template name="component.separator"/>
+ <xsl:call-template name="chapter.titlepage"/>
+ <xsl:apply-templates/>
+ <xsl:variable name="toc.params">
+ <xsl:call-template name="find.path.params">
+ <xsl:with-param name="table" select="normalize-space($generate.toc)"/>
+ </xsl:call-template>
+ </xsl:variable>
+ <xsl:if test="contains($toc.params, 'toc')">
+ <xsl:call-template name="component.toc">
+ <xsl:with-param name="toc.title.p" select="contains($toc.params, 'title')"/>
+ </xsl:call-template>
+ <xsl:call-template name="component.toc.separator"/>
+ </xsl:if>
+ <xsl:call-template name="process.footnotes"/>
+ </div>
+ </xsl:template>
+
+</xsl:stylesheet>
diff --git a/user-docs/src/docbkx/resources/xsl/customhtml/highlight.xsl b/user-docs/src/docbkx/resources/xsl/customhtml/highlight.xsl
new file mode 100644
index 0000000..9a1b8c9
--- /dev/null
+++ b/user-docs/src/docbkx/resources/xsl/customhtml/highlight.xsl
@@ -0,0 +1,82 @@
+<?xml version="1.0" encoding="UTF-8"?>
+ <!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership. The
+ ASF licenses this file to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance with the
+ License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable
+ law or agreed to in writing, software distributed under the License is
+ distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the specific
+ language governing permissions and limitations under the License.
+ -->
+<xsl:stylesheet
+ xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+ xmlns:xslthl="http://xslthl.sf.net"
+ exclude-result-prefixes="xslthl"
+ version="1.0">
+
+ <xsl:template match="a/@*|img/@*|xslthl:number/@*|a|img|xslthl:number">
+ <xsl:copy>
+ <xsl:apply-templates select="@*|node()" />
+ </xsl:copy>
+ </xsl:template>
+
+ <xsl:template match='xslthl:keyword'>
+ <span class="hl-keyword">
+ <xsl:apply-templates />
+ </span>
+ </xsl:template>
+
+ <xsl:template match='xslthl:string'>
+ <span class="hl-string">
+ <xsl:apply-templates />
+ </span>
+ </xsl:template>
+
+ <xsl:template match='xslthl:comment'>
+ <span class="hl-comment">
+ <xsl:apply-templates />
+ </span>
+ </xsl:template>
+
+ <xsl:template match='xslthl:tag'>
+ <span class="hl-tag">
+ <xsl:apply-templates />
+ </span>
+ </xsl:template>
+
+ <xsl:template match='xslthl:attribute'>
+ <span class="hl-attribute">
+ <xsl:apply-templates />
+ </span>
+ </xsl:template>
+
+ <xsl:template match='xslthl:value'>
+ <span class="hl-value">
+ <xsl:apply-templates />
+ </span>
+ </xsl:template>
+
+ <xsl:template match='xslthl:html'>
+ <span class="hl-html">
+ <xsl:apply-templates />
+ </span>
+ </xsl:template>
+
+ <xsl:template match='xslthl:xslt'>
+ <span class="hl-xslt">
+ <xsl:apply-templates />
+ </span>
+ </xsl:template>
+
+ <xsl:template match='xslthl:section'>
+ <span class="hl-section">
+ <xsl:apply-templates />
+ </span>
+ </xsl:template>
+
+</xsl:stylesheet>
diff --git a/user-docs/src/docbkx/resources/xsl/customhtml/inline.xsl b/user-docs/src/docbkx/resources/xsl/customhtml/inline.xsl
new file mode 100644
index 0000000..72adde0
--- /dev/null
+++ b/user-docs/src/docbkx/resources/xsl/customhtml/inline.xsl
@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="UTF-8"?>
+ <!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership. The
+ ASF licenses this file to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance with the
+ License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable
+ law or agreed to in writing, software distributed under the License is
+ distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the specific
+ language governing permissions and limitations under the License.
+ -->
+<!DOCTYPE xsl:stylesheet [
+ <!ENTITY comment.block.parents "parent::answer|parent::appendix|parent::article|parent::bibliodiv|
+ parent::bibliography|parent::blockquote|parent::caution|parent::chapter|
+ parent::glossary|parent::glossdiv|parent::important|parent::index|
+ parent::indexdiv|parent::listitem|parent::note|parent::orderedlist|
+ parent::partintro|parent::preface|parent::procedure|parent::qandadiv|
+ parent::qandaset|parent::question|parent::refentry|parent::refnamediv|
+ parent::refsect1|parent::refsect2|parent::refsect3|parent::refsection|
+ parent::refsynopsisdiv|parent::sect1|parent::sect2|parent::sect3|parent::sect4|
+ parent::sect5|parent::section|parent::setindex|parent::sidebar|
+ parent::simplesect|parent::taskprerequisites|parent::taskrelated|
+ parent::tasksummary|parent::warning">
+]>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+ xmlns:xlink='http://www.w3.org/1999/xlink'
+ xmlns:suwl="http://nwalsh.com/xslt/ext/com.nwalsh.saxon.UnwrapLinks"
+ exclude-result-prefixes="xlink suwl"
+ version='1.0'>
+
+ <xsl:template match="database">
+ <xsl:call-template name="inline.monoseq"/>
+ </xsl:template>
+
+ <xsl:template match="replaceable" priority="1">
+ <xsl:call-template name="inline.monoseq"/>
+ </xsl:template>
+
+</xsl:stylesheet>
+
diff --git a/user-docs/src/docbkx/resources/xsl/customhtml/sections.xsl b/user-docs/src/docbkx/resources/xsl/customhtml/sections.xsl
new file mode 100644
index 0000000..694319a
--- /dev/null
+++ b/user-docs/src/docbkx/resources/xsl/customhtml/sections.xsl
@@ -0,0 +1,116 @@
+<?xml version="1.0" encoding="UTF-8"?>
+ <!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership. The
+ ASF licenses this file to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance with the
+ License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable
+ law or agreed to in writing, software distributed under the License is
+ distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the specific
+ language governing permissions and limitations under the License.
+ -->
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
+
+ <xsl:template match="section">
+ <xsl:variable name="depth" select="count(ancestor::section)+1"/>
+ <div class="{name(.)}">
+ <xsl:call-template name="language.attribute"/>
+ <xsl:call-template name="section.titlepage"/>
+ <xsl:variable name="toc.params">
+ <xsl:call-template name="find.path.params">
+ <xsl:with-param name="table" select="normalize-space($generate.toc)"/>
+ </xsl:call-template>
+ </xsl:variable>
+ <xsl:apply-templates/>
+ <!-- ToC -->
+ <xsl:if
+ test="contains($toc.params, 'toc') and $depth <= $generate.section.toc.level">
+ <xsl:call-template name="section.toc">
+ <xsl:with-param name="toc.title.p" select="contains($toc.params, 'title')"/>
+ </xsl:call-template>
+ <xsl:call-template name="section.toc.separator"/>
+ </xsl:if>
+ <xsl:call-template name="process.chunk.footnotes"/>
+ </div>
+ </xsl:template>
+
+ <xsl:template match="sect1">
+ <div class="{name(.)}">
+ <xsl:call-template name="language.attribute"/>
+ <xsl:choose>
+ <xsl:when test="@renderas = 'sect2'">
+ <xsl:call-template name="sect2.titlepage"/>
+ </xsl:when>
+ <xsl:when test="@renderas = 'sect3'">
+ <xsl:call-template name="sect3.titlepage"/>
+ </xsl:when>
+ <xsl:when test="@renderas = 'sect4'">
+ <xsl:call-template name="sect4.titlepage"/>
+ </xsl:when>
+ <xsl:when test="@renderas = 'sect5'">
+ <xsl:call-template name="sect5.titlepage"/>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:call-template name="sect1.titlepage"/>
+ </xsl:otherwise>
+ </xsl:choose>
+ <xsl:apply-templates/>
+ <!-- ToC -->
+ <xsl:variable name="toc.params">
+ <xsl:call-template name="find.path.params">
+ <xsl:with-param name="table" select="normalize-space($generate.toc)"/>
+ </xsl:call-template>
+ </xsl:variable>
+ <xsl:if
+ test="contains($toc.params, 'toc') and $generate.section.toc.level >= 1">
+ <xsl:call-template name="section.toc">
+ <xsl:with-param name="toc.title.p" select="contains($toc.params, 'title')"/>
+ </xsl:call-template>
+ <xsl:call-template name="section.toc.separator"/>
+ </xsl:if>
+ <xsl:call-template name="process.chunk.footnotes"/>
+ </div>
+ </xsl:template>
+
+
+ <xsl:template match="sect2">
+ <div class="{name(.)}">
+ <xsl:call-template name="language.attribute"/>
+ <xsl:choose>
+ <xsl:when test="@renderas = 'sect1'">
+ <xsl:call-template name="sect1.titlepage"/>
+ </xsl:when>
+ <xsl:when test="@renderas = 'sect3'">
+ <xsl:call-template name="sect3.titlepage"/>
+ </xsl:when>
+ <xsl:when test="@renderas = 'sect4'">
+ <xsl:call-template name="sect4.titlepage"/>
+ </xsl:when>
+ <xsl:when test="@renderas = 'sect5'">
+ <xsl:call-template name="sect5.titlepage"/>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:call-template name="sect2.titlepage"/>
+ </xsl:otherwise>
+ </xsl:choose>
+ <xsl:variable name="toc.params">
+ <xsl:call-template name="find.path.params">
+ <xsl:with-param name="table" select="normalize-space($generate.toc)"/>
+ </xsl:call-template>
+ </xsl:variable>
+ <xsl:if test="contains($toc.params, 'toc') and $generate.section.toc.level >= 2">
+ <xsl:call-template name="section.toc">
+ <xsl:with-param name="toc.title.p" select="contains($toc.params, 'title')"/>
+ </xsl:call-template>
+ <xsl:call-template name="section.toc.separator"/>
+ </xsl:if>
+ <xsl:apply-templates/>
+ <xsl:call-template name="process.chunk.footnotes"/>
+ </div>
+ </xsl:template>
+
+</xsl:stylesheet>
diff --git a/user-docs/src/docbkx/resources/xsl/customhtml/titlepage.xsl b/user-docs/src/docbkx/resources/xsl/customhtml/titlepage.xsl
new file mode 100644
index 0000000..db07e08
--- /dev/null
+++ b/user-docs/src/docbkx/resources/xsl/customhtml/titlepage.xsl
@@ -0,0 +1,328 @@
+<?xml version="1.0" encoding="UTF-8"?>
+ <!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership. The
+ ASF licenses this file to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance with the
+ License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable
+ law or agreed to in writing, software distributed under the License is
+ distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the specific
+ language governing permissions and limitations under the License.
+ -->
+<xsl:stylesheet
+ xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+ xmlns:exsl="http://exslt.org/common"
+ version="1.0"
+ exclude-result-prefixes="exsl">
+
+ <xsl:template name="user.header.content">
+ <xsl:param name="node" select="." />
+ <xsl:call-template name="add.header.logo"/>
+ </xsl:template>
+
+ <xsl:template name="add.header.logo">
+ <div class="navheader">
+ <table>
+ <tr>
+ <td width="20%" align="left"><img src="{$document.logo.src}" border="0" alt="{$document.logo.alt}"/></td>
+ <td width="60%"> </td>
+ <td width="20%" align="right"><img src="{$apache.logo.src}" border="0" alt="{$apache.logo.alt}"/></td>
+ </tr>
+ </table>
+ </div>
+ </xsl:template>
+
+ <xsl:template name="book.titlepage.recto">
+ <xsl:choose>
+ <xsl:when test="bookinfo/title">
+ <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="bookinfo/title" />
+ </xsl:when>
+ <xsl:when test="info/title">
+ <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="info/title" />
+ </xsl:when>
+ <xsl:when test="title">
+ <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="title" />
+ </xsl:when>
+ </xsl:choose>
+
+ <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="bookinfo/productname" />
+ <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="info/productname" />
+ <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="bookinfo/revhistory" />
+ <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="info/revhistory" />
+ <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="bookinfo/author" />
+ <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="info/author" />
+ <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="bookinfo/abstract" />
+ <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="info/abstract" />
+ <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="bookinfo/legalnotice" />
+ <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="info/legalnotice" />
+ </xsl:template>
+
+ <xsl:template name="book.titlepage">
+ <div class="titlepage">
+ <xsl:variable name="recto.content">
+ <xsl:call-template name="book.titlepage.before.recto"/>
+ <xsl:call-template name="book.titlepage.recto"/>
+ </xsl:variable>
+ <xsl:variable name="recto.elements.count">
+ <xsl:choose>
+ <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when>
+ <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')">
+ <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when>
+ <xsl:otherwise>1</xsl:otherwise>
+ </xsl:choose>
+ </xsl:variable>
+ <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)">
+ <div><xsl:copy-of select="$recto.content"/></div>
+ </xsl:if>
+ <xsl:variable name="verso.content">
+ <xsl:call-template name="book.titlepage.before.verso"/>
+ <xsl:call-template name="book.titlepage.verso"/>
+ </xsl:variable>
+ <xsl:variable name="verso.elements.count">
+ <xsl:choose>
+ <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when>
+ <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')">
+ <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when>
+ <xsl:otherwise>1</xsl:otherwise>
+ </xsl:choose>
+ </xsl:variable>
+ <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)">
+ <div><xsl:copy-of select="$verso.content"/></div>
+ </xsl:if>
+ <xsl:call-template name="book.titlepage.separator"/>
+ </div>
+ </xsl:template>
+
+ <xsl:template match="*" mode="book.titlepage.recto.mode">
+ <!-- if an element isn't found in this mode, -->
+ <!-- try the generic titlepage.mode -->
+ <xsl:apply-templates select="." mode="titlepage.mode" />
+ </xsl:template>
+
+ <xsl:template match="*" mode="book.titlepage.verso.mode">
+ <!-- if an element isn't found in this mode, -->
+ <!-- try the generic titlepage.mode -->
+ <xsl:apply-templates select="." mode="titlepage.mode" />
+ </xsl:template>
+
+ <xsl:template match="title" mode="book.titlepage.recto.auto.mode">
+ <div xsl:use-attribute-sets="book.titlepage.recto.style">
+ <xsl:call-template name="title.mainpage">
+ </xsl:call-template>
+ </div>
+ </xsl:template>
+
+ <xsl:template match="productname" mode="book.titlepage.recto.auto.mode">
+ <div xsl:use-attribute-sets="book.titlepage.recto.style">
+ <xsl:call-template name="productname.mainpage">
+ </xsl:call-template>
+ </div>
+ </xsl:template>
+
+ <xsl:template match="revhistory" mode="book.titlepage.recto.auto.mode">
+ <div xsl:use-attribute-sets="book.titlepage.recto.style">
+ <xsl:call-template name="revhistory.mainpage">
+ </xsl:call-template>
+ </div>
+ </xsl:template>
+
+ <xsl:template match="author" mode="book.titlepage.recto.auto.mode">
+ <div xsl:use-attribute-sets="book.titlepage.recto.style">
+ <xsl:call-template name="author.mainpage">
+ </xsl:call-template>
+ </div>
+ </xsl:template>
+
+ <xsl:template match="abstract" mode="book.titlepage.recto.auto.mode">
+ <div xsl:use-attribute-sets="book.titlepage.recto.style">
+ <xsl:apply-templates select="."
+ mode="book.titlepage.recto.mode" />
+ </div>
+ </xsl:template>
+
+ <xsl:template match="legalnotice" mode="book.titlepage.recto.auto.mode">
+ <div xsl:use-attribute-sets="book.titlepage.recto.style">
+ <xsl:call-template name="legalnotice.mainpage">
+ </xsl:call-template>
+ </div>
+ </xsl:template>
+
+ <xsl:template name="title.mainpage">
+ <xsl:variable name="id">
+ <xsl:choose>
+ <xsl:when test="contains(local-name(..), 'info')">
+ <xsl:call-template name="object.id">
+ <xsl:with-param name="object" select="../.."/>
+ </xsl:call-template>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:call-template name="object.id">
+ <xsl:with-param name="object" select=".."/>
+ </xsl:call-template>
+ </xsl:otherwise>
+ </xsl:choose>
+ </xsl:variable>
+ <h1 class="subtitle">
+ <a name="{$id}"/>
+ <xsl:choose>
+ <xsl:when test="$show.revisionflag != 0 and @revisionflag">
+ <span class="{@revisionflag}">
+ <xsl:apply-templates mode="titlepage.mode"/>
+ </span>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:apply-templates mode="titlepage.mode"/>
+ </xsl:otherwise>
+ </xsl:choose>
+ <xsl:if test="//bookinfo//subtitle">
+ <xsl:call-template name="gentext.space"/>
+ :
+ <xsl:call-template name="gentext.space"/>
+ <xsl:apply-templates select="//bookinfo//subtitle" mode="mainpage"/>
+ </xsl:if>
+ </h1>
+ </xsl:template>
+
+ <xsl:template match="subtitle" mode="mainpage">
+ <xsl:apply-templates mode="titlepage.mode"/>
+ </xsl:template>
+
+ <xsl:template name="revhistory.mainpage">
+ <xsl:variable name="id">
+ <xsl:call-template name="object.id"/>
+ </xsl:variable>
+ <xsl:variable name="title">
+ <xsl:call-template name="gentext">
+ <xsl:with-param name="key">RevHistory</xsl:with-param>
+ </xsl:call-template>
+ </xsl:variable>
+ <div class="{name(.)}">
+ <b>
+ <xsl:call-template name="gentext">
+ <xsl:with-param name="key" select="'RevHistory'"/>
+ </xsl:call-template>
+ </b>
+ <table border="1" cellpadding="1" cellspacing="0" width="800" summary="Revision history">
+ <tr>
+ <th align="left" valign="top">
+ <p>Version</p>
+ </th>
+ <th align="left" valign="top">
+ <p>Date</p>
+ </th>
+ <th align="left" valign="top">
+ <p>Author</p>
+ </th>
+ <th align="left" valign="top">
+ <p>Reason of modification</p>
+ </th>
+ </tr>
+
+ <xsl:apply-templates mode="titlepage.mode"/>
+ </table>
+ </div>
+ </xsl:template>
+
+ <xsl:template match="revhistory/revision" mode="titlepage.mode">
+ <xsl:variable name="revnumber" select="revnumber" />
+ <xsl:variable name="revdate" select="date" />
+ <xsl:variable name="revauthor" select="authorinitials" />
+ <xsl:variable name="revremark" select="revremark|revdescription" />
+ <tr>
+ <td align="left">
+ <p>
+ <xsl:choose>
+ <xsl:when test="$revnumber">
+ <xsl:apply-templates select="$revnumber[1]" mode="titlepage.mode" />
+ </xsl:when>
+ <xsl:otherwise>
+
+ </xsl:otherwise>
+ </xsl:choose>
+ </p>
+ </td>
+ <td align="left">
+ <p>
+ <xsl:choose>
+ <xsl:when test="$revdate[1]">
+ <xsl:apply-templates select="$revdate[1]" mode="titlepage.mode" />
+ </xsl:when>
+ <xsl:otherwise>
+
+ </xsl:otherwise>
+ </xsl:choose>
+ </p>
+ </td>
+ <td align="left">
+ <p>
+ <xsl:choose>
+ <xsl:when test="$revauthor">
+ <xsl:for-each select="$revauthor">
+ <xsl:apply-templates select="." mode="titlepage.mode" />
+ <xsl:if test="position() != last()">
+ <xsl:text>, </xsl:text>
+ </xsl:if>
+ </xsl:for-each>
+ </xsl:when>
+ <xsl:otherwise>
+
+ </xsl:otherwise>
+ </xsl:choose>
+ </p>
+ </td>
+ <td align="left">
+ <p>
+ <xsl:choose>
+ <xsl:when test="$revremark">
+ <xsl:apply-templates select="$revremark[1]" mode="titlepage.mode" />
+ </xsl:when>
+ <xsl:otherwise>
+
+ </xsl:otherwise>
+ </xsl:choose>
+ </p>
+ </td>
+ </tr>
+ </xsl:template>
+
+ <xsl:template name="productname.mainpage">
+ <p class="{name(.)}">
+ This document is part of the
+ <xsl:apply-templates mode="titlepage.mode" />
+ <xsl:call-template name="gentext.space" />
+ <xsl:if test="//bookinfo//productnumber">
+ <xsl:apply-templates select="//bookinfo//productnumber" />
+ </xsl:if>
+ <xsl:call-template name="gentext.space" />
+ release.
+ </p>
+ <br />
+ </xsl:template>
+
+ <xsl:template name="author.mainpage">
+ <div class="{name(.)}">
+ <b class="{name(.)}">Contact person:</b>
+ <xsl:call-template name="gentext.space" />
+ <xsl:call-template name="person.name" />
+ <xsl:call-template name="gentext.space" />
+ <xsl:apply-templates mode="titlepage.mode"
+ select="./email" />
+ </div>
+ </xsl:template>
+
+ <xsl:template name="legalnotice.mainpage">
+ <xsl:variable name="id">
+ <xsl:call-template name="object.id" />
+ </xsl:variable>
+ <hr />
+ <div class="copyright">
+ <a name="{$id}" />
+ <xsl:apply-templates mode="titlepage.mode" />
+ </div>
+ </xsl:template>
+
+</xsl:stylesheet>
\ No newline at end of file
diff --git a/user-docs/src/docbkx/resources/xsl/custompdf/admon.xsl b/user-docs/src/docbkx/resources/xsl/custompdf/admon.xsl
new file mode 100644
index 0000000..3c74a78
--- /dev/null
+++ b/user-docs/src/docbkx/resources/xsl/custompdf/admon.xsl
@@ -0,0 +1,96 @@
+<?xml version="1.0" encoding="UTF-8"?>
+ <!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership. The
+ ASF licenses this file to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance with the
+ License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable
+ law or agreed to in writing, software distributed under the License is
+ distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the specific
+ language governing permissions and limitations under the License.
+ -->
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+ xmlns:fo="http://www.w3.org/1999/XSL/Format"
+ version='1.0'>
+
+ <!-- === Parameter === -->
+ <!-- 1 = Admonition are presented with a generated text label such as Note or Warning -->
+ <xsl:param name="admon.textlabel" select="1"/>
+ <xsl:param name="admon.graphics" select="1"></xsl:param>
+
+ <!-- Admonition Title -->
+ <xsl:attribute-set name="admonition.title.properties">
+ <xsl:attribute name="font-size">12pt</xsl:attribute>
+ <xsl:attribute name="font-weight">bold</xsl:attribute>
+ <xsl:attribute name="hyphenate">false</xsl:attribute>
+ <xsl:attribute name="keep-with-next.within-column">always</xsl:attribute>
+ </xsl:attribute-set>
+ <!-- Admonition Block -->
+ <xsl:attribute-set name="graphical.admonition.properties">
+ <xsl:attribute name="border-style">solid</xsl:attribute>
+ <xsl:attribute name="border-right-width">thin</xsl:attribute>
+ <xsl:attribute name="border-left-width">thin</xsl:attribute>
+ <xsl:attribute name="border-top-width">thin</xsl:attribute>
+ <xsl:attribute name="border-bottom-width">thin</xsl:attribute>
+ <xsl:attribute name="border-right-color">black</xsl:attribute>
+ <xsl:attribute name="border-left-color">black</xsl:attribute>
+ <xsl:attribute name="border-top-color">black</xsl:attribute>
+ <xsl:attribute name="border-bottom-color">black</xsl:attribute>
+ <xsl:attribute name="margin-left">0.25in</xsl:attribute>
+ <xsl:attribute name="margin-right">0.25in</xsl:attribute>
+ <xsl:attribute name="space-before.optimum">1em</xsl:attribute>
+ <xsl:attribute name="space-before.minimum">0.8em</xsl:attribute>
+ <xsl:attribute name="space-before.maximum">1.2em</xsl:attribute>
+ <xsl:attribute name="space-after.optimum">1em</xsl:attribute>
+ <xsl:attribute name="space-after.minimum">0.8em</xsl:attribute>
+ <xsl:attribute name="space-after.maximum">1.2em</xsl:attribute>
+ </xsl:attribute-set>
+
+ <!-- === Template === -->
+ <xsl:template match="*" mode="admon.graphic.width">
+ <xsl:param name="node" select="."/>
+ <xsl:text>40pt</xsl:text>
+ </xsl:template>
+
+ <xsl:template name="graphical.admonition">
+ <xsl:variable name="id">
+ <xsl:call-template name="object.id"/>
+ </xsl:variable>
+ <xsl:variable name="graphic.width">
+ <xsl:apply-templates select="." mode="admon.graphic.width"/>
+ </xsl:variable>
+ <fo:block id="{$id}"
+ xsl:use-attribute-sets="graphical.admonition.properties">
+ <fo:list-block provisional-distance-between-starts="{$graphic.width} + 18pt"
+ provisional-label-separation="18pt">
+ <fo:list-item margin-top="4pt" margin-bottom="4pt" margin-left="4pt" margin-right="4pt">
+ <fo:list-item-label end-indent="label-end()">
+ <fo:block>
+ <fo:external-graphic width="auto" height="auto"
+ content-width="{$graphic.width}" >
+ <xsl:attribute name="src">
+ <xsl:call-template name="admon.graphic"/>
+ </xsl:attribute>
+ </fo:external-graphic>
+ </fo:block>
+ </fo:list-item-label>
+ <fo:list-item-body start-indent="body-start()">
+ <xsl:if test="$admon.textlabel != 0 or title">
+ <fo:block xsl:use-attribute-sets="admonition.title.properties">
+ <xsl:apply-templates select="." mode="object.title.markup"/>
+ </fo:block>
+ </xsl:if>
+ <fo:block xsl:use-attribute-sets="admonition.properties">
+ <xsl:apply-templates/>
+ </fo:block>
+ </fo:list-item-body>
+ </fo:list-item>
+ </fo:list-block>
+ </fo:block>
+ </xsl:template>
+
+</xsl:stylesheet>
diff --git a/user-docs/src/docbkx/resources/xsl/custompdf/block.xsl b/user-docs/src/docbkx/resources/xsl/custompdf/block.xsl
new file mode 100644
index 0000000..cfd5d04
--- /dev/null
+++ b/user-docs/src/docbkx/resources/xsl/custompdf/block.xsl
@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="UTF-8"?>
+ <!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership. The
+ ASF licenses this file to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance with the
+ License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable
+ law or agreed to in writing, software distributed under the License is
+ distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the specific
+ language governing permissions and limitations under the License.
+ -->
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+ xmlns:fo="http://www.w3.org/1999/XSL/Format"
+ version='1.0'>
+
+<xsl:template match="epigraph">
+ <fo:block text-align="right" margin-left="3.5cm" font-style="italic">
+ <xsl:call-template name="anchor" />
+ <xsl:apply-templates select="para|simpara|formalpara|literallayout" />
+ <xsl:if test="attribution">
+ <fo:inline>
+ <xsl:text>--</xsl:text>
+ <xsl:apply-templates select="attribution" />
+ </fo:inline>
+ </xsl:if>
+ </fo:block>
+</xsl:template>
+
+</xsl:stylesheet>
diff --git a/user-docs/src/docbkx/resources/xsl/custompdf/highlight.xsl b/user-docs/src/docbkx/resources/xsl/custompdf/highlight.xsl
new file mode 100644
index 0000000..1bfd6db
--- /dev/null
+++ b/user-docs/src/docbkx/resources/xsl/custompdf/highlight.xsl
@@ -0,0 +1,60 @@
+<?xml version="1.0" encoding="UTF-8"?>
+ <!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership. The
+ ASF licenses this file to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance with the
+ License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable
+ law or agreed to in writing, software distributed under the License is
+ distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the specific
+ language governing permissions and limitations under the License.
+ -->
+<xsl:stylesheet
+ xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+ xmlns:fo="http://www.w3.org/1999/XSL/Format"
+ xmlns:xslthl="http://xslthl.sf.net"
+ exclude-result-prefixes="xslthl"
+ version="1.0">
+
+ <xsl:template match='xslthl:keyword'>
+ <fo:inline font-weight="bold">
+ <xsl:apply-templates />
+ </fo:inline>
+ </xsl:template>
+
+ <xsl:template match='xslthl:string'>
+ <fo:inline font-weight="bold" font-style="italic">
+ <xsl:apply-templates />
+ </fo:inline>
+ </xsl:template>
+
+ <xsl:template match='xslthl:comment'>
+ <fo:inline font-style="italic" color="green">
+ <xsl:apply-templates />
+ </fo:inline>
+ </xsl:template>
+
+ <xsl:template match='xslthl:tag'>
+ <fo:inline font-weight="bold" color="Maroon">
+ <xsl:apply-templates />
+ </fo:inline>
+ </xsl:template>
+
+ <xsl:template match='xslthl:attribute'>
+ <fo:inline color="red">
+ <xsl:apply-templates />
+ </fo:inline>
+ </xsl:template>
+
+ <xsl:template match='xslthl:value'>
+ <fo:inline color="black">
+ <xsl:apply-templates />
+ </fo:inline>
+ </xsl:template>
+
+
+</xsl:stylesheet>
diff --git a/user-docs/src/docbkx/resources/xsl/custompdf/inline.xsl b/user-docs/src/docbkx/resources/xsl/custompdf/inline.xsl
new file mode 100644
index 0000000..aa8966b
--- /dev/null
+++ b/user-docs/src/docbkx/resources/xsl/custompdf/inline.xsl
@@ -0,0 +1,50 @@
+<?xml version="1.0" encoding="UTF-8"?>
+ <!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership. The
+ ASF licenses this file to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance with the
+ License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable
+ law or agreed to in writing, software distributed under the License is
+ distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the specific
+ language governing permissions and limitations under the License.
+ -->
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+ xmlns:fo="http://www.w3.org/1999/XSL/Format"
+ xmlns:xlink='http://www.w3.org/1999/xlink'
+ exclude-result-prefixes="xlink"
+ version='1.0'>
+
+ <xsl:template name="inline.boldermonoseq">
+ <xsl:param name="content">
+ <xsl:apply-templates />
+ </xsl:param>
+ <fo:inline font-style="normal" font-weight="bolder"
+ xsl:use-attribute-sets="monospace.properties">
+ <xsl:if test="@dir">
+ <xsl:attribute name="direction">
+ <xsl:choose>
+ <xsl:when test="@dir = 'ltr' or @dir = 'lro'">ltr</xsl:when>
+ <xsl:otherwise>rtl</xsl:otherwise>
+ </xsl:choose>
+ </xsl:attribute>
+ </xsl:if>
+ <xsl:copy-of select="$content" />
+ </fo:inline>
+ </xsl:template>
+
+ <xsl:template match="database">
+ <xsl:call-template name="inline.monoseq" />
+ </xsl:template>
+
+ <xsl:template match="replaceable">
+ <xsl:call-template name="inline.boldermonoseq" />
+ </xsl:template>
+
+
+</xsl:stylesheet>
+
diff --git a/user-docs/src/docbkx/resources/xsl/custompdf/pagesetup.xsl b/user-docs/src/docbkx/resources/xsl/custompdf/pagesetup.xsl
new file mode 100644
index 0000000..42d85ba
--- /dev/null
+++ b/user-docs/src/docbkx/resources/xsl/custompdf/pagesetup.xsl
@@ -0,0 +1,401 @@
+<?xml version="1.0" encoding="UTF-8"?>
+ <!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership. The
+ ASF licenses this file to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance with the
+ License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable
+ law or agreed to in writing, software distributed under the License is
+ distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the specific
+ language governing permissions and limitations under the License.
+ -->
+<xsl:stylesheet
+ xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+ xmlns:fo="http://www.w3.org/1999/XSL/Format"
+ version="1.0">
+
+ <xsl:template name="header.table">
+ <xsl:param name="pageclass" select="''" />
+ <xsl:param name="sequence" select="''" />
+ <xsl:param name="gentext-key" select="''" />
+ <!-- default is a single table style for all headers -->
+ <!-- Customize it for different page classes or sequence location -->
+ <xsl:choose>
+ <xsl:when test="$pageclass = 'index'">
+ <xsl:attribute name="margin-left">0pt</xsl:attribute>
+ </xsl:when>
+ </xsl:choose>
+ <xsl:variable name="column1">
+ <xsl:choose>
+ <xsl:when test="$double.sided = 0">1</xsl:when>
+ <xsl:when test="$sequence = 'first' or $sequence = 'odd'">1</xsl:when>
+ <xsl:otherwise>3</xsl:otherwise>
+ </xsl:choose>
+ </xsl:variable>
+ <xsl:variable name="column3">
+ <xsl:choose>
+ <xsl:when test="$double.sided = 0">3</xsl:when>
+ <xsl:when test="$sequence = 'first' or $sequence = 'odd'">3</xsl:when>
+ <xsl:otherwise>1</xsl:otherwise>
+ </xsl:choose>
+ </xsl:variable>
+ <xsl:variable name="candidate">
+ <fo:table table-layout="fixed" width="100%">
+ <xsl:call-template name="head.sep.rule">
+ <xsl:with-param name="pageclass" select="$pageclass" />
+ <xsl:with-param name="sequence" select="$sequence" />
+ <xsl:with-param name="gentext-key" select="$gentext-key" />
+ </xsl:call-template>
+ <fo:table-column column-number="1">
+ <xsl:attribute name="column-width">
+ <xsl:text>proportional-column-width(</xsl:text>
+ <xsl:call-template name="header.footer.width">
+ <xsl:with-param name="location">header</xsl:with-param>
+ <xsl:with-param name="position" select="$column1" />
+ </xsl:call-template>
+ <xsl:text>)</xsl:text>
+ </xsl:attribute>
+ </fo:table-column>
+ <fo:table-column column-number="2">
+ <xsl:attribute name="column-width">
+ <xsl:text>proportional-column-width(</xsl:text>
+ <xsl:call-template name="header.footer.width">
+ <xsl:with-param name="location">header</xsl:with-param>
+ <xsl:with-param name="position" select="2" />
+ </xsl:call-template>
+ <xsl:text>)</xsl:text>
+ </xsl:attribute>
+ </fo:table-column>
+ <fo:table-column column-number="3">
+ <xsl:attribute name="column-width">
+ <xsl:text>proportional-column-width(</xsl:text>
+ <xsl:call-template name="header.footer.width">
+ <xsl:with-param name="location">header</xsl:with-param>
+ <xsl:with-param name="position" select="$column3" />
+ </xsl:call-template>
+ <xsl:text>)</xsl:text>
+ </xsl:attribute>
+ </fo:table-column>
+ <fo:table-body>
+ <!-- header-hight (org:14pt) -->
+ <fo:table-row height="50pt">
+ <fo:table-cell text-align="left"
+ display-align="before">
+ <xsl:if test="$fop.extensions = 0">
+ <xsl:attribute name="relative-align">baseline</xsl:attribute>
+ </xsl:if>
+ <fo:block>
+ <xsl:call-template name="header.content">
+ <xsl:with-param name="pageclass" select="$pageclass" />
+ <xsl:with-param name="sequence" select="$sequence" />
+ <xsl:with-param name="position" select="'left'" />
+ <xsl:with-param name="gentext-key" select="$gentext-key" />
+ </xsl:call-template>
+ </fo:block>
+ </fo:table-cell>
+ <fo:table-cell text-align="center"
+ display-align="before">
+ <xsl:if test="$fop.extensions = 0">
+ <xsl:attribute name="relative-align">baseline</xsl:attribute>
+ </xsl:if>
+ <fo:block>
+ <xsl:call-template name="header.content">
+ <xsl:with-param name="pageclass" select="$pageclass" />
+ <xsl:with-param name="sequence" select="$sequence" />
+ <xsl:with-param name="position" select="'center'" />
+ <xsl:with-param name="gentext-key" select="$gentext-key" />
+ </xsl:call-template>
+ </fo:block>
+ </fo:table-cell>
+ <fo:table-cell text-align="right"
+ display-align="before">
+ <xsl:if test="$fop.extensions = 0">
+ <xsl:attribute name="relative-align">baseline</xsl:attribute>
+ </xsl:if>
+ <fo:block>
+ <xsl:call-template name="header.content">
+ <xsl:with-param name="pageclass" select="$pageclass" />
+ <xsl:with-param name="sequence" select="$sequence" />
+ <xsl:with-param name="position" select="'right'" />
+ <xsl:with-param name="gentext-key" select="$gentext-key" />
+ </xsl:call-template>
+ </fo:block>
+ </fo:table-cell>
+ </fo:table-row>
+ </fo:table-body>
+ </fo:table>
+ </xsl:variable>
+ <xsl:copy-of select="$candidate" />
+ </xsl:template>
+
+ <xsl:template name="header.content">
+ <xsl:param name="pageclass" select="''" />
+ <xsl:param name="sequence" select="''" />
+ <xsl:param name="position" select="''" />
+ <xsl:param name="gentext-key" select="''" />
+ <fo:block xsl:use-attribute-sets="header.title.properties">
+ <!-- sequence can be odd, even, first, blank -->
+ <!-- position can be left, center, right -->
+ <xsl:if test="$position='left'">
+ <!--
+ <xsl:apply-templates select="/" mode="title.markup" />
+ <fo:block />
+ <xsl:apply-templates select="/" mode="subtitle.markup" />
+ <fo:block />
+ -->
+ <fo:block>
+ <fo:external-graphic src="url({$document.logo.src})"
+ width="4.5cm" height="auto"
+ content-width="scale-to-fit" content-height="scale-to-fit" />
+ </fo:block>
+ <xsl:if
+ test="($pageclass !='titlepage' and $pageclass !='lot' and $sequence != 'blank')">
+ <xsl:apply-templates select="." mode="title.markup" />
+ </xsl:if>
+ </xsl:if>
+ <xsl:if test="$position='right'">
+ <fo:block>
+ <fo:external-graphic src="url({$apache.logo.src})"
+ width="4.5cm" height="auto"
+ content-width="scale-to-fit" content-height="scale-to-fit" />
+ </fo:block>
+ </xsl:if>
+ </fo:block>
+ </xsl:template>
+
+ <xsl:template name="footer.table">
+ <xsl:param name="pageclass" select="''" />
+ <xsl:param name="sequence" select="''" />
+ <xsl:param name="gentext-key" select="''" />
+ <!-- default is a single table style for all footers -->
+ <!-- Customize it for different page classes or sequence location -->
+ <xsl:choose>
+ <xsl:when test="$pageclass = 'index'">
+ <xsl:attribute name="margin-left">0pt</xsl:attribute>
+ </xsl:when>
+ </xsl:choose>
+ <xsl:variable name="column1">
+ <xsl:choose>
+ <xsl:when test="$double.sided = 0">1</xsl:when>
+ <xsl:when test="$sequence = 'first' or $sequence = 'odd'">1</xsl:when>
+ <xsl:otherwise>3</xsl:otherwise>
+ </xsl:choose>
+ </xsl:variable>
+ <xsl:variable name="column3">
+ <xsl:choose>
+ <xsl:when test="$double.sided = 0">3</xsl:when>
+ <xsl:when test="$sequence = 'first' or $sequence = 'odd'">3</xsl:when>
+ <xsl:otherwise>1</xsl:otherwise>
+ </xsl:choose>
+ </xsl:variable>
+ <xsl:variable name="candidate">
+ <fo:table table-layout="fixed" width="100%">
+ <xsl:call-template name="foot.sep.rule">
+ <xsl:with-param name="pageclass" select="$pageclass" />
+ <xsl:with-param name="sequence" select="$sequence" />
+ <xsl:with-param name="gentext-key" select="$gentext-key" />
+ </xsl:call-template>
+ <fo:table-column column-number="1">
+ <xsl:attribute name="column-width">
+ <xsl:text>proportional-column-width(</xsl:text>
+ <xsl:call-template name="header.footer.width">
+ <xsl:with-param name="location">footer</xsl:with-param>
+ <xsl:with-param name="position" select="$column1" />
+ </xsl:call-template>
+ <xsl:text>)</xsl:text>
+ </xsl:attribute>
+ </fo:table-column>
+ <fo:table-column column-number="2">
+ <xsl:attribute name="column-width">
+ <xsl:text>proportional-column-width(</xsl:text>
+ <xsl:call-template name="header.footer.width">
+ <xsl:with-param name="location">footer</xsl:with-param>
+ <xsl:with-param name="position" select="2" />
+ </xsl:call-template>
+ <xsl:text>)</xsl:text>
+ </xsl:attribute>
+ </fo:table-column>
+ <fo:table-column column-number="3">
+ <xsl:attribute name="column-width">
+ <xsl:text>proportional-column-width(</xsl:text>
+ <xsl:call-template name="header.footer.width">
+ <xsl:with-param name="location">footer</xsl:with-param>
+ <xsl:with-param name="position" select="$column3" />
+ </xsl:call-template>
+ <xsl:text>)</xsl:text>
+ </xsl:attribute>
+ </fo:table-column>
+ <fo:table-body>
+ <fo:table-row height="26pt">
+ <fo:table-cell text-align="left"
+ display-align="before">
+ <xsl:if test="$fop.extensions = 0">
+ <xsl:attribute name="relative-align">before</xsl:attribute>
+ </xsl:if>
+ <fo:block>
+ <xsl:call-template name="footer.content">
+ <xsl:with-param name="pageclass" select="$pageclass" />
+ <xsl:with-param name="sequence" select="$sequence" />
+ <xsl:with-param name="position" select="'left'" />
+ <xsl:with-param name="gentext-key" select="$gentext-key" />
+ </xsl:call-template>
+ </fo:block>
+ </fo:table-cell>
+ <fo:table-cell text-align="center" display-align="before">
+ <xsl:if test="$fop.extensions = 0">
+ <xsl:attribute name="relative-align">before</xsl:attribute>
+ </xsl:if>
+ <fo:block>
+ <xsl:call-template name="footer.content">
+ <xsl:with-param name="pageclass" select="$pageclass" />
+ <xsl:with-param name="sequence" select="$sequence" />
+ <xsl:with-param name="position" select="'center'" />
+ <xsl:with-param name="gentext-key" select="$gentext-key" />
+ </xsl:call-template>
+ </fo:block>
+ </fo:table-cell>
+ <fo:table-cell text-align="right" display-align="before">
+ <xsl:if test="$fop.extensions = 0">
+ <xsl:attribute name="relative-align">before</xsl:attribute>
+ </xsl:if>
+ <fo:block>
+ <xsl:call-template name="footer.content">
+ <xsl:with-param name="pageclass" select="$pageclass" />
+ <xsl:with-param name="sequence" select="$sequence" />
+ <xsl:with-param name="position" select="'right'" />
+ <xsl:with-param name="gentext-key" select="$gentext-key" />
+ </xsl:call-template>
+ </fo:block>
+ </fo:table-cell>
+ </fo:table-row>
+ </fo:table-body>
+ </fo:table>
+ </xsl:variable>
+ <xsl:copy-of select="$candidate" />
+ </xsl:template>
+
+ <xsl:template name="footer.content">
+ <xsl:param name="pageclass" select="''" />
+ <xsl:param name="sequence" select="''" />
+ <xsl:param name="position" select="''" />
+ <xsl:param name="gentext-key" select="''" />
+ <xsl:variable name="RevInfo">
+ <xsl:choose>
+ <xsl:when test="//revhistory/revision[1]/revnumber">
+ <xsl:text>Version </xsl:text>
+ <xsl:value-of select="//revhistory/revision[1]/revnumber" />
+ </xsl:when>
+ <xsl:otherwise>
+ <!-- nop -->
+ </xsl:otherwise>
+ </xsl:choose>
+ </xsl:variable>
+
+ <fo:block xsl:use-attribute-sets="footer.title.properties">
+ <!-- pageclass can be front, body, back -->
+ <!-- sequence can be odd, even, first, blank -->
+ <!-- position can be left, center, right -->
+ <xsl:choose>
+ <xsl:when test="$position = 'left'">
+ <xsl:value-of select="$document.copyright"/>
+ </xsl:when>
+ <xsl:when test="$position = 'center'">
+ <xsl:value-of select="$RevInfo" />
+ </xsl:when>
+ <xsl:when test="$position = 'right'">Page: <fo:page-number /></xsl:when>
+ <xsl:otherwise />
+ </xsl:choose>
+ </fo:block>
+ </xsl:template>
+ <!-- ==================================================================== -->
+
+ <xsl:template name="page.number.format">
+ <xsl:param name="element" select="local-name(.)" />
+ <xsl:param name="master-reference" select="1" />
+ </xsl:template>
+
+ <xsl:template name="initial.page.number">
+ <xsl:param name="element" select="local-name(.)"/>
+ <xsl:param name="master-reference" select="''"/>
+ <xsl:choose>
+ <!-- double-sided output -->
+ <xsl:when test="$double.sided != 0">
+ <xsl:choose>
+ <xsl:when test="$element = 'toc'">auto-odd</xsl:when>
+ <xsl:when test="$element = 'book'">1</xsl:when>
+ <xsl:when test="$element = 'preface'">auto-odd</xsl:when>
+ <xsl:when test="$element = 'part' and not(preceding::chapter) and not(preceding::part)">auto-odd</xsl:when>
+ <xsl:when test="($element = 'dedication' or $element = 'article') and
+ not(preceding::chapter or preceding::preface or
+ preceding::appendix or preceding::article or
+ preceding::dedication or parent::part or
+ parent::reference)">auto-odd</xsl:when>
+ <xsl:when test="($element = 'chapter' or $element = 'appendix') and
+ not(preceding::chapter or preceding::appendix or
+ preceding::article or preceding::dedication or
+ parent::part or parent::reference)">auto-odd</xsl:when>
+ <xsl:otherwise>auto-odd</xsl:otherwise>
+ </xsl:choose>
+ </xsl:when>
+ <!-- single-sided output -->
+ <xsl:otherwise>
+ <xsl:choose>
+ <xsl:when test="$element = 'toc'">auto</xsl:when>
+ <xsl:when test="$element = 'book'">1</xsl:when>
+ <xsl:when test="$element = 'preface'">auto</xsl:when>
+ <xsl:when test="$element = 'part' and not(preceding::chapter) and
+ not(preceding::part)">auto</xsl:when>
+ <xsl:when test="($element = 'dedication' or $element = 'article') and
+ not(preceding::chapter or preceding::preface or
+ preceding::appendix or preceding::article or
+ preceding::dedication or parent::part or
+ parent::reference)">auto</xsl:when>
+ <xsl:when test="($element = 'chapter' or $element = 'appendix') and
+ not(preceding::chapter or preceding::appendix or
+ preceding::article or preceding::dedication or
+ parent::part or parent::reference)">auto</xsl:when>
+ <xsl:otherwise>auto</xsl:otherwise>
+ </xsl:choose>
+ </xsl:otherwise>
+ </xsl:choose>
+ </xsl:template>
+
+ <xsl:template name="force.page.count">
+ <xsl:param name="element" select="local-name(.)" />
+ <xsl:param name="master-reference" select="''" />
+ <xsl:choose>
+ <!-- double-sided output -->
+ <xsl:when test="$double.sided != 0">end-on-even</xsl:when>
+ <!-- single-sided output -->
+ <xsl:otherwise>no-force</xsl:otherwise>
+ </xsl:choose>
+ </xsl:template>
+
+ <xsl:template name="set.flow.properties">
+ <xsl:param name="element" select="local-name(.)" />
+ <xsl:param name="master-reference" select="''" />
+ <!-- This template is called after each <fo:flow> starts. -->
+ <!-- Customize this template to set attributes on fo:flow -->
+ <xsl:choose>
+ <xsl:when test="$fop.extensions != 0 or $passivetex.extensions != 0">
+ <!-- body.start.indent does not work well with these processors -->
+ </xsl:when>
+ <xsl:when
+ test="$master-reference = 'body' or $master-reference = 'lot' or
+ $master-reference = 'front' or $element = 'preface' or
+ ($master-reference = 'back' and $element = 'appendix')">
+ <xsl:attribute name="start-indent">
+ <xsl:value-of select="$body.start.indent" />
+ </xsl:attribute>
+ <xsl:attribute name="end-indent">
+ <xsl:value-of select="$body.end.indent" />
+ </xsl:attribute>
+ </xsl:when>
+ </xsl:choose>
+ </xsl:template>
+ <!-- ==================================================================== -->
+</xsl:stylesheet>
diff --git a/user-docs/src/docbkx/resources/xsl/custompdf/table.xsl b/user-docs/src/docbkx/resources/xsl/custompdf/table.xsl
new file mode 100644
index 0000000..7319a83
--- /dev/null
+++ b/user-docs/src/docbkx/resources/xsl/custompdf/table.xsl
@@ -0,0 +1,51 @@
+<?xml version="1.0" encoding="UTF-8"?>
+ <!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership. The
+ ASF licenses this file to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance with the
+ License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable
+ law or agreed to in writing, software distributed under the License is
+ distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the specific
+ language governing permissions and limitations under the License.
+ -->
+<xsl:stylesheet
+ xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+ xmlns:fo="http://www.w3.org/1999/XSL/Format"
+ version="1.0">
+
+ <xsl:template name="table.row.properties">
+
+ <xsl:variable name="tabstyle">
+ <xsl:call-template name="tabstyle" />
+ </xsl:variable>
+
+ <xsl:variable name="bgcolor">
+ <xsl:call-template name="dbfo-attribute">
+ <xsl:with-param name="pis" select="processing-instruction('dbfo')" />
+ <xsl:with-param name="attribute" select="'bgcolor'" />
+ </xsl:call-template>
+ </xsl:variable>
+
+ <xsl:variable name="rownum">
+ <xsl:number from="tgroup" count="row" />
+ </xsl:variable>
+
+ <xsl:choose>
+ <xsl:when test="$bgcolor != ''">
+ <xsl:attribute name="background-color">
+ <xsl:value-of select="$bgcolor" />
+ </xsl:attribute>
+ </xsl:when>
+ <xsl:when test="$tabstyle = 'striped'">
+ <xsl:if test="$rownum mod 2 = 0">
+ <xsl:attribute name="background-color">#EFEFEF</xsl:attribute>
+ </xsl:if>
+ </xsl:when>
+ </xsl:choose>
+ </xsl:template>
+</xsl:stylesheet>
\ No newline at end of file
diff --git a/user-docs/src/docbkx/resources/xsl/custompdf/titlepage.xsl b/user-docs/src/docbkx/resources/xsl/custompdf/titlepage.xsl
new file mode 100644
index 0000000..87948cc
--- /dev/null
+++ b/user-docs/src/docbkx/resources/xsl/custompdf/titlepage.xsl
@@ -0,0 +1,409 @@
+<?xml version="1.0" encoding="UTF-8"?>
+ <!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership. The
+ ASF licenses this file to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance with the
+ License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable
+ law or agreed to in writing, software distributed under the License is
+ distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the specific
+ language governing permissions and limitations under the License.
+ -->
+<xsl:stylesheet
+ xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+ xmlns:exsl="http://exslt.org/common"
+ version="1.0"
+ exclude-result-prefixes="exsl">
+
+ <xsl:template name="book.titlepage.recto">
+ <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="bookinfo/productname" />
+ <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="info/productname" />
+ <xsl:choose>
+ <xsl:when test="bookinfo/title">
+ <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="bookinfo/title" />
+ </xsl:when>
+ <xsl:when test="info/title">
+ <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="info/title" />
+ </xsl:when>
+ <xsl:when test="title">
+ <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="title" />
+ </xsl:when>
+ </xsl:choose>
+
+ <xsl:choose>
+ <xsl:when test="bookinfo/subtitle">
+ <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="bookinfo/subtitle" />
+ </xsl:when>
+ <xsl:when test="info/subtitle">
+ <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="info/subtitle" />
+ </xsl:when>
+ <xsl:when test="subtitle">
+ <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="subtitle" />
+ </xsl:when>
+ </xsl:choose>
+
+ <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="bookinfo/address" />
+ <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="info/address" />
+ <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="bookinfo/legalnotice" />
+ <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="info/legalnotice" />
+ <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="bookinfo/edition" />
+ <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="info/edition" />
+ </xsl:template>
+
+ <xsl:template name="book.titlepage.verso">
+ <xsl:apply-templates mode="book.titlepage.verso.auto.mode" select="bookinfo/productname" />
+ <xsl:apply-templates mode="book.titlepage.verso.auto.mode" select="info/productname" />
+ <xsl:apply-templates mode="book.titlepage.verso.auto.mode" select="bookinfo/abstract" />
+ <xsl:apply-templates mode="book.titlepage.verso.auto.mode" select="info/abstract" />
+ <xsl:apply-templates mode="book.titlepage.verso.auto.mode" select="bookinfo/revhistory" />
+ <xsl:apply-templates mode="book.titlepage.verso.auto.mode" select="info/revhistory" />
+ </xsl:template>
+
+ <xsl:template name="book.titlepage">
+ <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format">
+ <xsl:variable name="recto.content">
+ <xsl:call-template name="book.titlepage.before.recto" />
+ <xsl:call-template name="book.titlepage.recto" />
+ </xsl:variable>
+ <xsl:variable name="recto.elements.count">
+ <xsl:choose>
+ <xsl:when test="function-available('exsl:node-set')">
+ <xsl:value-of select="count(exsl:node-set($recto.content)/*)" />
+ </xsl:when>
+ <xsl:otherwise>1</xsl:otherwise>
+ </xsl:choose>
+ </xsl:variable>
+ <xsl:if
+ test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)">
+ <fo:block>
+ <xsl:copy-of select="$recto.content" />
+ </fo:block>
+ </xsl:if>
+ <xsl:variable name="verso.content">
+ <xsl:call-template name="book.titlepage.before.verso" />
+ <xsl:call-template name="book.titlepage.verso" />
+ </xsl:variable>
+ <xsl:variable name="verso.elements.count">
+ <xsl:choose>
+ <xsl:when test="function-available('exsl:node-set')">
+ <xsl:value-of select="count(exsl:node-set($verso.content)/*)" />
+ </xsl:when>
+ <xsl:otherwise>1</xsl:otherwise>
+ </xsl:choose>
+ </xsl:variable>
+ <xsl:if
+ test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)">
+ <fo:block>
+ <xsl:copy-of select="$verso.content" />
+ </fo:block>
+ </xsl:if>
+ <xsl:call-template name="book.titlepage.separator" />
+ </fo:block>
+ </xsl:template>
+
+ <xsl:template match="*" mode="book.titlepage.recto.mode">
+ <!-- if an element isn't found in this mode, -->
+ <!-- try the generic titlepage.mode -->
+ <xsl:apply-templates select="." mode="titlepage.mode" />
+ </xsl:template>
+
+ <xsl:template match="*" mode="book.titlepage.verso.mode">
+ <!-- if an element isn't found in this mode, -->
+ <!-- try the generic titlepage.mode -->
+ <xsl:apply-templates select="." mode="titlepage.mode" />
+ </xsl:template>
+
+ <xsl:template match="productname"
+ mode="book.titlepage.recto.auto.mode">
+ <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"
+ xsl:use-attribute-sets="book.titlepage.recto.style" margin-top="30px"
+ text-align="right" font-size="22pt" font-weight="normal"
+ font-family="{$title.fontset}">
+ <xsl:apply-templates select="."
+ mode="book.titlepage.recto.mode" />
+ </fo:block>
+ </xsl:template>
+
+ <xsl:template match="title" mode="book.titlepage.recto.auto.mode">
+ <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"
+ xsl:use-attribute-sets="book.titlepage.recto.style"
+ text-align="right" font-size="24pt" space-before="40pt"
+ font-weight="bold" font-family="{$title.fontset}">
+ <xsl:call-template name="division.title">
+ <xsl:with-param name="node"
+ select="ancestor-or-self::book[1]" />
+ </xsl:call-template>
+ </fo:block>
+ </xsl:template>
+
+ <xsl:template match="subtitle"
+ mode="book.titlepage.recto.auto.mode">
+ <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"
+ xsl:use-attribute-sets="book.titlepage.recto.style"
+ text-align="right" font-size="20pt" font-weight="normal"
+ font-family="{$title.fontset}">
+ <xsl:apply-templates select="."
+ mode="book.titlepage.recto.mode" />
+ </fo:block>
+ </xsl:template>
+
+ <xsl:attribute-set name="book.titlepage.recto.address.style" />
+ <xsl:template match="address"
+ mode="book.titlepage.recto.auto.mode">
+ <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"
+ xsl:use-attribute-sets="book.titlepage.recto.address.style">
+ <xsl:apply-templates select="."
+ mode="book.titlepage.recto.mode" />
+ </fo:block>
+ </xsl:template>
+ <xsl:template match="address" mode="book.titlepage.recto.mode">
+ <xsl:apply-templates />
+ </xsl:template>
+
+ <xsl:template match="legalnotice"
+ mode="book.titlepage.recto.auto.mode">
+ <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"
+ xsl:use-attribute-sets="book.titlepage.recto.style" text-align="left"
+ font-size="8pt" space-before="18pt" font-weight="normal"
+ font-family="{$body.fontset}" border-bottom-width="0.5pt"
+ border-bottom-style="solid" border-bottom-color="black"
+ border-top-width="0.5pt" border-top-style="solid"
+ border-top-color="black">
+ <xsl:apply-templates select="."
+ mode="book.titlepage.recto.mode" />
+ </fo:block>
+ </xsl:template>
+
+ <xsl:template match="edition"
+ mode="book.titlepage.recto.auto.mode">
+ <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"
+ xsl:use-attribute-sets="book.titlepage.recto.style">
+ <xsl:call-template name="book.recto.edition">
+ </xsl:call-template>
+ </fo:block>
+ </xsl:template>
+
+ <xsl:template match="productname"
+ mode="book.titlepage.verso.auto.mode">
+ <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"
+ xsl:use-attribute-sets="book.titlepage.verso.style">
+ <xsl:call-template name="book.verso.productname">
+ </xsl:call-template>
+ </fo:block>
+ </xsl:template>
+
+ <xsl:template match="abstract"
+ mode="book.titlepage.verso.auto.mode">
+ <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"
+ xsl:use-attribute-sets="book.titlepage.verso.style">
+ <xsl:apply-templates select="."
+ mode="book.titlepage.verso.mode" />
+ </fo:block>
+ </xsl:template>
+
+ <xsl:template match="revhistory"
+ mode="book.titlepage.verso.auto.mode">
+ <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"
+ xsl:use-attribute-sets="book.titlepage.verso.style">
+ <xsl:call-template name="book.verso.revhistory">
+ </xsl:call-template>
+ </fo:block>
+ </xsl:template>
+
+ <xsl:template name="book.recto.edition">
+ </xsl:template>
+
+ <xsl:template match="bookinfo/author" mode="docinfo">
+ <fo:table-row xmlns:fo="http://www.w3.org/1999/XSL/Format">
+ <fo:table-cell>
+ <fo:block> </fo:block>
+ </fo:table-cell>
+ <fo:table-cell>
+ <fo:block> </fo:block>
+ </fo:table-cell>
+ </fo:table-row>
+ <fo:table-row xmlns:fo="http://www.w3.org/1999/XSL/Format">
+ <fo:table-cell>
+ <fo:block text-align="left" font-size="11pt"
+ font-weight="normal" font-family="{$body.fontset}">
+ Contact Person
+ </fo:block>
+ </fo:table-cell>
+ <fo:table-cell>
+ <fo:block text-align="left" font-size="11pt"
+ font-weight="normal" font-family="{$body.fontset}">
+ <xsl:call-template name="anchor" />
+ <xsl:call-template name="person.name" />
+ </fo:block>
+ </fo:table-cell>
+ </fo:table-row>
+ <xsl:if test="email|affiliation/address/email">
+ <fo:table-row
+ xmlns:fo="http://www.w3.org/1999/XSL/Format">
+ <fo:table-cell>
+ <fo:block> </fo:block>
+ </fo:table-cell>
+ <fo:table-cell>
+ <fo:block text-align="left" font-size="11pt"
+ font-weight="normal" font-family="{$body.fontset}">
+ <xsl:apply-templates
+ select="(email|affiliation/address/email)[1]" />
+ </fo:block>
+ </fo:table-cell>
+ </fo:table-row>
+ </xsl:if>
+ </xsl:template>
+
+ <xsl:template match="bookinfo/pubdate|info/pubdate"
+ mode="titlepage.mode" priority="2">
+ <xsl:apply-templates mode="titlepage.mode" />
+ </xsl:template>
+
+ <xsl:template name="book.verso.productname">
+ <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format">
+ <fo:block xsl:use-attribute-sets="formal.title.properties"
+ keep-with-next.within-column="always">
+ Purpose and scope of this document
+ </fo:block>
+ <fo:block>
+ This document is part of the
+ <xsl:apply-templates mode="titlepage.mode" />
+ <xsl:call-template name="gentext.space" />
+ <xsl:if test="//productnumber">
+ <xsl:apply-templates select="//productnumber" />
+ </xsl:if>
+ <xsl:call-template name="gentext.space" />
+ release.
+ </fo:block>
+ </fo:block>
+ </xsl:template>
+
+ <xsl:template match="abstract" mode="titlepage.mode">
+ <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format">
+ <fo:block xsl:use-attribute-sets="formal.title.properties"
+ keep-with-next.within-column="always">
+ <xsl:apply-templates select="." mode="title.markup" />
+ </fo:block>
+ <xsl:apply-templates mode="titlepage.mode" />
+ </fo:block>
+ </xsl:template>
+
+ <xsl:template name="book.verso.revhistory">
+ <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format">
+ <fo:block xsl:use-attribute-sets="formal.title.properties"
+ keep-with-next.within-column="always">
+ Version control
+ </fo:block>
+ <fo:block>
+ This document is updated continuously. Major
+ modifications on content or size will lead to new
+ release numbers, whereas textual revisions are reflected
+ as new level numbers. The following list shows the
+ document's history.
+ </fo:block>
+ </fo:block>
+
+ <xsl:if test="revision">
+ <fo:table xmlns:fo="http://www.w3.org/1999/XSL/Format"
+ table-layout="fixed" width="16cm" space-before="8.25pt"
+ border-width="0.5pt" border-style="solid" border-color="black">
+ <fo:table-column column-number="1" column-width="2cm" />
+ <fo:table-column column-number="2" column-width="3cm" />
+ <fo:table-column column-number="3" column-width="4cm" />
+ <fo:table-column column-number="4" column-width="7.5cm" />
+
+ <fo:table-header background-color="#E0E0E0">
+ <fo:table-row background-color="#E0E0E0">
+ <fo:table-cell padding="2pt">
+ <fo:block text-align="left" font-size="11pt"
+ font-weight="bold">
+ Version
+ </fo:block>
+ </fo:table-cell>
+ <fo:table-cell padding="2pt">
+ <fo:block text-align="left" font-size="11pt"
+ font-weight="bold">
+ Date
+ </fo:block>
+ </fo:table-cell>
+ <fo:table-cell padding="2pt">
+ <fo:block text-align="left" font-size="11pt"
+ font-weight="bold">
+ Author
+ </fo:block>
+ </fo:table-cell>
+ <fo:table-cell padding="2pt">
+ <fo:block text-align="left" font-size="11pt"
+ font-weight="bold">
+ Reason of modification
+ </fo:block>
+ </fo:table-cell>
+ </fo:table-row>
+ </fo:table-header>
+
+ <fo:table-body start-indent="0pt" end-indent="0pt">
+ <xsl:apply-templates select="."
+ mode="book.verso.revhistory" />
+ </fo:table-body>
+ </fo:table>
+ </xsl:if>
+ </xsl:template>
+
+ <xsl:template match="revision" mode="book.verso.revhistory">
+ <xsl:variable name="revnumber" select="revnumber" />
+ <xsl:variable name="revdate" select="date" />
+ <xsl:variable name="revauthor" select="authorinitials" />
+ <xsl:variable name="revremark" select="revremark|revdescription" />
+
+ <fo:table-row xmlns:fo="http://www.w3.org/1999/XSL/Format"
+ border-width="0.5pt" border-style="solid" border-color="black"
+ >
+
+ <xsl:if test="(position() mod 2) = 0">
+ <xsl:attribute name="background-color">#EFEFEF</xsl:attribute>
+ </xsl:if>
+
+ <fo:table-cell padding="2pt">
+ <fo:block text-align="left" font-size="11pt"
+ font-weight="normal" font-family="{$body.fontset}">
+ <xsl:if test="$revnumber">
+ <xsl:apply-templates select="$revnumber[1]" mode="titlepage.mode" />
+ </xsl:if>
+ </fo:block>
+ </fo:table-cell>
+ <fo:table-cell padding="2pt">
+ <fo:block text-align="left" font-size="11pt"
+ font-weight="normal" font-family="{$body.fontset}">
+ <xsl:if test="$revdate">
+ <xsl:apply-templates select="$revdate[1]" mode="titlepage.mode" />
+ </xsl:if>
+ </fo:block>
+ </fo:table-cell>
+ <fo:table-cell padding="2pt">
+ <fo:block text-align="left" font-size="11pt"
+ font-weight="normal" font-family="{$body.fontset}">
+
+ <xsl:for-each select="$revauthor">
+ <xsl:apply-templates select="." mode="titlepage.mode" />
+ <xsl:if test="position() != last()">
+ <xsl:text>, </xsl:text>
+ </xsl:if>
+ </xsl:for-each>
+ </fo:block>
+ </fo:table-cell>
+ <fo:table-cell padding="2pt">
+ <fo:block text-align="left" font-size="11pt"
+ font-weight="normal" font-family="{$body.fontset}">
+ <xsl:if test="$revremark">
+ <xsl:apply-templates select="$revremark[1]" mode="titlepage.mode" />
+ </xsl:if>
+ </fo:block>
+ </fo:table-cell>
+ </fo:table-row>
+ </xsl:template>
+
+</xsl:stylesheet>
\ No newline at end of file
diff --git a/user-docs/src/docbkx/resources/xsl/fopdf.xsl b/user-docs/src/docbkx/resources/xsl/fopdf.xsl
new file mode 100644
index 0000000..440174c
--- /dev/null
+++ b/user-docs/src/docbkx/resources/xsl/fopdf.xsl
@@ -0,0 +1,409 @@
+<?xml version="1.0" encoding="UTF-8"?>
+ <!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership. The
+ ASF licenses this file to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance with the
+ License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable
+ law or agreed to in writing, software distributed under the License is
+ distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the specific
+ language governing permissions and limitations under the License.
+ -->
+<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="urn:docbkx:stylesheet" />
+
+ <!-- ================ Header and Footer data ============== -->
+ <xsl:param name="apache.logo.src" select="concat($img.src.path, 'asf-logo.gif')" />
+ <xsl:param name="apache.logo.alt" select="'Apache Software Foundation'" />
+ <xsl:param name="document.logo.src" select="concat($img.src.path, 'river.png')" />
+ <xsl:param name="document.logo.alt" select="'Apache River Container'" />
+ <xsl:param name="document.copyright" select="'© 2013 Apache Software Foundation'" />
+
+ <!-- ================ Customization Layer =========== -->
+ <xsl:include href="custompdf/pagesetup.xsl" />
+ <xsl:include href="custompdf/admon.xsl" />
+ <xsl:include href="custompdf/block.xsl" />
+ <xsl:include href="custompdf/inline.xsl" />
+ <xsl:include href="custompdf/titlepage.xsl" />
+ <xsl:include href="custompdf/highlight.xsl" />
+
+ <!-- =============== Customized I18n ============== -->
+ <xsl:param name="local.l10n.xml" select="document('customcommon/en.xml')" />
+
+ <!-- =============== Renderer options ============== -->
+ <xsl:param name="xep.extensions" select="0" />
+
+ <xsl:attribute-set name="xep.index.item.properties">
+ <xsl:attribute name="merge-subsequent-page-numbers">true</xsl:attribute>
+ <xsl:attribute name="link-back">true</xsl:attribute>
+ </xsl:attribute-set>
+
+ <!-- FOP provide only PDF Bookmarks at the moment -->
+ <xsl:param name="fop.extensions">0</xsl:param> <!-- version 0.20.5 or earlier -->
+ <xsl:param name="fop1.extensions">1</xsl:param> <!-- version 0.93 or later -->
+
+ <!-- These extensions are required for table printing and other stuff -->
+ <xsl:param name="use.extensions">1</xsl:param>
+ <xsl:param name="tablecolumns.extension">0</xsl:param>
+ <xsl:param name="callout.extensions">1</xsl:param>
+
+ <!-- === Pagelayout === -->
+ <xsl:param name="paper.type">A4</xsl:param>
+ <xsl:param name="page.margin.inner">2.5cm</xsl:param>
+ <xsl:param name="page.margin.outer">2.5cm</xsl:param>
+ <xsl:param name="page.margin.top">0.7cm</xsl:param>
+ <xsl:param name="page.margin.bottom">0.5cm</xsl:param>
+ <xsl:param name="body.margin.top">3cm</xsl:param>
+ <xsl:param name="body.margin.bottom">1.5cm</xsl:param>
+ <xsl:param name="region.before.extent">2.3cm</xsl:param>
+ <xsl:param name="region.after.extent">1.3cm</xsl:param>
+ <xsl:param name="alignment">left</xsl:param>
+ <xsl:param name="hyphenate">true</xsl:param>
+ <xsl:attribute-set name="normal.para.spacing">
+ <xsl:attribute name="space-before.optimum">1em</xsl:attribute>
+ <xsl:attribute name="space-before.minimum">0.8em</xsl:attribute>
+ <xsl:attribute name="space-before.maximum">1.2em</xsl:attribute>
+ </xsl:attribute-set>
+ <xsl:param name="header.column.widths" select="'2 0 1'"></xsl:param>
+
+ <!-- === Indentation === -->
+ <xsl:param name="title.margin.left">
+ <xsl:choose>
+ <xsl:when test="$fop.extensions != 0">-2pt</xsl:when>
+ <xsl:when test="$passivetex.extensions != 0">0pt</xsl:when>
+ <xsl:otherwise>0pt</xsl:otherwise>
+ </xsl:choose>
+ </xsl:param>
+ <xsl:param name="body.start.indent">
+ <xsl:choose>
+ <xsl:when test="$fop.extensions != 0">0pt</xsl:when>
+ <xsl:when test="$passivetex.extensions != 0">0pt</xsl:when>
+ <xsl:otherwise>2pt</xsl:otherwise>
+ </xsl:choose>
+ </xsl:param>
+
+ <!-- === Images === -->
+ <xsl:param name="graphic.default.extension">.png</xsl:param>
+ <xsl:param name="default.image.width">15.5cm</xsl:param>
+ <xsl:param name="keep.relative.image.uris">1</xsl:param>
+
+ <!-- === Call Outs === -->
+ <xsl:param name="callout.graphics" select="'1'"></xsl:param>
+ <xsl:param name="callout.graphics.extension">.png</xsl:param>
+
+ <!-- === Admons === -->
+ <xsl:param name="admon.graphics.extension">.png</xsl:param>
+
+ <!-- === Index === -->
+ <xsl:param name="generate.index" select="1"></xsl:param>
+ <xsl:param name="make.index.markup" select="0"></xsl:param>
+ <xsl:attribute-set name="index.div.title.properties">
+ <xsl:attribute name="margin-left">0pt</xsl:attribute>
+ <xsl:attribute name="font-size">16pt</xsl:attribute>
+ <xsl:attribute name="font-family"><xsl:value-of select="$title.fontset"></xsl:value-of></xsl:attribute>
+ <xsl:attribute name="font-weight">bold</xsl:attribute>
+ <xsl:attribute name="keep-with-next.within-column">always</xsl:attribute>
+ <xsl:attribute name="space-before.minimum"><xsl:value-of select="concat($body.font.master,'pt * 0.8')"></xsl:value-of></xsl:attribute>
+ <xsl:attribute name="space-before.optimum"><xsl:value-of select="concat($body.font.master,'pt * 1.2')"></xsl:value-of></xsl:attribute>
+ <xsl:attribute name="space-after.minimum"><xsl:value-of select="concat($body.font.master,'pt * 0.6')"></xsl:value-of></xsl:attribute>
+ <xsl:attribute name="space-after.optimum"><xsl:value-of select="concat($body.font.master,'pt * 0.8')"></xsl:value-of></xsl:attribute>
+ <xsl:attribute name="start-indent">0pt</xsl:attribute>
+ </xsl:attribute-set>
+ <xsl:attribute-set name="index.entry.properties">
+ <xsl:attribute name="start-indent">0pt</xsl:attribute>
+ <xsl:attribute name="font-size">10pt</xsl:attribute>
+ </xsl:attribute-set>
+
+ <!-- === Enumeration and autolabel === -->
+ <xsl:param name="section.autolabel" select="1" />
+ <!--
+ 1 Arabic numeration (1, 2, 3 ...).
+ A or upperalpha Uppercase letter numeration (A, B, C ...).
+ a or loweralpha Lowercase letter numeration (a, b, c ...).
+ I or upperroman Uppercase roman numeration (I, II, III ...).
+ i or lowerroman Lowercase roman letter numeration (i, ii, iii ...).
+ -->
+ <xsl:param name="chapter.autolabel" select="1" />
+ <xsl:param name="section.label.includes.component.label" select="1" />
+ <xsl:param name="label.from.part" select="0" />
+ <xsl:param name="component.label.includes.part.label" select="0" />
+ <!-- === Line deviding header and ruler from textbody === -->
+ <xsl:param name="header.rule" select="1" />
+ <xsl:param name="footer.rule" select="1" />
+
+ <!-- === Header === -->
+ <xsl:attribute-set name="header.content.properties">
+ <xsl:attribute name="font-family">
+ <xsl:value-of select="$body.fontset"></xsl:value-of>
+ </xsl:attribute>
+ <xsl:attribute name="font-weight">bold</xsl:attribute>
+ <xsl:attribute name="font-variant">small-caps</xsl:attribute>
+ <xsl:attribute name="font-size">11pt</xsl:attribute>
+ <xsl:attribute name="margin-left">
+ <xsl:value-of select="$title.margin.left"></xsl:value-of>
+ </xsl:attribute>
+ </xsl:attribute-set>
+
+ <!-- === Footer === -->
+ <xsl:attribute-set name="footer.content.properties">
+ <xsl:attribute name="font-family">
+ <xsl:value-of select="$body.fontset"></xsl:value-of>
+ </xsl:attribute>
+ <xsl:attribute name="font-size">10pt</xsl:attribute>
+ <xsl:attribute name="margin-left">
+ <xsl:value-of select="$title.margin.left"></xsl:value-of>
+ </xsl:attribute>
+ </xsl:attribute-set>
+
+ <!-- === Glossary === -->
+ <xsl:param name="glossentry.show.acronym" select="'primary'"></xsl:param>
+
+ <!-- === Refentry === -->
+ <xsl:param name="refentry.generate.name" select="0"></xsl:param>
+ <xsl:param name="refentry.generate.title" select="1"></xsl:param>
+ <xsl:param name="refentry.pagebreak" select="1"></xsl:param>
+
+ <!-- === Varlist === -->
+ <xsl:param name="variablelist.max.termlength">20</xsl:param>
+ <xsl:param name="variablelist.as.blocks" select="1"></xsl:param>
+
+ <!-- === Tables === -->
+ <xsl:attribute-set name="table.cell.padding">
+ <xsl:attribute name="padding-left">2pt</xsl:attribute>
+ <xsl:attribute name="padding-right">2pt</xsl:attribute>
+ <xsl:attribute name="padding-top">2pt</xsl:attribute>
+ <xsl:attribute name="padding-bottom">2pt</xsl:attribute>
+ </xsl:attribute-set>
+ <xsl:attribute-set name="informal.object.properties">
+ <xsl:attribute name="space-before.minimum">0.5em</xsl:attribute>
+ <xsl:attribute name="space-before.optimum">1em</xsl:attribute>
+ <xsl:attribute name="space-before.maximum">2em</xsl:attribute>
+ <xsl:attribute name="space-after.minimum">0.5em</xsl:attribute>
+ <xsl:attribute name="space-after.optimum">1em</xsl:attribute>
+ <xsl:attribute name="space-after.maximum">2em</xsl:attribute>
+ <xsl:attribute name="keep-together.within-line">always</xsl:attribute>
+ </xsl:attribute-set>
+ <xsl:attribute-set name="formal.object.properties">
+ <xsl:attribute name="space-before.minimum">0.5em</xsl:attribute>
+ <xsl:attribute name="space-before.optimum">1em</xsl:attribute>
+ <xsl:attribute name="space-before.maximum">2em</xsl:attribute>
+ <xsl:attribute name="space-after.minimum">0.5em</xsl:attribute>
+ <xsl:attribute name="space-after.optimum">1em</xsl:attribute>
+ <xsl:attribute name="space-after.maximum">2em</xsl:attribute>
+ <xsl:attribute name="keep-together.within-line">always</xsl:attribute>
+ </xsl:attribute-set>
+
+ <!-- === ULink === -->
+ <xsl:param name="ulink.footnotes" select="0"></xsl:param>
+ <xsl:param name="ulink.show" select="1"></xsl:param>
+
+ <!-- === XREF === -->
+ <xsl:param name="insert.xref.page.number">
+ yes
+ </xsl:param>
+ <!-- Make xrefs and links blue -->
+ <xsl:attribute-set name="xref.properties">
+ <xsl:attribute name="color">
+ <xsl:if test="local-name() = 'link'
+ or local-name() = 'olink'
+ or local-name() = 'ulink'
+ or local-name() = 'xref'">
+ blue
+ </xsl:if>
+ </xsl:attribute>
+ </xsl:attribute-set>
+
+ <!-- === Fonts === -->
+ <xsl:param name="body.font.family" select="'sans-serif'" />
+ <xsl:param name="title.font.family" select="'sans-serif'" />
+ <xsl:param name="monospace.font.family" select="'monospace'" />
+ <xsl:param name="body.font.master">11</xsl:param>
+ <xsl:param name="body.font.size">
+ <xsl:value-of select="$body.font.master" />
+ <xsl:text>pt</xsl:text>
+ </xsl:param>
+ <xsl:param name="footnote.font.size">9pt</xsl:param>
+
+ <!-- === Font-Styles === -->
+ <xsl:attribute-set name="color.properties">
+<!-- <xsl:attribute name="color">#990000</xsl:attribute>-->
+ </xsl:attribute-set>
+ <xsl:attribute-set name="admonition.title.properties" use-attribute-sets="color.properties"></xsl:attribute-set>
+ <xsl:attribute-set name="index.div.title.properties" use-attribute-sets="color.properties"></xsl:attribute-set>
+ <xsl:attribute-set name="refentry.title.properties" use-attribute-sets="color.properties"></xsl:attribute-set>
+ <xsl:attribute-set name="formal.title.properties" use-attribute-sets="color.properties"></xsl:attribute-set>
+ <xsl:attribute-set name="sidebar.title.properties" use-attribute-sets="color.properties"></xsl:attribute-set>
+ <xsl:attribute-set name="margin.note.title.properties" use-attribute-sets="color.properties"></xsl:attribute-set>
+ <xsl:attribute-set name="component.title.properties" use-attribute-sets="color.properties"></xsl:attribute-set>
+ <xsl:attribute-set name="article.appendix.title.properties" use-attribute-sets="color.properties"></xsl:attribute-set>
+ <xsl:attribute-set name="abstract.title.properties" use-attribute-sets="color.properties"></xsl:attribute-set>
+ <xsl:attribute-set name="revhistory.title.properties" use-attribute-sets="color.properties"></xsl:attribute-set>
+ <xsl:attribute-set name="section.title.properties" use-attribute-sets="color.properties"></xsl:attribute-set>
+ <xsl:attribute-set name="header.title.properties" use-attribute-sets="color.properties"></xsl:attribute-set>
+ <xsl:attribute-set name="footer.title.properties" use-attribute-sets="color.properties"></xsl:attribute-set>
+ <!-- Component titles -->
+ <xsl:attribute-set name="component.title.properties" use-attribute-sets="color.properties">
+ <xsl:attribute name="keep-with-next.within-column">always</xsl:attribute>
+ <xsl:attribute name="font-size">
+ <xsl:value-of select="$body.font.master * 2"></xsl:value-of>
+ <xsl:text>pt</xsl:text>
+ </xsl:attribute>
+ <xsl:attribute name="space-before.optimum">14pt</xsl:attribute>
+ <xsl:attribute name="space-before.minimum">12pt</xsl:attribute>
+ <xsl:attribute name="space-before.maximum">14pt</xsl:attribute>
+ <xsl:attribute name="space-after.optimum">
+ <xsl:choose>
+ <xsl:when test="parent::book or parent::part or parent::article or parent::chapter">140pt</xsl:when>
+ <xsl:otherwise>24pt</xsl:otherwise>
+ </xsl:choose>
+ </xsl:attribute>
+ <xsl:attribute name="space-after.minimum">
+ <xsl:choose>
+ <xsl:when test="parent::book or parent::part or parent::article">80pt</xsl:when>
+ <xsl:otherwise>16pt</xsl:otherwise>
+ </xsl:choose>
+ </xsl:attribute>
+ <xsl:attribute name="space-after.maximum">
+ <xsl:choose>
+ <xsl:when test="parent::book or parent::part or parent::article">160pt</xsl:when>
+ <xsl:otherwise>30pt</xsl:otherwise>
+ </xsl:choose>
+ </xsl:attribute>
+ <xsl:attribute name="hyphenate">false</xsl:attribute>
+ <xsl:attribute name="text-align">left</xsl:attribute>
+ <xsl:attribute name="start-indent"><xsl:value-of select="$title.margin.left" /></xsl:attribute>
+ <xsl:attribute name="color">#990000</xsl:attribute>
+ </xsl:attribute-set>
+ <!-- section level 1 -->
+ <xsl:attribute-set name="section.title.level1.properties">
+ <xsl:attribute name="font-size">
+ <xsl:value-of select="$body.font.master * 1.454545"></xsl:value-of>
+ <xsl:text>pt</xsl:text>
+ </xsl:attribute>
+ <xsl:attribute name="font-weight">bold</xsl:attribute>
+ <xsl:attribute name="keep-with-next.within-column">always</xsl:attribute>
+ <xsl:attribute name="space-before.optimum">16pt</xsl:attribute>
+ <xsl:attribute name="space-before.minimum">12pt</xsl:attribute>
+ <xsl:attribute name="space-before.maximum">20pt</xsl:attribute>
+ <xsl:attribute name="space-after.optimum">12pt</xsl:attribute>
+ <xsl:attribute name="space-after.minimum">8pt</xsl:attribute>
+ <xsl:attribute name="space-after.maximum">16pt</xsl:attribute>
+ </xsl:attribute-set>
+ <!-- section level 2 -->
+ <xsl:attribute-set name="section.title.level2.properties">
+ <xsl:attribute name="font-size">
+ <xsl:value-of select="$body.font.master * 1.272727"></xsl:value-of>
+ <xsl:text>pt</xsl:text>
+ </xsl:attribute>
+ <xsl:attribute name="font-weight">bold</xsl:attribute>
+ <xsl:attribute name="keep-with-next.within-column">always</xsl:attribute>
+ <xsl:attribute name="space-before.optimum">14pt</xsl:attribute>
+ <xsl:attribute name="space-before.minimum">8pt</xsl:attribute>
+ <xsl:attribute name="space-before.maximum">20pt</xsl:attribute>
+ <xsl:attribute name="space-after.optimum">6pt</xsl:attribute>
+ <xsl:attribute name="space-after.minimum">4pt</xsl:attribute>
+ <xsl:attribute name="space-after.maximum">6pt</xsl:attribute>
+ </xsl:attribute-set>
+ <!-- section level 3 -->
+ <xsl:attribute-set name="section.title.level3.properties">
+ <xsl:attribute name="font-size">
+ <xsl:value-of select="$body.font.master * 1.090909"></xsl:value-of>
+ <xsl:text>pt</xsl:text>
+ </xsl:attribute>
+ <xsl:attribute name="font-weight">bold</xsl:attribute>
+ <xsl:attribute name="keep-with-next.within-column">always</xsl:attribute>
+ <xsl:attribute name="space-before.optimum">12pt</xsl:attribute>
+ <xsl:attribute name="space-before.minimum">8pt</xsl:attribute>
+ <xsl:attribute name="space-before.maximum">16pt</xsl:attribute>
+ <xsl:attribute name="space-after.optimum">6pt</xsl:attribute>
+ <xsl:attribute name="space-after.minimum">4pt</xsl:attribute>
+ <xsl:attribute name="space-after.maximum">6pt</xsl:attribute>
+ </xsl:attribute-set>
+ <!-- section level 4 -->
+ <xsl:attribute-set name="section.title.level4.properties">
+ <xsl:attribute name="font-size">
+ <xsl:value-of select="$body.font.master * 1.02"></xsl:value-of>
+ <xsl:text>pt</xsl:text>
+ </xsl:attribute>
+ <xsl:attribute name="font-weight">bold</xsl:attribute>
+ <xsl:attribute name="keep-with-next.within-column">always</xsl:attribute>
+ <xsl:attribute name="space-before.optimum">12pt</xsl:attribute>
+ <xsl:attribute name="space-before.minimum">8pt</xsl:attribute>
+ <xsl:attribute name="space-before.maximum">16pt</xsl:attribute>
+ <xsl:attribute name="space-after.optimum">6pt</xsl:attribute>
+ <xsl:attribute name="space-after.minimum">4pt</xsl:attribute>
+ <xsl:attribute name="space-after.maximum">6pt</xsl:attribute>
+ </xsl:attribute-set>
+ <!-- refentry -->
+ <xsl:attribute-set name="refentry.title.properties">
+ <xsl:attribute name="font-size">
+ <xsl:value-of select="$body.font.master * 1.8"></xsl:value-of>
+ <xsl:text>pt</xsl:text>
+ </xsl:attribute>
+ <xsl:attribute name="font-weight">bold</xsl:attribute>
+ <xsl:attribute name="font-style">italic</xsl:attribute>
+ <xsl:attribute name="keep-with-next.within-column">always</xsl:attribute>
+ <xsl:attribute name="hyphenate">false</xsl:attribute>
+ <xsl:attribute name="space-before.optimum">16pt</xsl:attribute>
+ <xsl:attribute name="space-before.minimum">12pt</xsl:attribute>
+ <xsl:attribute name="space-before.maximum">20pt</xsl:attribute>
+ <xsl:attribute name="space-after.optimum">30pt</xsl:attribute>
+ <xsl:attribute name="space-after.minimum">20pt</xsl:attribute>
+ <xsl:attribute name="space-after.maximum">40pt</xsl:attribute>
+ <xsl:attribute name="start-indent"><xsl:value-of select="$title.margin.left" /></xsl:attribute>
+ </xsl:attribute-set>
+ <!-- Verbatim text formatting (programlistings) -->
+ <xsl:attribute-set name="monospace.verbatim.properties">
+ <xsl:attribute name="font-size"><xsl:value-of
+ select="$body.font.master * 0.8333" /><xsl:text>pt</xsl:text></xsl:attribute>
+ <xsl:attribute name="space-before.minimum">1em</xsl:attribute>
+ <xsl:attribute name="space-before.optimum">1em</xsl:attribute>
+ <xsl:attribute name="space-before.maximum">1em</xsl:attribute>
+ <xsl:attribute name="border-color">#444444</xsl:attribute>
+ <xsl:attribute name="border-style">solid</xsl:attribute>
+ <xsl:attribute name="border-width">0.1pt</xsl:attribute>
+ <xsl:attribute name="padding-top">0.5em</xsl:attribute>
+ <xsl:attribute name="padding-left">0.5em</xsl:attribute>
+ <xsl:attribute name="padding-right">0.5em</xsl:attribute>
+ <xsl:attribute name="padding-bottom">0.5em</xsl:attribute>
+ <xsl:attribute name="margin-left">0.5em</xsl:attribute>
+ <xsl:attribute name="margin-right">0.5em</xsl:attribute>
+ </xsl:attribute-set>
+
+ <!-- Shade (background) programlistings -->
+ <xsl:param name="shade.verbatim">1</xsl:param>
+ <xsl:attribute-set name="shade.verbatim.style">
+ <xsl:attribute name="background-color">#F0F0F0</xsl:attribute>
+ </xsl:attribute-set>
+
+ <xsl:attribute-set name="book.titlepage.recto.address.style">
+ <xsl:attribute name="font-size"><xsl:value-of select="$body.font.master" /><xsl:text>pt</xsl:text></xsl:attribute>
+ <xsl:attribute name="font-weight">normal</xsl:attribute>
+ <xsl:attribute name="font-family"><xsl:value-of select="$body.fontset" /></xsl:attribute>
+ <xsl:attribute name="text-align">right</xsl:attribute>
+ <xsl:attribute name="space-before.minimum">1em</xsl:attribute>
+ <xsl:attribute name="space-before.optimum">1em</xsl:attribute>
+ <xsl:attribute name="space-before.maximum">1em</xsl:attribute>
+ <xsl:attribute name="space-after.minimum">1em</xsl:attribute>
+ <xsl:attribute name="space-after.optimum">1em</xsl:attribute>
+ <xsl:attribute name="space-after.maximum">1em</xsl:attribute>
+ <xsl:attribute name="hyphenate">false</xsl:attribute>
+ <xsl:attribute name="linefeed-treatment">preserve</xsl:attribute>
+ </xsl:attribute-set>
+
+ <xsl:attribute-set name="normal.para.spacing">
+ <xsl:attribute name="text-align">justify</xsl:attribute>
+ </xsl:attribute-set>
+
+ <!-- Code highlighting -->
+ <xsl:param name="highlight.source" select="1" />
+
+</xsl:stylesheet>
diff --git a/user-docs/src/docbkx/resources/xsl/html.xsl b/user-docs/src/docbkx/resources/xsl/html.xsl
new file mode 100644
index 0000000..a4bc87f
--- /dev/null
+++ b/user-docs/src/docbkx/resources/xsl/html.xsl
@@ -0,0 +1,133 @@
+<?xml version="1.0" encoding="UTF-8"?>
+ <!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership. The
+ ASF licenses this file to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance with the
+ License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable
+ law or agreed to in writing, software distributed under the License is
+ distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the specific
+ language governing permissions and limitations under the License.
+ -->
+<xsl:stylesheet
+ xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+ version="1.0">
+
+ <!-- import the docbook-stylesheet without chunking -->
+ <xsl:import href="urn:docbkx:stylesheet" />
+
+ <!-- ================ Customization Layer =========== -->
+ <!--
+ customhtml/component.xsl must be imported not included since the
+ template would not get the right priority otherwise.
+ -->
+ <xsl:import href="customhtml/component.xsl" />
+ <xsl:import href="customhtml/sections.xsl" />
+
+ <xsl:include href="customhtml/admon.xsl" />
+ <xsl:include href="customhtml/autoidx.xsl" />
+ <xsl:include href="customhtml/inline.xsl" />
+ <xsl:include href="customhtml/titlepage.xsl" />
+ <xsl:include href="customhtml/highlight.xsl" />
+
+ <!-- ================ Header and Footer data ============== -->
+ <xsl:param name="apache.logo.src" select="concat($img.src.path, 'asf-logo.gif')" />
+ <xsl:param name="apache.logo.alt" select="'Apache Software Foundation'" />
+ <xsl:param name="document.logo.src" select="concat($img.src.path, 'river.png')" />
+ <xsl:param name="document.logo.alt" select="'Apache River Container'" />
+ <xsl:param name="document.copyright" select="'© 2013 Apache Software Foundation'" />
+
+ <!-- =============== Customized I18n ============== -->
+ <xsl:param name="local.l10n.xml" select="document('customcommon/en.xml')" />
+
+ <!-- ================ Fileextension, rootname and path =========== -->
+ <xsl:param name="html.ext" select="'.html'" />
+ <xsl:param name="root.filename" select="'index'" />
+ <xsl:param name="use.id.as.filename" select="'0'" />
+
+ <!-- ================ Chunking-Level ============================= -->
+ <xsl:param name="chunk.section.depth" select="2" />
+ <!--
+ chunk.first.sections: if non-zero, first-sections will appear on their
+ own page
+ -->
+ <xsl:param name="chunk.first.sections" select="1" />
+
+ <!-- ================ CSS Stylesheet ============================= -->
+ <xsl:param name="css.decoration" select="1" />
+
+ <!-- ================ Enumeration of Sections ==================== -->
+ <xsl:param name="section.autolabel" select="1" />
+ <xsl:param name="section.label.includes.component.label" select="1" />
+
+ <!-- ================ ToC ======================================== -->
+ <xsl:param name="toc.max.depth">
+ 1
+ </xsl:param>
+ <xsl:param name="toc.section.depth">
+ 3
+ </xsl:param>
+ <xsl:param name="generate.section.toc.level" select="1" />
+
+ <!-- ================ Glossary =================================== -->
+ <xsl:param name="glossentry.show.acronym" select="'primary'" />
+ <xsl:param name="glossterm.auto.link" select="1" />
+
+ <!-- ================ Index =================================== -->
+ <xsl:param name="generate.index" select="1" />
+ <xsl:param name="index.on.type" select="0" />
+ <xsl:param name="index.on.role" select="0" />
+ <xsl:param name="index.prefer.titleabbrev" select="1" />
+
+ <!-- ================ Images ================================= -->
+ <xsl:param name="draft.mode" select="'no'" />
+ <!-- ignore scaling-options for html-output -->
+ <xsl:param name="ignore.image.scaling" select="1" />
+ <xsl:param name="graphic.default.extension" select="'.png'" />
+ <xsl:param name="draft.watermark.image" select="concat($img.src.path, 'admons/draft.png')" />
+
+ <!-- ================ Admontation ================================ -->
+ <xsl:param name="admon.graphics" select="1" />
+ <xsl:param name="admon.graphics.extension" select="'.png'" />
+ <xsl:param name="admon.graphics.path" select="concat($img.src.path, 'admons/')" />
+ <!--
+ 1 = Admontation are presented with a generated text label such as Note
+ or Warning
+ -->
+ <xsl:param name="admon.textlabel" select="1" />
+ <xsl:param name="admon.style">
+ <xsl:text><!-- no default margins; use css instead --></xsl:text>
+ </xsl:param>
+
+ <!-- ================ Callout =================================== -->
+ <xsl:param name="callout.graphics" select="'1'" />
+ <xsl:param name="callouts.extension" select="'1'" />
+ <xsl:param name="callout.graphics.extension" select="'.png'" />
+ <xsl:param name="callout.graphics.path" select="concat($img.src.path, 'callouts/')" />
+
+ <!-- ================ Refentry =================================== -->
+ <xsl:param name="refentry.generate.name" select="0" />
+ <xsl:param name="refentry.generate.title" select="1" />
+ <xsl:param name="annotate.toc" select="1" />
+
+ <!-- ================ Navigation ================================= -->
+ <xsl:param name="navig.graphics" select="1" />
+ <xsl:param name="navig.graphics.path" select="concat($img.src.path, 'admons/')" />
+ <xsl:param name="navig.graphics.extension" select="'.gif'" />
+ <xsl:param name="navig.showtitles" select="1" />
+ <xsl:param name="header.rule" select="0" />
+ <xsl:param name="footer.rule" select="0" />
+
+ <!-- ================ Tabledesign ================================ -->
+ <xsl:param name="default.table.width" select="'700'" />
+ <xsl:param name="html.cellspacing" select="'0'" />
+ <xsl:param name="html.cellpadding" select="'1'" />
+
+ <!-- Code highlighting -->
+ <xsl:param name="highlight.source" select="1" />
+
+</xsl:stylesheet>
diff --git a/user-docs/src/docbkx/userguide.xml b/user-docs/src/docbkx/userguide.xml
new file mode 100644
index 0000000..0501d5e
--- /dev/null
+++ b/user-docs/src/docbkx/userguide.xml
@@ -0,0 +1,102 @@
+<?xml version="1.0" encoding="UTF-8"?>
+ <!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership. The
+ ASF licenses this file to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance with the
+ License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable
+ law or agreed to in writing, software distributed under the License is
+ distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the specific
+ language governing permissions and limitations under the License.
+ -->
+
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+ "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+
+ <!ENTITY % entities SYSTEM "entities.ent">
+ %entities;
+]>
+
+<book lang="en"><?dbhtml dir="userguide" ?>
+ <bookinfo>
+ <title>User Guide - Apache River Container</title>
+ <subtitle>Jini - A Java-based Service Oriented Architecture</subtitle>
+ <releaseinfo><!-- State of the document -->draft</releaseinfo>
+ <edition><!-- Mandatory! Should be equal to the latest revision-number -->&productversion;</edition>
+ <authorgroup>
+ <author>
+ <firstname>Greg</firstname>
+ <surname>Trasuk</surname>
+ <affiliation>
+ <orgname>The Apache Software Foundation</orgname>
+ <orgdiv>Apache River</orgdiv>
+ </affiliation>
+ </author>
+ </authorgroup>
+ <revhistory>
+ <revision>
+ <revnumber>0.1</revnumber>
+ <date>2013/12/23</date>
+ <authorinitials>gmt</authorinitials>
+ <revremark>Initial draft</revremark>
+ </revision>
+ </revhistory>
+ <author><!-- contact person: -->
+ <firstname>Greg</firstname><surname>Trasuk</surname>
+ <email>gtrasuk at apache dot org</email>
+ </author>
+
+ <!-- Abstract -->
+ <xi:include href="common/abstract.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+ <subjectset><!-- keywords -->
+ <subject>
+ <subjectterm>Documentation</subjectterm>
+ </subject>
+ <subject>
+ <subjectterm>Reference</subjectterm>
+ </subject>
+ </subjectset>
+
+ <pubdate>&date;</pubdate>
+ <productname>&productnamecomplete;</productname>
+ <productnumber>&productversion;</productnumber>
+ <address>
+ <!-- postal address, keep line breaks -->
+ © &companyname;
+ <!--
+ &departmentname;
+ &companyaddress1;
+ &companyaddress2;
+ -->
+ </address>
+ <legalnotice>
+ &legalnotice;
+ </legalnotice>
+ <copyright>
+ <year>&year;</year>
+ <holder>&companyname;</holder>
+ </copyright>
+
+ </bookinfo>
+
+ <xi:include href="userguide/preface.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+ <xi:include href="userguide/Quickstart.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+ <xi:include href="userguide/PackagingAndDeploying.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+ <xi:include href="userguide/ConfiguringTheContainer.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+
+ <index id="chapter.index"/>
+
+</book>
diff --git a/user-docs/src/docbkx/userguide/ConfiguringTheContainer.xml b/user-docs/src/docbkx/userguide/ConfiguringTheContainer.xml
new file mode 100644
index 0000000..0edd882
--- /dev/null
+++ b/user-docs/src/docbkx/userguide/ConfiguringTheContainer.xml
@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="UTF-8"?>
+ <!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership. The
+ ASF licenses this file to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance with the
+ License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable
+ law or agreed to in writing, software distributed under the License is
+ distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the specific
+ language governing permissions and limitations under the License.
+ -->
+
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+ "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+
+ <!ENTITY % entities SYSTEM "../entities.ent">
+ %entities;
+]>
+<chapter id="chapter3">
+ <title>Using OpenWebBeans within OpenEJB</title>
+
+ <section>
+ <title>OpenWebBeans within OpenEJB</title>
+ <para>
+ TODO
+ </para>
+
+</section>
+<!-- End of SECTION What is OpenWebBeans -->
+
+</chapter>
\ No newline at end of file
diff --git a/user-docs/src/docbkx/userguide/PackagingAndDeploying.xml b/user-docs/src/docbkx/userguide/PackagingAndDeploying.xml
new file mode 100644
index 0000000..1ce34e2
--- /dev/null
+++ b/user-docs/src/docbkx/userguide/PackagingAndDeploying.xml
@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="UTF-8"?>
+ <!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership. The
+ ASF licenses this file to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance with the
+ License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable
+ law or agreed to in writing, software distributed under the License is
+ distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the specific
+ language governing permissions and limitations under the License.
+ -->
+
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+ "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+
+ <!ENTITY % entities SYSTEM "../entities.ent">
+ %entities;
+]>
+<chapter id="chapter2">
+ <title>Using OpenWebBeans within Java EE Web</title>
+
+ <!-- What is OpenWebBeans -->
+ <section>
+ <title>OpenWebBeans in 5 Minute</title>
+ <para>
+ In this part of the user guide, we will look at how to configure and use OpenWebBeans in a <emphasis>Java EE
+ Web</emphasis> projects.
+ </para>
+
+ <section>
+ <title>Simple JSP Application</title>
+ <para>TODO</para>
+ </section>
+
+ <section>
+ <title>Using with JSF</title>
+ <para>TODO</para>
+ </section>
+
+ <section>
+ <title>Using with JPA</title>
+ <para>TODO</para>
+ </section>
+
+</section>
+<!-- End of SECTION What is OpenWebBeans -->
+
+</chapter>
\ No newline at end of file
diff --git a/user-docs/src/docbkx/userguide/Quickstart.xml b/user-docs/src/docbkx/userguide/Quickstart.xml
new file mode 100644
index 0000000..40fcd50
--- /dev/null
+++ b/user-docs/src/docbkx/userguide/Quickstart.xml
@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="UTF-8"?>
+ <!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership. The
+ ASF licenses this file to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance with the
+ License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable
+ law or agreed to in writing, software distributed under the License is
+ distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the specific
+ language governing permissions and limitations under the License.
+-->
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+ "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+
+ <!ENTITY % entities SYSTEM "../entities.ent" >
+ %entities;
+]>
+
+<chapter>
+
+ <chapterinfo id="chapter.intro">
+ <keywordset>
+ <keyword>Quick Start</keyword>
+ </keywordset>
+ <authorinitials>gmt</authorinitials>
+ </chapterinfo>
+ <title>Quick Start</title>
+
+ <!-- Quick Start -->
+ <section id="quickstart">
+ <title>Apache River Container QuickStart</title>
+ <para>
+ The Apache River Container is a quick and easy way to launch services and
+ clients that conform the the Jini Technology Specification.
+ </para>
+
+ </section>
+
+
+</chapter>
\ No newline at end of file
diff --git a/user-docs/src/docbkx/userguide/preface.xml b/user-docs/src/docbkx/userguide/preface.xml
new file mode 100644
index 0000000..e9543cd
--- /dev/null
+++ b/user-docs/src/docbkx/userguide/preface.xml
@@ -0,0 +1,141 @@
+<?xml version="1.0" encoding="UTF-8"?>
+ <!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership. The
+ ASF licenses this file to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance with the
+ License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable
+ law or agreed to in writing, software distributed under the License is
+ distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the specific
+ language governing permissions and limitations under the License.
+ -->
+<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+ "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+
+ <!ENTITY % entities SYSTEM "../entities.ent" >
+ %entities;
+]>
+
+<preface>
+ <title>Preface</title>
+ <para>
+ In this guide we merged all kind of information needed to
+ configure parts of the
+ &productnamecomplete;
+ (from now on simply called
+ &productname;
+ throughout the rest of this document). A comprehensive index has
+ been provided which should help you to quickly find the
+ information you are looking for. We have also included a
+ glossary that contains explanations of terms that are mentioned
+ throughout this guide.
+ </para>
+ <para>
+ We hope that this user guide helps you to increase your
+ knowledge and understanding of
+ &productname;. We are sure that it will make development of applications
+ based on
+ &productname;
+ a lot easier for you. Feedback is always welcome.
+ </para>
+
+ <bridgehead renderas="sect2">Conventions used in this document</bridgehead>
+ <bridgehead renderas="sect3">Typography</bridgehead>
+ <para>
+ the following typographical conventions are used in this
+ document:
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <database>database</database>
+ </term>
+ <listitem>
+ <para>
+ used for database elements (tables, fields, keys,
+ views,...)
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <classname>class</classname>
+ ,
+ <interfacename>interface</interfacename>
+ ,
+ <methodname>method</methodname>
+ </term>
+ <listitem>
+ <para>
+ used for (Java) classes, interfaces and methods
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <sgmltag class="emptytag">tag</sgmltag>
+ ,
+ <sgmltag class="attribute">attribute</sgmltag>
+ ,
+ <sgmltag class="attvalue">value</sgmltag>
+ </term>
+ <listitem>
+ <para>
+ used for XML elements (tags, attributes and values)
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <property>
+ property
+ <replaceable>N</replaceable>
+ </property>
+ ,
+ <parameter>
+ parameter
+ <replaceable>N</replaceable>
+ </parameter>
+ </term>
+ <listitem>
+ <para>
+ used for property- and parameternames. The '
+ <replaceable>N</replaceable>
+ ' (or other literal) is a variable part of the name,
+ which usually stands for a running number.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <literal>value</literal>
+ </term>
+ <listitem>
+ <para>
+ used for defined values. This can be a default value
+ an example or the value of a constant.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <code>bean name="myBean"</code>
+ </term>
+ <listitem>
+ <para>used for inline sourcecode examples</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para>
+ <programlisting language="xml"><![CDATA[<bean name="beanName" class="fqn.of.the.bean">
+ <property name="beanPropertyName" ref="with its value"/>
+</bean>]]></programlisting>
+ used for longer source code examples
+ </para>
+ <note><para>Indicates a tip, suggestion or general note</para></note>
+ <warning><para>Indicates a warning</para></warning>
+</preface>
\ No newline at end of file
