Ensiklopedia Dunia

Technopedia Center

Faculty of Engineering and Computer Science
S1 Informatics S1 Information Systems S1 Information Technology S1 Computer Engineering S1 Electrical Engineering S1 Civil Engineering

faculty of Economics and Business
S1 Management S1 Accountancy

Faculty of Letters and Educational Sciences
S1 English literature S1 English language education S1 Mathematics education S1 Sports Education

AsciiDoc - Wikipedia

From Wikipedia, the free encyclopedia

This article needs additional citations for verification. Please help improve this article by adding 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)

AsciiDoc file format
Filename extensions	.adoc, .asciidoc, .txt
Internet media type	text/asciidoc, text/plain
Initial release	2002; 22 years ago (2002)
Open format?	yes
Website	asciidoc.org

AsciiDoc.py
Original author(s)	Stuart Rackham
Developer(s)	Matthew Peveler, Dan Allen, Michel Krämer, et al.
Initial release	November 25, 2002; 22 years ago (2002-11-25)

Stable release	10.2.1^[1] / 17 July 2024

Repository	github.com/asciidoc/asciidoc-py3
Written in	Python
Operating system	Cross-platform
Type	Documentation generator
License	GPL v2
Website	asciidoc-py.github.io

Asciidoctor
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] / 17 May 2024

Repository	github.com/asciidoctor/asciidoctor
Written in	Ruby
Operating system	Cross-platform
Type	Documentation generator
License	MIT
Website	asciidoctor.org

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]

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.^[3]

Asciidoctor

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]

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://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

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: copper tin lead

Tools

Antora – a multi-repository documentation site generator for tech writers using git.
AsciiBinder – (deprecated) a documentation system built on Asciidoctor for people who have a lot of docs to maintain and republish on a regular basis.
awestruct – a static site generator inspired by Jekyll.
Asciidoc FX – AsciiDoc Book Editor based on JavaFX 8.
AsciiDocLIVE – AsciiDocLIVE is a free online AsciiDoc editor.
DAPS – DocBook Authoring and Publishing Suite (DAPS) is command-line software to publish DocBook & AsciiDoc as HTML, PDF, and EPUB.

References

^ "Release 10.2.1". 17 July 2024. Retrieved 21 July 2024.
^ "Release 2.0.23". 17 May 2024. Retrieved 20 May 2024.
^ ^a ^b "AsciiDoc". Archived from the original on 2016-03-03. Retrieved 2013-10-18.
^ "AsciiDoc Frequently Asked Questions". asciidoc.org. Retrieved 2020-03-20.
^ "AsciiDoc Recommended Practices | Asciidoctor". asciidoctor.org. Retrieved 2020-03-20.
^ "AsciiDoc, powered by Asciidoctor, returns to GitHub and its 5+ million repositories".
^ "Asciidoc". GitLab User Docs. Archived from the original on 2019-07-22. Retrieved 6 Feb 2020.
^ "AsciiDoc 101 (chapter 4 of Getting Started with Atlas)". Author Welcome Kit. O'Reilly Media. Archived from the original on 14 October 2017. Retrieved 19 May 2016.
^ "Git wiki". Git SCM.
^ "AsciiDoc Language". 27 July 2020.
^ "AsciiDoc Working Group Charter".

External links

Official website
https://asciidoctor.org/
Using AsciiDoc and Asciidoctor to write documentation - An AsciiDoc Tutorial

v t e Document markup languages
Office suite	Compound Document Format OOXML SpreadsheetML PresentationML WordprocessingML ODF UOF
Well-known	HTML XHTML MathML RTF TeX LaTeX Markdown
Lesser-known	AmigaGuide AsciiDoc BBCode CML C-HTML ConTeXt CrossMark DITA DocBook EAD Enriched text FHTML GML GuideML HDML HyTime IPF LilyPond LinuxDoc Lout MIF MAML MEI MusicXML OMDoc OpenMath Org-mode POD ReStructuredText RTML RFT S1000D Setext TEI Texinfo troff Wikitext WML WapTV XAML
List of document markup languages

Categories:

Hidden categories: