Date: Sun, 19 Feb 2023 23:35:56 -0600 From: Chris Watson <bsdunix44@gmail.com> To: freebsd-doc@freebsd.org Subject: Plantuml support in asciidoctor, some uml formats work, others not so much... Message-ID: <CAHnbxSRkM7v%2Br=3W-ETHRaH=0ssRbuTfR2sLxNbLv3ueA4xoNw@mail.gmail.com>
next in thread | raw e-mail | index | archive | help
--00000000000061745b05f51b0a82
Content-Type: text/plain; charset="UTF-8"
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'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 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
--00000000000061745b05f51b0a82
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
<div dir=3D"ltr"><div dir=3D"ltr">I felt this was the best list to ask abou=
t this, if it's not punt me in the right direction.<div>I have a 13.1-R=
ELEASE-p7 jail with all the 'latest' rubygem-asciidoctor-* pkg'=
s installed.</div><div>I was just starting to experiment with asciidoctor-d=
iagram and I=C2=A0have noticed that some of plantumls=C2=A0formats work, an=
d some do not. Here are two simple examples using this command line "a=
sciidoctor -b html5 -o index.html -r asciidoctor-diagram example.adoc -w&qu=
ot;:=C2=A0</div>
<div><br></div><div>plantuml that works:</div><div><br></div><div>[plantuml=
, format=3Dsvg]</div><div>....</div><div><a class=3D"gmail_plusreply" id=3D=
"m_8497397790948741279plusReplyChip-0">@startuml</a><br></div><div>User -&g=
t; (start)</div><div>User --> (Use the application) : Label</div><div><a=
class=3D"gmail_plusreply" id=3D"m_8497397790948741279plusReplyChip-1">@end=
uml</a><br>....<br><a class=3D"gmail_plusreply"><br></a></div><div>plantuml=
that does not work:</div><div><br></div><div>[plantuml, format=3Dsvg]</div=
><div>....</div><div>@startuml<br>object London<br><br>map CapitalCity {<br=
>=C2=A0UK *-> London<br>=C2=A0USA =3D> Washington<br>=C2=A0Germany =
=3D> Berlin<br>}<br>@enduml<br></div><div>....</div><div><br></div><div>=
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 tha=
t=C2=A0@startuml and=C2=A0@enduml *should* be optional in an asciidoc docum=
ent when using asciidoctor-diagram. But it fails even without them.</div><d=
iv><br></div><div>The error is:</div><div><br></div><div>[From string (line=
4)]</div><div><a class=3D"gmail_plusreply" id=3D"m_8497397790948741279plus=
ReplyChip-4">@startuml</a><br></div><div>object London</div><div><br></div>=
<div>map CapitalCity {</div><div>Syntax error?</div><div><br></div><div>Bot=
h work correctly in=C2=A0<a href=3D"http://plantuml.com/" target=3D"_blank"=
>plantuml.com</a>'s demo server window that lets you enter uml to rende=
r. This also happens when using other=C2=A0formats like yaml or mindmap whi=
ch is part of plantuml and asciidoctor-diagram is supposed to support as we=
ll. It seems hit or miss on what formats asciidoctor-diagram is able to ren=
der from the main=C2=A0<a href=3D"http://plantuml.com/" target=3D"_blank">p=
lantuml.com</a>=C2=A0page. Is this an issue of asciidoctor-diagram? is it b=
ehind in supporting these formats? is it our port? Can anyone more well ver=
sed in the asciidoctor realm explain what's going on here?</div><div><b=
r></div><div>Thank you very much!</div><div><br></div><div>Chris</div></div=
></div>
--00000000000061745b05f51b0a82--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAHnbxSRkM7v%2Br=3W-ETHRaH=0ssRbuTfR2sLxNbLv3ueA4xoNw>