Asciidoc: Difference between revisions

From miki
Jump to navigation Jump to search
Line 1: Line 1:
== References ==
== Links ==

;Reference
* [http://powerman.name/doc/asciidoc Powerman's Asciidoc Cheat sheet]
* [http://powerman.name/doc/asciidoc Powerman's Asciidoc Cheat sheet]
* [http://hyperpolyglot.org/lightweight-markup Hyperpolyglot - Markdown, reStructuredText, AsciiDoc, Mediawiki, Org-mode]

;Review
* [http://ericholscher.com/blog/2016/mar/15/dont-use-markdown-for-technical-docs/ Why You Shouldn’t Use “Markdown” for Documentation]
:This author advocates instead AsciiDoc (using [https://asciidoctor.org/ Asciidoctor]), or reStructuredText (using [http://www.sphinx-doc.org/en/stable/usage/quickstart.html Sphinx]).


== Tips ==
== Tips ==

Revision as of 06:30, 16 October 2018

Links

Reference
Review
This author advocates instead AsciiDoc (using Asciidoctor), or reStructuredText (using Sphinx).

Tips

Use Icons

By default, asciidoc does not use icons. To enable them:

asciidoc -a icons -a iconsdir=/etc/asciidoc/images/icons file.txt