ADOC Guide
引用する
点開
テストして、ホームページに変えた後、効果は悪くありません.
使用
インストール
公式サイトには様々なインストール方法がありますが、
とても好きです
あまり話さないで、入って
間違っています.あなたは
やはり権限がなくて、あなたは
解決策として、ディレクトリを変えてみると、ソフトリンクを作成中にエラーが発生した可能性があると推測されますが、
順調に進み、インストールに成功しました.
構文
書くのは基本的に問題ないですが、元
公式サイトには文法の参考があり、
例があります
生成
そのまま後にドキュメント名を書けば、同名の
ブラウザで開くと、効果は悪くありません.
生成
インストール
ネット上の多くの解決策は解決することができますが、しかし人にぼんやりさせやすくて、実はとても簡単なもので、ずっとこの命令を打って、それは何をヒントにして、何をインストールします.
提示が少ない
再実行、誤報なし
皆さんも問題を見たはずです.字を少なくしてください.
後でフォントの原理であることを発見して、フォントはこの字がなくて、表示できません.
フォントのインストール
ここはネットの問題であるべきで、私は何度も降りて、ずっとネットがタイムアウトしています.
結局あきらめて、公式倉庫に行ってフォントを手動でダウンロードします.
下の字で、どれが役に立つか分からないので、いっそ全部
見つけた
ダウンロードしたフォントをこのディレクトリに移動します.
コマンドを再度実行し、実行時に生成
大成功!
まとめ
先人の経験を参考にすると,いつも自分の独りよがりよりましだ.
点開
spring-bootの公式倉庫、READMEおなじみではありませんmarkdownフォーマットですがadoc.adocの公式サイトにもそのメリットが明確に記載されており、HTML5・DocBookその他のフォーマットに置き換えることができる.テストして、ホームページに変えた後、効果は悪くありません.
使用
インストール
公式サイトには様々なインストール方法がありますが、
APT・Homebrew・Chocolatey.とても好きです
Mac下のHomebrewの、とても便利で、しかし多くのブログを见て、すべて使ったのですGemインストール、心の中で考えて、初めてこれに接触して、やはり前の人の良いことを参考にして、万一问题があっても资料を调べることができて、ついに选んだGem.GemはいRubyのパッケージマネージャは、こちらで直接使えますが、システムが持っているのかも?gem install asciidoctorあまり話さないで、入って
shellノックです.Fetching: asciidoctor-1.5.8.gem (100%)
ERROR: While executing gem ... (Gem::FilePermissionError)
You don't have write permissions for the /Library/Ruby/Gems/2.3.0 directory.間違っています.あなたは
/Library/Ruby/Gems/2.3.0を書き込む権限がありません.上sudo.sudo gem install asciidoctorPassword:
Fetching: asciidoctor-1.5.8.gem (100%)
ERROR: While executing gem ... (Gem::FilePermissionError)
You don't have write permissions for the /usr/bin directory.やはり権限がなくて、あなたは
/usr/binの権限がなくて、調べてみるとMacOSの中で、/usr/binシステム保護されたディレクトリで、rootでも操作する権限がありません.sudo gem install -n /usr/local/bin asciidoctor解決策として、ディレクトリを変えてみると、ソフトリンクを作成中にエラーが発生した可能性があると推測されますが、
/usr/bin権限がない場合は、ソフトリンクを/usr/local/binに入れて、同じように使用できます.順調に進み、インストールに成功しました.
構文
書くのは基本的に問題ないですが、元
markdownでそう書いてadocに切り替えてフォーマットを変更しました.公式サイトには文法の参考があり、
Bootstrapと差が少なく、文書が特によく書かれています.例があります
demo右上のview resultをクリックすると、この文字が最終的に表示される効果が出てきます.生成
HTML生成HTML全く問題なく簡単です.asciidoctor README.adocそのまま後にドキュメント名を書けば、同名の
HTMLドキュメントが生成されます.ブラウザで開くと、効果は悪くありません.
生成
PDF生成PDFそんなにうまくいかなかった.インストール
PDF生成ツール:sudo gem install -n /usr/local/bin --pre asciidoctor-pdfasciidoctor-pdf README.adocネット上の多くの解決策は解決することができますが、しかし人にぼんやりさせやすくて、実はとても簡単なもので、ずっとこの命令を打って、それは何をヒントにして、何をインストールします.
asciidoctor: WARNING: gem 'concurrent-ruby' is not installed. This gem is recommended when registering custom converters.提示が少ない
concurrent-ruby、装う.sudo gem install -n /usr/local/bin concurrent-ruby再実行、誤報なし
PDFも生成されていますが、問題があります.皆さんも問題を見たはずです.字を少なくしてください.
後でフォントの原理であることを発見して、フォントはこの字がなくて、表示できません.
フォントのインストール
sudo asciidoctor-pdf-cjk-kai_gen_gothic-installここはネットの問題であるべきで、私は何度も降りて、ずっとネットがタイムアウトしています.
結局あきらめて、公式倉庫に行ってフォントを手動でダウンロードします.
下の字で、どれが役に立つか分からないので、いっそ全部
20個の字を下ろしました.gem environment見つけた
INSTALLATION DIRECTORYこれがGemパッケージインストールディレクトリです./Library/Ruby/Gems/2.3.0/gems/asciidoctor-pdf-cjk-kai_gen_gothic-0.1.1/data/fontsダウンロードしたフォントをこのディレクトリに移動します.
asciidoctor-pdf -r asciidoctor-pdf-cjk-kai_gen_gothic -a pdf-style=KaiGenGothicCN README.adocコマンドを再度実行し、実行時に生成
PDFのトピックを指定します.大成功!
まとめ
先人の経験を参考にすると,いつも自分の独りよがりよりましだ.