diff options
author | Christoph Helma <helma@in-silico.ch> | 2019-06-05 17:28:10 +0200 |
---|---|---|
committer | Christoph Helma <helma@in-silico.ch> | 2019-06-05 17:28:10 +0200 |
commit | 9a217185e791d6abbe46549cd4e87c1d1a643c05 (patch) | |
tree | 1968aebd8a38acd7784e58d478e0f6c3fb08ab76 /paper/lua-filters/plantuml/readme.md | |
parent | feb1f82356da50a1ebf63b1eda434c388ab009e1 (diff) |
first manuscript version
Diffstat (limited to 'paper/lua-filters/plantuml/readme.md')
-rw-r--r-- | paper/lua-filters/plantuml/readme.md | 30 |
1 files changed, 30 insertions, 0 deletions
diff --git a/paper/lua-filters/plantuml/readme.md b/paper/lua-filters/plantuml/readme.md new file mode 100644 index 0000000..de5ba74 --- /dev/null +++ b/paper/lua-filters/plantuml/readme.md @@ -0,0 +1,30 @@ +# PlantUML Pandoc filter +PlantUML Pandoc filter to process code blocks with class "plantuml" containing PlantUML notation into images. + +* For textual output formats, use --extract-media=DIR +* For HTML formats, you may alternatively use --self-contained + +## Example in markdown-file +```plantuml +@startuml +Alice -> Bob: Authentication Request Bob --> Alice: Authentication Response +Alice -> Bob: Another authentication Request Alice <-- Bob: another authentication Response +@enduml +``` +## Run pandoc +``` +pandoc --self-contained --lua-filter=plantuml.lua readme.md -o output.htm +``` + +## Prerequisites +* download PlantUML from http://plantuml.com (needs JAVA) +* 3 ways to set the environment + 1. plantuml.lua and plantuml.jar in the same folder and start pandoc always from this folder + 2. set a Environment Variable PLANTUML with the path to plantuml.jar + * Windows - with powershell: Set-Item env:PLANTUML "c:\bin\plantuml.jar" + 3. change path to plantuml.jar in plantuml.lua + + +This script based on the example "Converting ABC code to music notation" from https://pandoc.org/lua-filters.html + +This script was only tested with markdown to html on a windows environment! |