- 追加された行はこの色です。
- 削除された行はこの色です。
[[Program]] ＞ AsciiDoc
#author("2020-05-16T14:07:19+00:00","default:sagasite","sagasite")
[[Wiki]] ＞ AsciiDoc
#norelated
RIGHT:2018-11-18 (日) 公開
RIGHT:2020-05-16 (土) 更新
#contents
//----------------------------------------
~
* AsciiDocとは？ [#lea5aacf]
https://ja.wikipedia.org/wiki/AsciiDoc
- https://ja.wikipedia.org/wiki/AsciiDoc
>AsciiDocは軽量マークアップ言語のひとつである。
意味論的にはDocBook XMLと同一であるが、対人可読な文書記述形式であり、文書の（論理）構造を意味付ける規則が平文形式である。
ゆえに構文解析器を介することなく、テキストエディタなどを用いてAsciiDocで記述された文書を作成・閲読できる。
HTMLを始めPDF、manページ、電子書籍、スライドといった種々の形式にDocBookツールチェーンを介して変換することが可能である。
Markdown形式より、もうちょい表現力が高い書式。
** 公式サイト [#j960b34a]
http://asciidoc.org/
- http://asciidoc.org/
** リンク [#g03517a8]
-[[Markdown]]
-[[Wiki]]
//----------------------------------------
~
* リファレンス ／ チュートリアル [#ddcb3564]
- AsciiDoc 早見表日本語訳 https://takumon.github.io/asciidoc-syntax-quick-reference-japanese-translation/
- GitHub https://github.com/asciidoc
- Asciidoctor https://asciidoctor.org/
- ドキュメントシステムはこれを使え2015年版 https://www.slideshare.net/k16shikano/2015-55455604
- AsciiDoc 早見表日本語訳
https://takumon.github.io/asciidoc-syntax-quick-reference-japanese-translation/
- GitHub
https://github.com/asciidoc
- Asciidoctor
https://asciidoctor.org/
- ドキュメントシステムはこれを使え2015年版
https://www.slideshare.net/k16shikano/2015-55455604
//----------------------------------------
~
* ライブラリー ／ フレームワーク [#f5b2d6b5]
-[[GitBook]]
AsciiDocや[[Markdown]]から文書を作るツール
--GitBook - Document Everything!
https://www.gitbook.com/
-AsciiDoc対応の[[SSG]]
--Antora
https://antora.org/
//----------------------------------------
~
* Tips [#of5a9125]
元はPythonで作られたツールがあった。
その後、Rubyに移植されて、AsciiDoctorというツールが作られた。
AsciiDocのパーサーは、PythonやRuby、JavaScriptなどのライブラリーがある模様。
PHPに移植するのは、面倒くさいのでやめておいた方がいいかも？（時間の無駄）素直にRubyかJavaScriptのツールを使う？
移植、コピペするとしたら、AsciiDocに対応している[[SSG]]を解析する？
//----------------------------------------
~
* 参考書 [#ia9890f8]
#html{{
<table border="0" cellpadding="5"><tr><td valign="top"><a href="https://www.amazon.co.jp/exec/obidos/ASIN/477418036X/vertex9-22/" target="_blank"><img src="https://images-fe.ssl-images-amazon.com/images/I/516v0w26krL._SL160_.jpg" border="0"></a></td>
<td> </td>
<td valign="top"><a href="https://www.amazon.co.jp/exec/obidos/ASIN/477418036X/vertex9-22/" target="_blank">ドキュメント作成システム構築ガイド[GitHub、RedPen、Asciidoctor、CIによる モダンライティング]</a><br>伊藤 敬彦 / 吉村 孝広<br>技術評論社<br>2016-03-25<br>￥ 2,678</td></tr></table>
<table border="0" cellpadding="5"><tr><td valign="top"><a href="https://www.amazon.co.jp/exec/obidos/ASIN/477418036X/vertex9-22/" target="_blank"><img src="https://images-fe.ssl-images-amazon.com/images/I/516v0w26krL._SL160_.jpg" border="0"></a></td><td> </td><td valign="top"><a href="https://www.amazon.co.jp/exec/obidos/ASIN/477418036X/vertex9-22/" target="_blank">ドキュメント作成システム構築ガイド[GitHub、RedPen、Asciidoctor、CIによる モダンライティング]</a><br>伊藤 敬彦 / 吉村 孝広<br>技術評論社<br>2016-03-25<br>￥ 2,678</td></tr></table>
}}
