asciidoctor-nabetani 0.1.0 → 0.1.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/Gemfile.lock +1 -1
- data/README.md +93 -0
- data/lib/asciidoctor/nabetani/pdf-outline.rb +1 -0
- data/lib/asciidoctor/nabetani/version.rb +1 -1
- metadata +1 -1
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 5c73b2f53cac72e8c52660ec031ea745b1b9121a0b288274b9a1ca61fc897cc0
|
4
|
+
data.tar.gz: cb772294699e79d60f50b6c22fb89a58149426fa4a2b070503d8c509b3a3e821
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 32241346c57551fa2a5cd5521ee55c2b0257d617b7e5b236525837960ceb6c1edff8d870f5d6616928d55e1d96246ff4d6651084649c56d5680eafd9d6d79a61
|
7
|
+
data.tar.gz: a7aabb02953cfc71eaf1de3cda78f1145fc4facde06ce6094458ce4beb018a8aba87e5714630a956ca508c770ba6adb8679a1a59a73302023283b8660dd46ed7
|
data/Gemfile.lock
CHANGED
data/README.md
CHANGED
@@ -43,3 +43,96 @@ The gem is available as open source under the terms of the [MIT License](https:/
|
|
43
43
|
|
44
44
|
Everyone interacting in the Asciidoctor::Nabetani project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/asciidoctor-nabetani/blob/master/CODE_OF_CONDUCT.md).
|
45
45
|
|
46
|
+
## What is this
|
47
|
+
|
48
|
+
突然日本語ですいません。
|
49
|
+
|
50
|
+
AsciiDoctor で PDF を作るときに困っていたことをなんとかしたライブラリ。
|
51
|
+
|
52
|
+
### 禁則処理の改善
|
53
|
+
|
54
|
+
`asciidoctor/nabetani/prawn-linewrap-ja` を require すると有効になる。
|
55
|
+
|
56
|
+
prawn の禁則処理を本ライブラリの処理で差し替えることで、禁則処理を改善する。
|
57
|
+
|
58
|
+
### クロスリファレンス
|
59
|
+
|
60
|
+
`asciidoctor/nabetani/abstractblock-xreftext` を require すると有効になる。
|
61
|
+
|
62
|
+
AsciiDoc のクロスリファレンスで
|
63
|
+
|
64
|
+
従来は
|
65
|
+
|形式名|PDF上の出力例|
|
66
|
+
|:--|:--|
|
67
|
+
|full|`Section 2.1, “セクション名”`|
|
68
|
+
|short|`Section 2.1`|
|
69
|
+
|basic|`セクション名`|
|
70
|
+
の三択だった。
|
71
|
+
|
72
|
+
これを
|
73
|
+
|
74
|
+
```
|
75
|
+
:xrefstyle: custom
|
76
|
+
:xrefcustomformat: [$SECT_NUMS$]. [$TITLE$]
|
77
|
+
```
|
78
|
+
などと指定することで、PDF上で
|
79
|
+
```
|
80
|
+
2.1. セクション名
|
81
|
+
```
|
82
|
+
とすることができるようにする。
|
83
|
+
|
84
|
+
|記号|意味|
|
85
|
+
|:--|:--|
|
86
|
+
|[$SECT_NUMS$]|セクション番号をピリオドでつないだもの。`2.1` など|
|
87
|
+
|[$TITLE$]|セクション名|
|
88
|
+
|
89
|
+
※ 上記以外はそのまま出力される。
|
90
|
+
|
91
|
+
### horizontal な定義リスト
|
92
|
+
|
93
|
+
`asciidoctor/nabetani/horz-dlist` を require すると有効になる。
|
94
|
+
|
95
|
+
horizontal な定義リストで
|
96
|
+
```
|
97
|
+
[horizontal, margin-left=20, margin-bottom=10]
|
98
|
+
Foo:: bar
|
99
|
+
Baz Qux:: quux corge
|
100
|
+
```
|
101
|
+
のように指定することで、左マージンと下マージンを指定することができる。
|
102
|
+
指定する数字の単位は PDF point だと思う。
|
103
|
+
|
104
|
+
### PDF のプロパティ
|
105
|
+
|
106
|
+
`asciidoctor/nabetani/pdf-custom-property` を require すると有効になる。
|
107
|
+
|
108
|
+
PDF のファイル情報の「概要」欄の項目を adoc ファイル内に
|
109
|
+
|
110
|
+
```
|
111
|
+
// タイトルを「PDF Title」にする
|
112
|
+
:pdf_title: PDF Title
|
113
|
+
```
|
114
|
+
|
115
|
+
のように書くことで、個別に指定できる。
|
116
|
+
|
117
|
+
指定可能な項目は下表の通り:
|
118
|
+
|アトリビュート名|Acrobat Reader の「概要」欄の日本語名|例|
|
119
|
+
|:--|:--|:--|
|
120
|
+
|pdf_title|タイトル|Starfish Wars|
|
121
|
+
|pdf_author|作成者|鍋谷武典|
|
122
|
+
|pdf_subject|サブタイトル|ビピンナリアの復讐|
|
123
|
+
|pdf_keywords|キーワード|ヒトデ 棘皮動物 Starfish|
|
124
|
+
|pdf_producer|PDF変換|Acrobat Distiller|
|
125
|
+
|pdf_creator|アプリケーション|FrameMaker 6.0|
|
126
|
+
|
127
|
+
### PDF のしおり(outline)
|
128
|
+
|
129
|
+
`asciidoctor/nabetani/pdf-outline` を require することで有効になる。
|
130
|
+
|
131
|
+
通常の asciidoctor-pdf でビルドした場合、PDF のしおり欄の先頭は 表紙になるが、この機能を有効にすると、表紙はしおりにふくまれないようになる。
|
132
|
+
|
133
|
+
|
134
|
+
|
135
|
+
|
136
|
+
|
137
|
+
|
138
|
+
|