Re: Plantuml support in asciidoctor, some uml formats work, others not so much...
- In reply to: Moin Rahman : "Re: Plantuml support in asciidoctor, some uml formats work, others not so much..."
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Mon, 20 Feb 2023 13:23:25 UTC
> On Feb 20, 2023, at 1:15 PM, Moin Rahman <bofh@freebsd.org> wrote:
>
>
>
>> On Feb 20, 2023, at 6:35 AM, Chris Watson <bsdunix44@gmail.com <mailto:bsdunix44@gmail.com>> wrote:
>>
>> I felt this was the best list to ask about this, if it's not punt me in the right direction.
>> I have a 13.1-RELEASE-p7 jail with all the 'latest' rubygem-asciidoctor-* pkg's installed.
>> I was just starting to experiment with asciidoctor-diagram and I have noticed that some of plantumls formats work, and some do not. Here are two simple examples using this command line "asciidoctor -b html5 -o index.html -r asciidoctor-diagram example.adoc -w":
>>
>> plantuml that works:
>>
>> [plantuml, format=svg]
>> ....
>> @startuml <>
>> User -> (start)
>> User --> (Use the application) : Label
>> @enduml <>
>> ....
>>
>> <>
>> plantuml that does not work:
>>
>> [plantuml, format=svg]
>> ....
>> @startuml
>> object London
>>
>> map CapitalCity {
>> UK *-> London
>> USA => Washington
>> Germany => Berlin
>> }
>> @enduml
>> ....
>>
>> The latter gives a syntax error. It's lifted directly from the plantuml wesbite examples so I'm not sure that error is correct? And I know that @startuml and @enduml *should* be optional in an asciidoc document when using asciidoctor-diagram. But it fails even without them.
>>
>> The error is:
>>
>> [From string (line 4)]
>> @startuml <>
>> object London
>>
>> map CapitalCity {
>> Syntax error?
>>
>> Both work correctly in plantuml.com <http://plantuml.com/>'s demo server window that lets you enter uml to render. This also happens when using other formats like yaml or mindmap which is part of plantuml and asciidoctor-diagram is supposed to support as well. It seems hit or miss on what formats asciidoctor-diagram is able to render from the main plantuml.com <http://plantuml.com/> page. Is this an issue of asciidoctor-diagram? is it behind in supporting these formats? is it our port? Can anyone more well versed in the asciidoctor realm explain what's going on here?
>>
>> Thank you very much!
>>
>> Chris
>
> We have a very old version of rubygem-asciidoctor-diagram. I am working on upgrading it. Additionally for plantuml you will also require java installed.
>
> Kind regards,
> Moin(bofh@ with docs@ hat on)
I have updated rubygem-asciidoctor to a later version 2.0.0 which is also old but as we are planning to use this in our documentation project I am just not taking the big risk of jumping into latest. However please check and revert.
Kind regards,
Moin