AsciiDoc備忘録

結局どっちがいいんだろ

１．AsciiDocをかける環境を用意する。

こちらを参考にした

２．書く

記法、文法はここを参照。

便利そう

よく使いそうなのをピックアップ

目次をつける

$ :toc: right

リンクにする

code:a.adoc

....

@startuml

人->ダイエット

@enduml

@startsalt

{+

This is a long

text in a textarea

.

" "

}

@endsalt

ファイルのinclude

UTF8じゃないとincludeできないぽい？

3.結果出力

HTMLにする！

$ asciidoctor {name}.adoc

plantumlなどを埋め込むときはこちら。

$ asciidoctor -r asciidoctor-diagram hoge.adoc

HTMLで作成する

$ asciidoctor -r asciidoctor-pdf-cjk hoge.adoc

Failed to load AsciiDoc document - source is either binary or contains invalid Unicode data

Use --trace for backtrace

上記エラーになったときはメッセージとおりUTF8にする

４．運用編

ファイル埋め込みがすごい！！！！！！！

方法

※ブラウザプレビューだと使えないっぽいな。。

参考サイト

プレビューできないとき

Failed to generate image: Failed to open TCP connection to localhost:8090 (No connection could be made because the target machine actively refused it. - connect(2) for "localhost" port 8090)

↑はサーバが起動していない

Failed to generate image: end of file reached

と表示されてプレビュー出来ないときの解決法

やっと動いているコマンドがわかった。。