This is an automated email from the ASF dual-hosted git repository.
ahuber pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/isis.git
The following commit(s) were added to refs/heads/master by this push:
new 17c8892 ISIS-2426: conguide: add c4 diagram example
17c8892 is described below
commit 17c88924d12dbfbf3b1a51c01226ccd235e8b9cb
Author: Andi Huber <[email protected]>
AuthorDate: Sat Sep 5 07:31:50 2020 +0200
ISIS-2426: conguide: add c4 diagram example
---
.../documentation/pages/asciidoc-syntax.adoc | 51 ++++++++++++++++++++++
1 file changed, 51 insertions(+)
diff --git
a/antora/components/conguide/modules/documentation/pages/asciidoc-syntax.adoc
b/antora/components/conguide/modules/documentation/pages/asciidoc-syntax.adoc
index d2df5ca..0d50021 100644
---
a/antora/components/conguide/modules/documentation/pages/asciidoc-syntax.adoc
+++
b/antora/components/conguide/modules/documentation/pages/asciidoc-syntax.adoc
@@ -788,6 +788,57 @@ Car -- Person : < owns
+== C4 diagrams
+
+Asciidoctor includes support for the link:https://c4model.com//[c4 model].
+
+For example:
+
+....
+[plantuml,images/asciidoctor/c4-demo,svg]
+----
+@startuml
+!includeurl
https://raw.githubusercontent.com/RicardoNiepel/C4-PlantUML/master/C4_Container.puml
+
+title System Context diagram for Internet Banking System
+
+Person(customer, "Banking Customer", "A customer of the bank, with personal
bank accounts.")
+System(banking_system, "Internet Banking System", "Allows customers to check
their accounts.")
+
+System_Ext(mail_system, "E-mail system", "The internal Microsoft Exchange
e-mail system.")
+System_Ext(mainframe, "Mainframe Banking System", "Stores all of the core
banking information.")
+
+Rel(customer, banking_system, "Uses")
+Rel_Back(customer, mail_system, "Sends e-mails to")
+Rel_Neighbor(banking_system, mail_system, "Sends e-mails", "SMTP")
+Rel(banking_system, mainframe, "Uses")
+@enduml
+----
+....
+
+renders as:
+
+[plantuml,images/asciidoctor/c4-demo,svg]
+----
+@startuml
+!includeurl
https://raw.githubusercontent.com/RicardoNiepel/C4-PlantUML/master/C4_Container.puml
+
+title System Context diagram for Internet Banking System
+
+Person(customer, "Banking Customer", "A customer of the bank, with personal
bank accounts.")
+System(banking_system, "Internet Banking System", "Allows customers to check
their accounts.")
+
+System_Ext(mail_system, "E-mail system", "The internal Microsoft Exchange
e-mail system.")
+System_Ext(mainframe, "Mainframe Banking System", "Stores all of the core
banking information.")
+
+Rel(customer, banking_system, "Uses")
+Rel_Back(customer, mail_system, "Sends e-mails to")
+Rel_Neighbor(banking_system, mail_system, "Sends e-mails", "SMTP")
+Rel(banking_system, mainframe, "Uses")
+@enduml
+----
+
+
== Ditaa diagrams
Asciidoctor includes support for the
link:http://ditaa.sourceforge.net/[ditaa], allowing boxes-and-lines diagrams to
be easily sketched.
