AsciiDoc の変更点

• 追加された行はこの色です。
• 削除された行はこの色です。
• AsciiDoc へ行く。

#author("2020-05-17T03:51:24+00:00","default:sagasite","sagasite")
[[Wiki]] ＞ AsciiDoc

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

#contents

//----------------------------------------
* AsciiDocとは？ [#lea5aacf]
文書作成に使われる軽量なマークアップ言語。[[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形式より、もうちょい表現力が高い書式。

** 公式サイト [#j960b34a]
- http://asciidoc.org/

** リンク [#g03517a8]

-[[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


//----------------------------------------
* リファレンス ／ チュートリアル [#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

//----------------------------------------
* ライブラリー ／ フレームワーク [#f5b2d6b5]

- [[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 [#of5a9125]

元は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を編集する方法 [#g93b6614]

- 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で書かれた本 [#s005c882]
%%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
#html{{
<table border="0" cellpadding="5"><tr><td valign="top"><a href="https://www.amazon.co.jp/exec/obidos/ASIN/4048930737/vertex9-22/" target="_blank"><img src="https://m.media-amazon.com/images/I/51P+rWQKYdL._SL160_.jpg" border="0"></a></td><td>　</td><td valign="top"><a href="https://www.amazon.co.jp/exec/obidos/ASIN/4048930737/vertex9-22/" target="_blank">JavaScript Primer 迷わないための入門書</a><br>azu<br>KADOKAWA<br>2020-04-27<br>￥4180</td></tr></table>
}}


//----------------------------------------
* 参考書 [#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>
}}