使いこなすために。
前回まで
- rbenvとruby-buildとRuby2.4.0をインストールする
- AsciiDoctorをインストールする
- FirefoxにAsciiDocのプレビューアをインストールする
- plumaにAsciiDocのシンタックスハイライトを設定した
- AsciiDoctorでcoderayを使いシンタックスハイライトする
ブログを書くのにAsciiDocを使いたい。何となく使ってみるも、AsciiDocの仕様など色々わからないことだらけ。資料が欲しい。
AsciiDoctorのドキュメント
基本的にこのページが目次になる。
AsciiDoctorとは何か
Asciidoctorは、AsciiDocコンテンツをHTML5、DocBook 5または4.5、EPUB3、PDFおよびその他の形式に変換するための、 高速テキストプロセッサおよびパブリッシングツールチェーンです。
要するにAsciiDoc形式ファイルをHTML5に変換してくれるツール。
AsciiDoc Python から派生した
AsciidoctorはAsciiDoc Pythonで実装されたAsciiDoc構文( いくつかの例外を除く )を完全に遵守することを目指していますが、AsciiDoc Pythonの単なるクローン以上のものです。
AsciiDoc Pythonが何者なのか不明。リンクがない。検索してみるとこちらがヒット。
これ、静的サイトジェネレータPelicanのプラグインで使われていたAsciiDocAPIと思われる。どうやらAsciiDoctorの先輩だったらしい。
AsciiDoc Python < AsciiDoctor
あらゆる面でAsciiDocよりAsciiDoctorのほうが優れているらしい。
- https://translate.googleusercontent.com/translate_c?depth=1&hl=ja&rurl=translate.google.co.jp&sl=en&sp=nmt4&tl=ja&u=http://asciidoctor.org/docs/what-is-asciidoctor/&usg=ALkJrhhVcA3JVWnjMB8lI_TsnBcirrUk0A#what-s-unique-about-the-asciidoctor-implementation
- Google 翻訳
まとめ
AsciiDoctorはAsciiDoc(Python)から派生したAsciiDocエンジンである。
現在、AsciiDoc→HTMLできるのは上記2エンジンしか知らない。改良されているようなので使うならAsciiDoctorを。
所感
成り立ちはわかった。で、使い方は?書き方は?次回以降。