AsciiDoc

Jump to bottom Edit New page

Will Clinger edited this page Jul 5, 2017 · 2 revisions

We have been using asciidoc to produce Larceny's user manual.

Issues:

Will hasn't been able to get the current version of asciidoc to work with a2x.
The macro definition syntax is horrid, making macro definitions fragile.
Index. How do we format entries so we get a nice index of all of the procedures at the end of the document?
Felix was able to produce an automatic table of contents by going through the docbook build path rather than the built in html generation path, but that uses a2x, which no longer works.