AsciiDoc
Lua error in package.lua at line 80: module 'strict' not found. Lua error in Module:Infobox at line 199: malformed pattern (missing ']'). Lua error in Module:Infobox at line 199: malformed pattern (missing ']'). AsciiDoc is a human-readable document format, semantically equivalent to DocBook XML, but using plain-text mark-up conventions. AsciiDoc documents can be created using any text editor and read “as-is”, or rendered to HTML or any other format supported by a DocBook tool-chain, i.e. PDF, TeX, Unix manpages, e-books, slide presentations, etc.[1]
History
AsciiDoc was created in 2002 by Stuart Rackham who published tools (‘asciidoc’ and ‘a2x’), written in the Python programming language to convert plain-text, ‘human readable’ files to commonly used published document formats.[1]
A Ruby implementation called ‘Asciidoctor’, released in 2013, is in use by GitHub[2] and also provides a gateway to Asciidoc use in the Java ecosystem.
Some of O'Reilly Media's books and e-books are authored using AsciiDoc mark-up.[3]
Most of the Git documentation is written in AsciiDoc.[4]
Example
The following shows text using AsciiDoc mark-up, and a rendering similar to that produced by an AsciiDoc processor:
Asciidoc source text |
---|
= My Article J. Smith https://infogalactic.com/[Infogalactic] is an on-line encyclopaedia, available in English and many other languages. == Software You can install 'package-name' using the +gem+ command: gem install package-name == Hardware Metals commonly used include: * copper * tin * lead |
HTML-rendered result |
---|
J. Smith Infogalactic is an on-line encyclopaedia, available in English and many other languages. You can install package-name using the gem command: gem install package-name Metals commonly used include:
|
See also
References
<templatestyles src="Reflist/styles.css" />
Cite error: Invalid <references>
tag; parameter "group" is allowed only.
<references />
, or <references group="..." />
External links
- Official website
- Asciidoc “cheat-sheet” reference guide
- MPLW - Matplotlib charting filter for AsciiDoc
- RTextDoc. Editor with AsciiDoc support.
- AsciidocToGo. Frontend to convert AsciiDoc txt files
<templatestyles src="Asbox/styles.css"></templatestyles>