Awesome Asciidoctor: Collapsible Content

Posted on April 3, 2019 by

Since Asciidoctor 2.0.0 we can add the collapsible option to an example block. When the markup is generated to HTML we get a HTML details and summary section. The content of the example block is collapsed (default behaviour because it is in a details section) and a clickable text is available to open the collapsed block (the summary section), so we can see the actual content. The text we can click on is by default Details, but we can change that by setting the title of the example block. Then the title is used as the text to click on to open the collapsed content.

Continue reading →

Awesome Asciidoctor: Help On Syntax As HTML

Posted on April 1, 2019 by

Hubert Klein Ikkink

With the release of Asciidoctor 2.0.0 we get nice help on the basic syntax of Asciidoc with the command-line option --help syntax. This gives us samples of the syntax in Asciidoc markup. As mentioned by Dan Allen on Twitter we can pipe the syntax sample to Asciidoctor itself to get a HTML page:

The best part is, it's valid AsciiDoc. So you can pipe it back to the asciidoctor command to convert it:

asciidoctor --help syntax | asciidoctor -o syntax.html -

It offers a nice overview of the language and what it can do. Thanks to @Mogztter for his help on this feature!
— Dan Allen ✌️ (@mojavelinux) March 22, 2019

Continue reading →