如何隐藏PlantUML osaPuml图标的默认编程名称？

使用osaPuml绘制网络图时，图标会默认显示类似«osa_user_green_developer»«osa_desktop»这类底层编程名称，这会给手册的新手读者造成干扰。示例代码如下：

@startuml

!define osaPuml https://raw.githubusercontent.com/Crashedmind/PlantUML-opensecurityarchitecture2-icons/master
!include osaPuml/Common.puml
!include osaPuml/User/all.puml
!include osaPuml/Hardware/all.puml
!include osaPuml/Misc/all.puml
!include osaPuml/Server/all.puml
!include osaPuml/Site/all.puml
' Users
osa_user_green_developer(Mary, "Mary", "Product team", "Developer")
osa_user_green_operations(Ivan, "Ivan", "IT Team", "Server Admin")
osa_user_green_business_manager(Bob, "Bob", "Accounts team", "Manager")
@enduml

解决方案 #

要隐藏这些编程名称，只需在引入osaPuml的Common.puml之前，添加一行配置关闭 stereotype 显示即可：

@startuml

!define osaPuml https://raw.githubusercontent.com/Crashedmind/PlantUML-opensecurityarchitecture2-icons/master
!define OSA_SHOW_STEREOTYPE false  # 关键：全局关闭图标自带的编程名称显示
!include osaPuml/Common.puml
!include osaPuml/User/all.puml
!include osaPuml/Hardware/all.puml
!include osaPuml/Misc/all.puml
!include osaPuml/Server/all.puml
!include osaPuml/Site/all.puml
' Users
osa_user_green_developer(Mary, "Mary", "Product team", "Developer")
osa_user_green_operations(Ivan, "Ivan", "IT Team", "Server Admin")
osa_user_green_business_manager(Bob, "Bob", "Accounts team", "Manager")
@enduml

说明 #

osaPuml的Common.puml内置了OSA_SHOW_STEREOTYPE开关，默认会显示图标对应的编程类名称（即stereotype）。通过提前定义该变量为false，就能全局关闭所有图标的这类名称显示，只保留你自定义的用户信息。如果需要针对单个图标精细控制，也可以在调用图标时手动覆盖配置，但全局定义是最便捷的处理方式。

内容的提问来源于stack exchange，提问作者Rainer-M. Fritsch