GitHub user fpapon opened a pull request:
https://github.com/apache/camel/pull/2535
WIP: DOCUMENTATION generator for the user manual
This is a WIP PR concerning a proposal about the generation of the user
manual.
A pom.xml was added into the `docs` folder including :
- the css for the html generation of the documentation
(`user-manual/en/apache.css`)
- the theme for the pdf generation of the documentation (`theme`)
The theme for the html and the pdf is based on the
[ASF](https://apache.org) website.
The generation use the `asciidoctor-maven-plugin` for html and pdf.
To generate the html documentation, use the **html** maven profile :
```
$ cd docs
$ mvn -Phtml
```
The website is generated under `target/generated-html` and the main page is
`index.html`
To generate the pdf documentation, use the **pdf** maven profile :
```
$ cd docs
$ mvn -Ppdf
```
The pdf is generated under the repository `target/generated-pdf` and the
main document is `index.pdf`
You can merge this pull request into a Git repository by running:
$ git pull https://github.com/fpapon/camel website
Alternatively you can review and apply these changes as the patch at:
https://github.com/apache/camel/pull/2535.patch
To close this pull request, make a commit to your master/trunk branch
with (at least) the following in the commit message:
This closes #2535
----
commit c95cb5deb6d5cfd205a215bb1840bb910d52939a
Author: Francois Papon <fpapon@...>
Date: 2018-09-26T11:23:00Z
WIP: generator for the user manual in HTML and PDF format from asciidoc
----
---
