Google Git
Sign in
apache / servicemix-documentation / d7ba3a8e120f1969dfe6e0f4a0c731748a5e2d6f
commitd7ba3a8e120f1969dfe6e0f4a0c731748a5e2d6f[log] [tgz]
authorGert Vanthienen <gertv@apache.org>Wed May 28 10:30:38 2014 +0000
committerGert Vanthienen <gertv@apache.org>Wed May 28 10:30:38 2014 +0000
tree53a3466192055b12481891355508e11cfce50cc9
parent4dbe0820aa079ccf0e20d28c463c09fd047c8d76 [diff]
Set up trunk for publishing to http://servicemix.apache.org/docs/6.x

git-svn-id: https://svn.apache.org/repos/asf/servicemix/documentation/trunk@1597966 13f79535-47bb-0310-9956-ffa450edef68
1 file changed
tree: 53a3466192055b12481891355508e11cfce50cc9
  1. src/
  2. .gitignore
  3. pom.xml
  4. README.md
README.md

Prerequisites

You need to have these two programs installed on your machine:

  • Pygments - syntax highlighting for HTML and PDF
  • Prince XML - converts HTML into PDF for the manual

Building the documentation project

There are two ways of building the documentation project:

  • mvn -Plive jetty:run will make a live website copy available locally. This is very convenient while editing the docs to quickly review the changes you made.
  • mvn clean install will build the documentation project, creating 3 representations:
    • a war file containing the documentation webapp
    • a pdf file (in target/sitegen/manual.pdf)
    • a static website, generated using the same templates (in target/sitegen)

Publishing the documentation to the website

If you're an Apache ServiceMix committer, you can publish a new copy of the documentation pages with this command: mvn clean install scm-publish:publish-scm

Known issues

  • The war file currently can't be deployed on ServiceMix