Wiki ＞ AsciiDoc

AsciiDocとは？ †

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

• AsciiDoc - Google 検索 https://www.google.com/search?q=AsciiDoc

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

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

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

公式サイト †

• http://asciidoc.org/

リンク †

• Markdown

• Wiki

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

• 本文 「AsciiDoc」 を検索 - はてなブックマーク
  https://b.hatena.ne.jp/search/text?q=AsciiDoc

• asciidoc - Qiita
  https://qiita.com/tags/asciidoc

• Lightweight Markup: Markdown, reStructuredText, MediaWiki, AsciiDoc, Org-mode - Hyperpolyglot
  https://hyperpolyglot.org/lightweight-markup

• 文書作成環境の比較 - TeX Wiki
  https://texwiki.texjp.org/?%E6%96%87%E6%9B%B8%E4%BD%9C%E6%88%90%E7%92%B0%E5%A2%83%E3%81%AE%E6%AF%94%E8%BC%83

• Static Site Generators with AsciiDoc Support · GitHub
  https://gist.github.com/briandominick/e5754cc8438dd9503d936ef65fffbb2d

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

• 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/

• Asciidoctor.js
  JavaScriptのAsciiDocライブラリー。
  • Asciidoctor.js | Asciidoctor
    https://asciidoctor.org/docs/asciidoctor.js/
  • GitHub - asciidoctor/asciidoctor.js: A JavaScript port of Asciidoctor, a modern implementation of AsciiDoc
    https://github.com/asciidoctor/asciidoctor.js/
  • Asciidoctor ::ディスカッション-PHPのお客様向けのAsciidoc（tor）
    https://discuss.asciidoctor.org/Asciidoc-tor-for-PHP-customers-td2329.html

• 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を解析する？

• 脱Word、脱Markdown、asciidocでドキュメント作成する際のアレコレ - Qiita
  https://qiita.com/tamikura@github/items/5d3f62dae55617ee42bb

• HubPressで手間をかけずにAsciiDocでかけるブログを作っちゃおう | ぴんくいろにっき
  https://blog.hinaloe.net/2015/03/22/lets-use-hubpress-with-asciidoc/

• AsciiDoc と PlantUML と mermaid.js で素敵なテキストベース仕様書ライフ
  https://ryuta46.com/112

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

• Windows上のVisual Studio Codeで、AsciiDocのプレビュー環境の構築 - シナプス技術者ブログ
  https://tech.synapse.jp/entry/2019/06/03/110000

• VS Code でフロントマターのある AsciiDoc を扱う - Qiita
  https://qiita.com/tnagao7/items/292f6a27ae93fdd660eb

AsciiDoc Markdownで書かれた本 †

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

• JavaScript Primer - 迷わないための入門書 #jsprimer
  https://jsprimer.net/

• 本のソースコード（GitHubで公開されている）
  • GitHub - asciidwango/js-primer: JavaScript Primer - 迷わないための入門書
    https://github.com/asciidwango/js-primer

• 本、Kindle

  JavaScript Primer 迷わないための入門書 azu KADOKAWA 2020-04-27 ￥4180

参考書 †

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