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] [Resolved] (POLYGENE-149) Migrate documentation to AsciiDoctor
Date Sat, 13 May 2017 10:34:04 GMT

     [ https://issues.apache.org/jira/browse/POLYGENE-149?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel

Niclas Hedhman resolved POLYGENE-149.
    Resolution: Won't Fix

AsciiDoctor is page-oriented, and we put everything in a single book, then chunk it into smaller
pieces, and AsciiDoctor seems incapable of doing that.

Let's drop this.

> 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
> 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