ここasciidoc文法の書き込みを使用していました。
= Asciidoctor-PDF生成PDFファイル
Pinnsvin [email protected]
V1.0} {docdate
:plantuml-サーバーURL:https://www.plantuml.com/plantuml
:TOC:
:DOCTYPE:記事
:imagesdir:../imagesは
//素晴らしいフォントを有効
:アイコン:フォント
// UI有効
:実験を:
:ソース-highlighter:ルージュ
:idprefix:ID_
DESCRIPTION ==
asciidoctor-pdf
組織開発Asciidoctor、ホストされたリンクを維持することによって、プラグに変換するasciidocエビPDF文書に使用Asciidoctorあります。https://github.com/asciidoctor/asciidoctor-pdf [GitHubの]、物品簡単に説明このプラグインは、公式からの内容の一部を使用します。
==インストール
使用逸品インストール
....
$宝石asciidoctor-PDFファイルをインストールします
....
構文の強調表示をサポート
ルージュ(好ましくは、最小バージョン:2.0.0)
....
$逸品ルージュをインストール
....
Pygments
....
$逸品pygments.rbをインストール
....
CodeRay
....
$逸品coderayをインストール
....
構文強調表示を有効にし、唯一する必要が.adoc
次のことを頭に書類を記入:
....
:ソース・蛍光ペン:ルージュは
....
==使用
基本的なコマンド、asciidocが変換されたPDFファイルになって
....
$ asciidoctor-PDF基本-example.adoc
$#これらの2つのコマンドは同等ですが、トップコマンドより簡潔
$ asciidoctor -r asciidoctor-PDF -b PDF basic- example.adoc
....
私たちは、文書は、中国が含まれている場合、最初の変換時間は、問題を文字化けされますが、説明する必要があります。ソリューション参照リンク:中国は問題を文字化けID_ [中国が文字化け]セクション。
==私はのためのプレースホルダです
フォローアップの新セクション
==問題
===中国のゴミ問題
文書は、中国が含まれている場合は、時の初期変換の問題文字化けします。ここでは簡単なデフォルトのテーマのasciidoctor-PDFの。あなたはasciidoctor-PDFヘルプドキュメントへのアクセス権を持っている場合は、彼はカスタムテーマをサポートしています知っています。その理由は、中国は、非中国の鉛で使用されるデフォルトテーマのフォントを文字化けするので、私たちは中国語フォントを追加する必要があります。から選択するには、2つのソリューションがあります。
- プロジェクト/ユーザーのテーマを作成します。
プロジェクトと同じようにユーザーを作成すると、差は、例えば、固定されたフォルダに格納されたユーザの両方の格納場所と同じではない~/.config/adoc
、ちょうど正しいパスを記入する時間を生成するためのコマンドを使用。
====
- 新ADOCでどこのファイルのアイコン:フォルダ[]フォントフォルダ、中国のアイコンにフォントをコピー:フォルダ[]フォントフォルダ
- コピーasciidoctor-PDFのインストールディレクトリのアイコン:ファイル[]
data/themes/default-theme.yml
カレントディレクトリに、または新しいアイコンを作成:ファイルを[] theme.yml - 変更するには、[編集]
default-theme.yml
:メインのノードの内容
....
フォント:
Cataog:
歌:#ソングは、フォントファイルには、次のフォントが含まれていることを確認してください
ノーマル:STSONG.TTFは
太字:STSONG.TTF
斜体:STSONG.TTF
BOLD_ITALIC:STSONG.TTF
ベースを:
#フォントを設定
FONT_FAMILY:歌の
リテラル:
FONT_FAMILY:歌
.... 生成PDF
....
$ asciidoctor-PDF -a PDFスタイル=デフォルト-theme.yml -a PDF-fontsdir =フォントtest.adoc
....
====デフォルトテーマ
Viewアイコン:ファイル[] ../bin/asciidoctor-pdf
ファイルを[]:ソースコードは、彼が実際にアイコンを使用して参照するために../../lib/asciidoctor/pdf.rb
、我々はこのルビーのファイルを参照してくださいよ、と彼らはアイコンに移転していることが見つかりました:[フォルダ] ../asciidoctor-pdf
フォルダ、そのアイコン:フォルダ[] ../lib/asciidoctor-pdf
、これは、アイコンが含まれています:ファイルを[] theme_loader.rb
、デフォルトのテーマは、ロードされたアイコンになることがわかり、ソースコードを読んだ後、このファイルを表示し続ける:ファイルを[] data\themes\base-theme.yml
これは負荷が存在しない場合、data\themes\default-theme.yml
こと、手段base-theme.yml
よりも優先順位default-theme.yml
の高いが、我々は変更する必要があるbase-theme.yml
コンテンツを。メインは、## /ユーザー##テーマのセクションでプロジェクトを作成するために変更することは同じです。変更が完了したら、その後、あなただけが行う必要があります。
....
$ asciidoctor-のPDF test.adoc
....
それとも我々は変更することができdefault-theme.yml
、その後、あなたは、トピック生成されたファイルを指定する必要があるか、独自のテーマファイルを作成します。
....
$ asciidoctor-PDF -a PDFスタイル=デフォルト-theme.yml test.adoc
....
ます。https://github.com/chloerei/asciidoctor-pdf-cjk-kai_gen_gothic [asciidoctor-PDF-CJK-kai_gen_gothic] asciidocで、このプロジェクト、2つのソリューション上記のあなたの心にされない場合は、次のリンクを参照することができます主に日中韓の脚注をサポートするために使用-pdfのテーマプロジェクト:[CJK統合漢字(CJK統合漢字)]、簡体字中国語、繁体字中国語、韓国語、日本語などのサポート。