Windows/PanDoc-PlantUML.md
... ...
@@ -0,0 +1,48 @@
1
+[[_TOC_]]
2
+
3
+# 概要
4
+- [PanDoc](https://pandoc.org/) + [PlantUML](http://plantuml.com/) + [Vivaldi](https://vivaldi.com/)/[Chrome](https://www.google.com/intl/ja_ALL/chrome/) で、UML を含む MarkDown を HTML および PDF へ変換する。
5
+- コードブロックの変換には、[Pandoc-Elements](https://github.com/nichtich/Pandoc-Elements) および [ActivePerl](https://www.activestate.com/activeperl) を使用する。
6
+
7
+# インストール
8
+1. [[Chocolatey|/Windows/Chocolatey]] で、PanDoc, PlantUML, ActivePerl, Vivaldi/Chrome をインストールする。(Vivaldi/Chrome はどちらかお好みの方を1つでOK)
9
+ ```
10
+ > cinst -y pandoc plantuml activeperl vivaldi googlechrome
11
+ ```
12
+1. Pandoc-Elements の依存モジュールをインストールする。
13
+ ```
14
+ > ppm install JSON JSON-PP Hash-MultiValue Pandoc IPC-Run3
15
+ ```
16
+1. Pandoc-Elements の plantuml ブランチをダウンロードする。
17
+https://github.com/nichtich/Pandoc-Elements/archive/plantuml.zip
18
+1. ダウンロードした zip を展開し、Build.pl のあるフォルダに移動する。
19
+1. Build.PL を実行して Build スクリプトを作成する。
20
+ ```
21
+ > perl Build.PL
22
+ ```
23
+1. Build.bat を実行して blib 下に必要なファイルを配置する。
24
+ ```
25
+ > Build.bat
26
+ ```
27
+1. `blib\lib\Pandoc` を `C:\Perl64\site\lib\Pandoc` へコピーする。
28
+ ```
29
+ > robocopy blib\lib\Pandoc C:\Perl64\site\lib\Pandoc /e
30
+ ```
31
+1. フィルタフォルダを作成する。
32
+ ```
33
+ > mkdir "%AppData%\pandoc\filters"
34
+ ```
35
+1. plantuml.pl をフィルタフォルダへコピーする。
36
+ ```
37
+ > copy examples\plantuml.pl "%AppData%\pandoc\filters"
38
+ ```
39
+1. サンプルを変換して動作確認する。
40
+カレントのフィルタは使わずにデータフォルダのフィルタを参照する。
41
+ ```
42
+ > cd examples
43
+ > ren plantuml.pl _plantuml.pl
44
+ > pandoc -s --filter plantuml.pl plantuml-sample.md -o plantuml-sample.html
45
+ ```
46
+1. 出力された html を Vivaldi/Chrome で開いて画像が表示されることを確認する。
47
+1. `Ctrl+P` で印刷ダイアログを表示し、プリンタとして `PDFで保存` を選択し保存する。
48
+1. PDF を開き、テキスト選択およびコピーができることを確認する。
... ...
\ No newline at end of file