How the skinparam topurl works? [URL, links]

Question

Hello PlantUML team,

• How the skinparam "topurl" works?

Here is a minimal example:

@startuml
SkinParam topurl https://forum.plantuml.net

url of A is [[/13179]]
url of B is [[https://plantuml.com/sequence-diagram{This is B}]]
@enduml

→ [See links on PlantUML online server]

• Why the link of A is not 'https://forum.plantuml.net/13179'?

What did I misunderstand.
Thanks for yours support,

Regards,
Th.

Comments

Using -language I can't find this keyword, where did you find topurl as a reference?

---

Hello C.,

Here are all references or source:

• Old wiki page:
  • http://wiki.plantuml.net/site/incubation#url_in_diagrams
• Comment on forum:
  • https://forum.plantuml.net/9016/dashed-vs-solid-lines-in-sequence-diagrams?show=9023#c9023
• And of course on the source code

Regards,
Th.

Answer 1

You need to be a bit more explicit, it looks like, specify the participants for sequence diagram. Works for class diagram too

Comments

Well done.  However it wasn't the specifying of the participants that did it, it was the adding of the "{}" into the url.

---

Ah yes, cheers, I forgot to mention that as I converted from class back to sequence (took a bit of fiddling to get it working) - still counts as being more explicit though, eh ;)

---

Thanks @chris, @Martin: for the tip of empty tooltip ('{}').
But it seems to be a bug!
Why topurl works only with empty tooltip? Is it normal?

---

Yes, I would say it's a bug.  A trailing space works too: [[/13179 ]], or quotes: [["/13179"]]

I'm not very familiar with Java, but my best guess at the bug is:

Line#107 in URLBuilder.java

return new Url(full, null, null);

should be

return new Url(withTopUrl(full), null, null);

---

Hello all,

Thanks @Martin for point out on the code, and for the other workarounds (empty tooltip or space) and FYI with quotes it is KO.

Then here is the summary of my tests:

I can will open a BUG Report for the correction of the Line#107 in URLBuilder.java.
Regards,
Th.