Asciidoctor :: Discussion - Re: Recommendations for multi-page and single-page documentation

Re: Recommendations for multi-page and single-page documentation

Posted by LightGuardjp on Apr 12, 2013; 2:56pm
URL: https://discuss.asciidoctor.org/Recommendations-for-multi-page-and-single-page-documentation-tp118p119.html

That's a good question. I think the answer as it currently stands with Asciidoctor is you'll have to run it multiple times. This something we should enable in core Asciidoctor, however, I feel it would be a larger change and we'll have to discuss how it would look on the cli. My initial thoughts are to add a separate attribute for multiple output runs as we can't pass multiple -b attributes currently. Unless we do further parsing of the attribute and make it delimited, that would be an easy change to get that part. The other, I describe below is much more work (I think).

Actually now that I think about it, you would probably have to parse the docs multiple times anyway, unless we make some deep core changes to keep the ast around after we've done parsing. I'll let Dan comment once he wakes in a few hours, he may have a better idea.

—
Sent from Mailbox for iPhone

On Fri, Apr 12, 2013 at 8:45 AM, glaforge [via Asciidoctor :: Discussion] <[hidden email]> wrote:

Hi,

I'm playing with AsciiDoctor through the Gradle plugin, so I don't really yet have access to all the flags one can pass to the asciidoctor on the command-line... but hopefully, the plugin can soon expose some further configuration options -- thanks Andrés!

But I'm wondering what are the recommendations regarding outputting a big documentation in both multi-page format, and big single-page format, at the same time, hopefully without necessarily reparsing the docs twice.

Similarily, I might want to expose the documentation online on a website, but in a slightly different format standalone (in a ZIP for example). Again, does that mean parsing docs as many times as needed, to produce as many outputs with different combinations of stylesheets, javascript bits, etc?

Thanks for the advice

Guillaume

If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Recommendations-for-multi-page-and-single-page-documentation-tp118.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML