 |
This article needs additional citations for verification. Please help improve this articlebyadding citations to reliable sources. Unsourced material may be challenged and removed.
Find sources: "AsciiDoc" – news · newspapers · books · scholar · JSTOR (March 2014) (Learn how and when to remove this message) |
| Filename extensions |
.adoc, .asciidoc, .txt
|
|---|---|
| Internet media type |
text/asciidoc, text/plain
|
| Initial release | 2002; 22 years ago (2002) |
| Open format? | yes |
| Website | asciidoc |
| Original author(s) | Stuart Rackham |
|---|---|
| Developer(s) | Matthew Peveler, Dan Allen, Michel Krämer, et al. |
| Initial release | November 25, 2002; 21 years ago (2002-11-25) |
| Stable release |
10.2.0[1] |
| Repository | github |
| Written in | Python |
| Operating system | Cross-platform |
| Type | Documentation generator |
| License | GPL v2 |
| Website | asciidoc-py |
| Original author(s) | Ryan Waldron |
|---|---|
| Developer(s) | Dan Allen, Sarah White, et al. |
| Initial release | January 30, 2013; 11 years ago (2013-01-30) |
| Stable release |
2.0.23[2] |
| Repository | github |
| Written in | Ruby |
| Operating system | Cross-platform |
| Type | Documentation generator |
| License | MIT |
| Website | asciidoctor |
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.[3] Common file extensions for AsciiDoc files are txt (as encouraged by AsciiDoc's creator) and adoc.[4][5]
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.[3]
ARuby implementation called ‘Asciidoctor’, released in 2013, is in use by GitHub[6] and GitLab.[7] This implementation is also available in the Java ecosystem using JRuby and in the JavaScript ecosystem using Opal.js.
Some of O'Reilly Media's books and e-books are authored using AsciiDoc mark-up.[8]
Most of the Git project documentation is written in AsciiDoc.[9]
The AsciiDoc format is currently under standardization procedure by the Eclipse Foundation.[10][11]
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://wikipedia.org[Wikipedia] is an
on-line encyclopedia, 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 |
|---|
|
My Article J. Smith Wikipedia is an on-line encyclopedia, 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:
|
|
| |
|---|---|
| Office suite |
|
| Well-known |
|
| Lesser-known |
|
