sytsereitsma / mdbook-plantuml

mdBook preprocessor to render PlantUML diagrams to png images in the book output directory

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Try basic auto detection of plantuml executable

sytsereitsma opened this issue · comments

Simply try various options (query plantuml version) and use the first successful one.

Relevant code is here:

pub fn create(cfg: &PlantUMLConfig) -> Box<dyn PlantUMLBackend> {

I advocate for this or adding some alternates (a KISS approach to check also /usr/local/bin) as on OS X the System Integrity Protection makes it quite difficult to symlink into this location. I think my installation setup is pretty common for the plantuml binary (installed via homebrew). I hit this issue with creating the /usr/bin/plantuml symlink, but plantuml is on my PATH

For those arriving at this issue one workaround is to use the plantuml-cmd option like:

[preprocessor.plantuml]
plantuml-cmd="plantuml.exe"

but this might not be as portable

i also vote this up. i've been trying for a long time to setup plantuml with mdbook but it takes litterly weeks before i give up. in the docs say the plantuml.EXE must be executable from the path. but almost nowhere there is a link to an .exe file of plantuml they only have .jar files. where are we supose to get it?