AsciiDoc の履歴(No.3)

• 履歴一覧
• 差分 を表示
• 現在との差分 を表示
• ソース を表示
• 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

AsciiDocとは？†

• https://ja.wikipedia.org/wiki/AsciiDoc

  AsciiDocは軽量マークアップ言語のひとつである。
  意味論的にはDocBook XMLと同一であるが、対人可読な文書記述形式であり、文書の（論理）構造を意味付ける規則が平文形式である。
  ゆえに構文解析器を介することなく、テキストエディタなどを用いてAsciiDocで記述された文書を作成・閲読できる。
  HTMLを始めPDF、manページ、電子書籍、スライドといった種々の形式にDocBookツールチェーンを介して変換することが可能である。

Markdown形式より、もうちょい表現力が高い書式。

公式サイト†

• http://asciidoc.org/

リンク†

• Markdown

• Wiki

リファレンス ／ チュートリアル†

• 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

ライブラリー ／ フレームワーク†

• GitBook
  AsciiDocやMarkdownから文書を作るツール
  • GitBook - Document Everything!
    https://www.gitbook.com/

• AsciiDoc対応のSSG
  • Antora
    https://antora.org/

Tips†

元はPythonで作られたツールがあった。
その後、Rubyに移植されて、AsciiDoctorというツールが作られた。
AsciiDocのパーサーは、PythonやRuby、JavaScriptなどのライブラリーがある模様。
PHPに移植するのは、面倒くさいのでやめておいた方がいいかも？（時間の無駄）素直にRubyかJavaScriptのツールを使う？
移植、コピペするとしたら、AsciiDocに対応しているSSGを解析する？

参考書†

#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="" 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>
}}