4a376e8e188eae0e3bead07d7930f8b511cad272
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 |