- バックアップ一覧
- 差分 を表示
- 現在との差分 を表示
- ソース を表示
- AsciiDoc へ行く。
- 1 (2018-11-18 (日) 05:33:51)
- 2 (2018-11-18 (日) 14:42:57)
- 3 (2018-11-18 (日) 14:42:57)
- 4 (2018-11-18 (日) 14:42:57)
Wiki > AsciiDoc
2018-11-18 (日) 公開
2020-05-16 (土) 更新
AsciiDocとは? †
- https://ja.wikipedia.org/wiki/AsciiDoc
AsciiDocは軽量マークアップ言語のひとつである。
意味論的にはDocBook XMLと同一であるが、対人可読な文書記述形式であり、文書の(論理)構造を意味付ける規則が平文形式である。
ゆえに構文解析器を介することなく、テキストエディタなどを用いてAsciiDocで記述された文書を作成・閲読できる。
HTMLを始めPDF、manページ、電子書籍、スライドといった種々の形式にDocBookツールチェーンを介して変換することが可能である。
Markdown形式より、もうちょい表現力が高い書式。
公式サイト †
リンク †
リファレンス / チュートリアル †
- GitHub
https://github.com/asciidoc
- Asciidoctor
https://asciidoctor.org/
- ドキュメントシステムはこれを使え2015年版
https://www.slideshare.net/k16shikano/2015-55455604
ライブラリー / フレームワーク †
- GitBook
AsciiDocやMarkdownから文書を作るツール- GitBook - Document Everything!
https://www.gitbook.com/
- GitBook - Document Everything!
- AsciiDoc対応のSSG
- Antora
https://antora.org/
- Antora
Tips †
元はPythonで作られたツールがあった。
その後、Rubyに移植されて、AsciiDoctorというツールが作られた。
AsciiDocのパーサーは、PythonやRuby、JavaScriptなどのライブラリーがある模様。
PHPに移植するのは、面倒くさいのでやめておいた方がいいかも?(時間の無駄)素直にRubyかJavaScriptのツールを使う?
移植、コピペするとしたら、AsciiDocに対応しているSSGを解析する?
参考書 †
ドキュメント作成システム構築ガイド[GitHub、RedPen、Asciidoctor、CIによる モダンライティング] 伊藤 敬彦 / 吉村 孝広 技術評論社 2016-03-25 ¥ 2,678 |