Wiki > AsciiDoc

2018-11-18 (日) 公開
2020-05-16 (土) 更新

AsciiDocとは?

文書作成に使われる軽量なマークアップ言語。Markdownより少し高機能っぽい。

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

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

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

公式サイト

リンク

AsciiDocに関する資料。AsciiDocのPros/Consについて検討。

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

ライブラリー / フレームワーク

  • Pandoc ユーザーズガイド 日本語版 - Japanese Pandoc User's Association
    http://sky-y.github.io/site-pandoc-jp/users-guide/

    Pandocは Haskell で書かれたライブラリおよびコマンドラインツールであり、 あるマークアップ形式で書かれた文書を別の形式へ変換するものです。

Tips

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

Visual Studio CodeでAsciiDocを編集する方法

AsciiDoc Markdownで書かれた本

GitHubで中身を見ると、「.md」ファイル(Markdown形式)がズラズラと並んでいるが、その中身を見るとAsciiDoc記法になっているようだ。
=文頭の「フロントマター」(「---」で囲まれた注意書きみたいなところ)
Markdownで書かれた本だった。(Markdownでもフロントマターを差し込める)

参考書

 ドキュメント作成システム構築ガイド[GitHub、RedPen、Asciidoctor、CIによる モダンライティング]
伊藤 敬彦 / 吉村 孝広
技術評論社
2016-03-25
¥ 2,678

トップ   編集 凍結 差分 バックアップ 添付 複製 名前変更 リロード   新規 一覧 単語検索 最終更新   ヘルプ   最終更新のRSS
Last-modified: 2018-11-18 (日) 14:42:57 (2067d)