polygene-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Niclas Hedhman (JIRA)" <j...@apache.org>
Subject [jira] [Closed] (POLYGENE-149) Migrate documentation to AsciiDoctor
Date Sat, 28 Apr 2018 07:49:00 GMT

     [ 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

View raw message