This article needs additional citations for
verification. (March 2014) |
Filename extensions |
.adoc, .asciidoc, .txt |
---|---|
Internet media type |
text/asciidoc, text/plain |
Initial release | 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 |
Stable release | 10.2.0
[1]
/ 22 May 2022 |
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 |
Stable release | 2.0.22
[2]
/ 8 March 2024 |
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]
A Ruby 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 |
---|
J. Smith Wikipedia is an on-line encyclopedia, available in English and many other languages. You can install package-name using the gem command: gem install package-name Metals commonly used include:
|
This article needs additional citations for
verification. (March 2014) |
Filename extensions |
.adoc, .asciidoc, .txt |
---|---|
Internet media type |
text/asciidoc, text/plain |
Initial release | 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 |
Stable release | 10.2.0
[1]
/ 22 May 2022 |
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 |
Stable release | 2.0.22
[2]
/ 8 March 2024 |
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]
A Ruby 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 |
---|
J. Smith Wikipedia is an on-line encyclopedia, available in English and many other languages. You can install package-name using the gem command: gem install package-name Metals commonly used include:
|