The ServiceMix documentation project aims to build a set of manuals for ServiceMix using DocBook XML Scalate.
...
Sample output
For ServiceMix 4.3-SNAPSHOT
...
: http://servicemix.apache.org/docs/4.3.0-SNAPSHOT/
Source code
The source code for this project can be found at
- https://svn.apache.org/repos/asf/servicemix/documentation/
- git://git.apache.org/servicemix-documentation.git
Branches:/
trunk
refers to the next development version of ServiceMix (currently 4.3-SNAPSHOT)
Content can be added in two formats:
- pure DocBook XML source files go in the
src/docbkx
folder - a Confluence-alike wiki markup can be used in
src/confluence
Project layout
common
: common files (xsl, css, ...)docs
: common maven plugin setup for underlying projectsdocs/manual
: Programmer's Manualdocs/jbi
: JBI Reference Manual
Building and deploying
Prerequisites
Before being able to build and run this project, you need to download and install:
Project layout
The project is a basic Maven WAR project. Some important directories and files in the project:
src/main/webapp/commands
: TOC and index files for Console Commands manual sectionsrc/main/webapp/karaf
: TOC and index files for Karaf manual sectionsrc/main/webapp/users-guide
: The ServiceMix User's Guide sectionsrc/main/webapp/WEB-INF/scalate/layouts
: Scalate SSP templates for the site
Building and deploying
Static website and WAR
The documentation website and WAR The documentation can be built by running mvn clean install
on the documentation project. This will create and install:
target/sitegen
: a local copy of the static website- A WAR file for installing the documentation on an application server
- If Prince XML has been installed, it will also create the PDF manuals
Live website for editing
Running mvn jetty:run
in the documentation project allows you to preview the resulting website on http://localhost:8080. Just edit any page and hit refresh in the browser to have a look at the result.
Deploying a new documentation site copy
You can also deploy the site directly by running mvn sitescalate:deploy
afterwards, provided you have set up the correct credentials for people.apache.org
in ~/.m2/settings.xml
:
...
A Hudson build has been set up for trunk in http://hudson.zones.apache.org/hudson/job/ServiceMix-Docs/
Note | ||
---|---|---|
| ||
At the moment, we're unable to deploy updates to the documentation automatically from the Hudson builds. |