#110 Support properties and node description

[kirchsth]

That I can create document a detailed documentation too. I added following extensions.

(Deployment_)Node elements are extended with following macros:

• (Deployment_)Node() supports description and sprite
• Node() is added as short version of Deployment_Node()
• (Deployment_)Node() can be left/right aligned with (Deployment_)Node_L() and (Deployment_)Node_R()

Properties can be added with following macros:

• SetPropertyHeader(col1Name, col2Name, ?col3Name, ?col4Name) : The properties table can have up to 4 columns. The default header uses the column names "Name", "Description".
• WithoutPropertyHeader() If no header is used, then the second column is bold.
• AddProperty(col1, col2, ?col3, ?col4)` (All columns of) a property which will be added to the next element.

and can be used like below

@startuml
!include https://raw.githubusercontent.com/kirchsth/C4-PlantUML/extended/C4_Deployment.puml

' default header Property, Value
AddProperty("Name", "Flash")
AddProperty("Organization", "Zootopia")
AddProperty("Tool", "Internet Explorer 7.0")
Person(personAlias, "Label", "Optional Description (with default property header)")

SetPropertyHeader("Property","Value", "Description")
AddProperty("Prop1", "Value1", "Details1")
AddProperty("Prop2", "Value2", "Details2")
Deployment_Node_L(nodeAlias, "Label", "Optional Type", "Optional Description (with custom property header)") {

  WithoutPropertyHeader()
  AddProperty("PropC1", "ValueC1")
  AddProperty("PropC2", "ValueC2")
  Container(containerAlias, "Label", "Technology", "Optional Description (without property header)")
}

System(systemAlias, "Label", "Optional Description (without properties)")

Rel(personAlias, containerAlias, "Label", "Optional Technology")
@enduml

A preview of the PR can be found in my extended branch

The extensions are compatible with the .dotnet structurizr model and enables a detailed deployment diagram too.

BR Helmut

[adrianvlupu]

These are some insane PlantUML skills 🤯

[adrianvlupu]

I have no doubt this will turn to hell when something changes in the PlantUML preprocessor but I can't help myself