[
https://issues.apache.org/jira/browse/POLYGENE-149?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Niclas Hedhman closed POLYGENE-149.
-----------------------------------
> Migrate documentation to AsciiDoctor
> ------------------------------------
>
> Key: POLYGENE-149
> URL: https://issues.apache.org/jira/browse/POLYGENE-149
> Project: Polygene
> Issue Type: Bug
> Reporter: Niclas Hedhman
> Priority: Minor
> Attachments: core.html
>
>
> AsciiDoctor is a more modern AsciiDoc processing system.
> Since most of our documentation is in AsciiDoc markdown format, this should
> be a relatively easy process.
> There is a Gradle plugin;
> http://asciidoctor.org/docs/asciidoctor-gradle-plugin/
> Hurdles;
> 1. SNIPPET support won't work as AsciiDoctor is built out of Ruby, whereas
> the old AsciiDoc toolchain is in Python. The SNIPPET plugin needs to be
> re-written, but I think it can be done in Java.
> 2. dev-status.xml processing. Same thing, something needs to be done.
> 3. At the moment a large DocBook document is generate, and then transformed
> using XSLT into a chunk per web page. It seems that the AsciiDoctor approach
> would be to generate HTML5 directly and that the "chunking" is done with the
> source files directly. Need to investigate this a bit more.
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
