asciidoc を Homebrew, apk, apt, dnf, MacPorts, Nix, pacman, zypper でインストール

プロジェクトリンク

• ホームページ
• リポジトリ
• パッケージマネージャページ

コマンドとエイリアス

• a2x
• asciidoc

プロジェクトの歴史

The official Asciidoctor history records that Stuart Rackham first conceived AsciiDoc in 2002 as a shorthand format for DocBook and launched both the language and processor as the AsciiDoc.py project. The first public AsciiDoc.py 1.0 release, SourceForge registration, and first website publication all happened on 2002-11-25.

AsciiDoc.py evolved for roughly a decade as the original processor. The official timeline records a move from SourceForge-era hosting through Google Code and then, in December 2013, transfer of the source repository to the asciidoc organization on GitHub. The AsciiDoc.py homepage describes it as highly configurable, with source syntax and backend output markups customizable through configuration files.

The later Python package line modernized the old processor. The official changelog records Python 3.5+ support in version 9.0.0 in 2020, a 10.0.0 rewrite into a proper Python package installable with `pip install asciidoc` in 2021, and version 10.2.1 in July 2024.

採用の歴史

AsciiDoc.py spread because it made DocBook-oriented publishing possible from plain text using `asciidoc` and the `a2x` wrapper. The official homepage shows examples for HTML, XHTML, DocBook, EPUB, PDF, slides, websites, and Unix man pages, and the install page lists distro packaging in Fedora, Debian/Ubuntu, and Homebrew.

Its role changed after Asciidoctor appeared. The official history says Asciidoctor became AsciiDoc.py's successor after GitHub disabled AsciiDoc rendering in January 2013 for security concerns and then re-enabled rendering with Asciidoctor. The AsciiDoc.py homepage now recommends using a modern processor unless the AsciiDoc.py toolchain is specifically required.

使われ方

Package users install `asciidoc` and `a2x` to translate `.txt` or `.adoc` sources into HTML, DocBook, man pages, EPUB, PDF, and related outputs. The user guide describes AsciiDoc as lightweight, consisting of scripts plus configuration files, with backend plugins and themes extending output generation.

パッケージ好きにとっての重要性

AsciiDoc.py is historically important because it is the original implementation that made AsciiDoc a package-manager staple. It is also a useful case study in language/tool split: the `asciidoc` package name preserves the old Python processor even as the language specification and modern processing ecosystem moved toward Asciidoctor and the Eclipse AsciiDoc Working Group.

タイムライン

• 2002-11-25: First public release of AsciiDoc.py 1.0 by Stuart Rackham.
• 2007-10-23: AsciiDoc.py source repository converted to Mercurial and transferred to Google Code.
• 2013-12-21: AsciiDoc.py source repository converted to git and transferred to the asciidoc GitHub organization.
• 2020-06-02: AsciiDoc.py 9.0.0 ports the processor to Python 3.5+.
• 2021-10-16: AsciiDoc.py 10.0.0 becomes a proper Python package installable from PyPI.
• 2024-07-16: AsciiDoc.py 10.2.1 released.

Related projects

• Asciidoctor is the Ruby successor and current reference implementation for the AsciiDoc language.
• a2x is the AsciiDoc.py toolchain wrapper for post-processing DocBook output into formats such as PDF and EPUB.
• The Eclipse AsciiDoc Working Group governs the modern AsciiDoc language direction.

ソース

• https://asciidoc-py.github.io/
• https://asciidoc-py.github.io/CHANGELOG.html
• https://asciidoc-py.github.io/INSTALL.html
• https://docs.asciidoctor.org/about/history/
• https://docs.asciidoctor.org/asciidoc/latest/