Hi DeltaSpike devs!

I'm a committer on Apache Isis [1], and thought you might like to know that
I've taken the great work you had already done on using Asciidoctor, and
extended it a little for Isis.

Our asciidoc source is at [2]; our "adocs" directory corresponds more or
less to your "documentation" directory.

This is currently published to our staging site [3]; it's published exactly
the same way that Deltaspike does.

Most of the content there is skeleton, but you might want to review how the
table-of-contents handling works for (what will become) our user guide
[4].  I'm quite pleased with how it's turned out.

Note that Asciidoctor stylesheets use Zurb Foundation rather than
Bootstrap; but porting over the template wasn't too difficult.  It should
be easy enough to link to any of the standard Asciidoctor stylesheets; I'm
using one called Colony.

Note that the templates reference local copies of stylesheets rather than
via CDN; this is to allow complete offline working/preview of changes.

Please feel free to rip off/enhance/contribute back.

Cheers
Dan

[1] http://isis.apache.org
[2] https://github.com/apache/isis/tree/master/adocs/documentation
[3] http://isis.staging.apache.org/docs/
[4] http://isis.staging.apache.org/docs/user-guide/user-guide.html

Reply via email to