Github user thijs1108 commented on the pull request:
https://github.com/apache/wicket/pull/131#issuecomment-131729424
The php scripts can be thrown away after the merge of this commits because
then the documentation should be updated in the .adoc files and not in the
.gdoc files anymore.
To start converting all the gdoc files to adoc you need to pass all the
gdoc files through the `adoccommandline.php`. `run.sh` is doing that, it's
searching all the gdoc files in guide/ and convert it to adoc format in
asciidoc/. So the first step is run `$ ./run.sh`.
The next step is that there should be one index.adoc file which include all
the other adoc files. Gdoc has toc.yml but asciidoc need a completely other
syntax. `toctoindex.php` loads guide/toc.yml and give an output that should be
index.adoc. To do that, run `$ ./toctoindex.php > asciidoc/index.adoc`.
If that's done, run `$ mvn` in `wicket-user-guide` to render index.adoc to
index.html and index.pdf with all adoc files included. In
`wicket-user-guide/target/generated-docs` is the result. Ignore the empty
directories.
I hope this will help. Thanks for your response!
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastruct...@apache.org or file a JIRA ticket
with INFRA.
---
