Loading article…
AsciiDoc は、意味的にはDocBook XMLと同等の、人間が読めるドキュメント形式ですが、プレーンテキストのマークアップ規則を使用します。AsciiDoc ドキュメントは、任意のテキスト エディタを使用して作成し、「そのまま」読むことも、HTMLや DocBook ツール チェーンでサポートされているその他の形式 ( PDF、TeX、Unixマニュアル ページ、電子書籍、スライド プレゼンテーションなど)にレンダリングすることもできます。 [ 2 ] AsciiDoc ファイルの一般的なファイル拡張子は[ 3 ]と、歴史的には(AsciiDoc の作成者によって推奨されている) [ 4 ]です。adoctxt
AsciiDoc フォーマットはEclipse Foundationによって標準化されています。[ 5 ] [ 6 ]
AsciiDocは2002年にStuart Rackhamによって作成され、彼はプログラミング言語Pythonで書かれたツール（ asciidocとa2x ）を公開し、プレーンテキストの人間が読めるファイルを一般的に使用される公開文書形式に変換しました。[ 2 ]
Ruby（Asciidoctorという名称で2013年にリリース）、JRubyを介したJavaエコシステム、 Opal.jsを介したJavaScriptエコシステム、そしてHaskellとGoにも実装が存在する。
2019年に技術標準化プロセスが開始されて以来、Asciidoctorプロジェクトは、言語のオリジナル作者であるStuart Rackhamの支援を受けて、開発中のAsciiDoc仕様の独立した互換性のある実装を作成することを目指してきました。
[ 8 ] AsciiDoc言語の公式ウェブサイトは、その後、Asciidoctorの言語ドキュメントへのリンクを開始しました。
2019年に標準化プロセスが開始されたのと同時に、Asciidoctor 2.0がリリースされ、イタリック体を示すための単一引用符（ ）など、構文のいくつかの部分が非推奨になった。 [ 9 ]レガシー構文は互換モードを通じて引き続き利用可能である。[ 10 ]'
Stuart Rackham によるオリジナルの Python 実装は引き続き開発されており、AsciiDoc.pyという名前が付けられています。2021 年以降、そのドキュメントではレガシー
と説明されており、正式には古いバージョンの言語を対象としています。[ 11 ]
GitプロジェクトのドキュメントのほとんどはAsciiDocで書かれています。[ 12 ]
O'Reilly Mediaの書籍や電子書籍の中には、AsciiDoc マークアップを使用して作成されたものがあります。 [ 13 ]
Red Hatの製品ドキュメントはAsciiDocで記述されています。
AsciidoctorはGitHub [ 14 ]およびGitLab [ 15 ]内で使用可能です。
JetBrains IDE エコシステムは、 AsciiDocやAsciiDoc Proなどのプラグインを介して AsciiDoc 編集をサポートしており、ライブプレビュー、構文ハイライト、PDF エクスポートなどの AsciiDoc ドキュメントサポートを提供します。[ 16 ]
以下は、AsciiDocマークアップを使用したテキストと、AsciiDocプロセッサによって生成されたレンダリング結果の例です。
