From d7a3ef8bec6602277d0572c902040bb7f128d36a Mon Sep 17 00:00:00 2001 From: Pavel Date: Sat, 28 Sep 2024 08:15:30 -0400 Subject: [PATCH] Initial diagram --- README.md | 489 +--------------------------------------------- create-diagram.md | 1 + diagram.drawio | 2 +- diagrammer.md | 1 + page-template.yml | 13 +- root-action.yml | 4 +- 6 files changed, 21 insertions(+), 489 deletions(-) create mode 100644 create-diagram.md create mode 100644 diagrammer.md diff --git a/README.md b/README.md index 25d3155..2a63dc9 100644 --- a/README.md +++ b/README.md @@ -1,486 +1,15 @@ -# Drawio Site +# Diagramming process -This is a template repository for web sites generated from [Drawio](https://www.drawio.com/) diagrams with [GitHub Actions](https://docs.github.com/en/actions) and [Nasdanika CLI Drawio Command](https://docs.nasdanika.org/nsd-cli/nsd/drawio/index.html). +Diagramming is a process with multiple participants, activities, and artifacts. +It is an [enterprise](https://enterprise.models.nasdanika.org/) with a mission to bind decisions to make them executable. +This repository defines a [diagramming process](https://nasdanika-demos.github.io/general-purpose-executable-diagrams-story/) for Drawio diagrams which use [URI Invocable processors](https://docs.nasdanika.org/core/capability/index.html#loading-invocables-from-uris). -## Demos +Please note that one person can represent multiple participants (roles) and vice versa.  +You may clone or fork this repository and customize to your needs. -Below is a list of sites created from this template: +## Resources -* [Bob the builder](https://nasdanika-demos.github.io/bob-the-builder/), this [video](https://www.youtube.com/watch?v=OtifPFetg9o) shows how this demo was created. -* [Internet Banking System](https://nasdanika-demos.github.io/internet-banking-system/index.html) - a sample C4 Model documented using this template/approach. -* [Declarative Command Pipelines](https://nasdanika-demos.github.io/declarative-command-pipelines/) - illustrations for a Medium story. This demo show how to create a site from a diagram with multiple top-level pages. -* More demos on [Nasdanika Demos](https://github.com/orgs/Nasdanika-Demos/repositories) +* [Executable URIs](https://medium.com/nasdanika/executable-invocable-uris-467fa757c58b) +* [General purpose executable graphs and diagrams](https://medium.com/nasdanika/general-purpose-executable-graphs-and-diagrams-8663deae5248) -## Steps - -* On the [repository page](https://github.com/Nasdanika-Templates/drawio-site) click "Use this template" button in the top right. -* Once you create a new repository, go to the Settings > Pages and select "GitHub Actions" as source. -* Click on the Acitons tab. You should see a failed deployment. Manually trigger ``Generate HTML Site from a Drawio diagram with Nasdanika CLI`` action. Once it is successful, open the pages site. -* Customize the diagram, root action, and page template to your needs as explained below. - -The deployment action can be triggered manually from the actions page. -It can be useful if your site references external resources. - -For example: - -* The diagram file may link to pages in external diagrams (federated diagrams) -* The diagram file may reference external documentation resources - -## Deployment process - -* [Nasdanika CLI](https://docs.nasdanika.org/nsd-cli/index.html) is downloaded and extracted -* [drawio](https://docs.nasdanika.org/nsd-cli/nsd/drawio/index.html) [html-app](https://docs.nasdanika.org/nsd-cli/nsd/drawio/html-app/index.html) ... [site](https://docs.nasdanika.org/nsd-cli/nsd/drawio/html-app/site/index.html) ... command pipeline is executed to generate a Web site -* The generated site is deployed to [GitHub Pages](https://pages.github.com/). - -## Diagram file - -You may rename ``diagram.drawio`` to something more meaningful, e.g.``my-system.drawio``. -Or you may use a pre-existing drawio diagram and delete ``diagram.drawio``. -You can also use an external diagram and reference it by URL. -If you do rename/replace the diagram, open ``.github/workflows/site.yml`` and update line 40 with a new diagram file name. - -## Page template - -In the page template file you can: - -* Modify the [theme](https://javadoc.io/doc/org.nasdanika.html/bootstrap/latest/org.nasdanika.html.bootstrap/org/nasdanika/html/bootstrap/Theme.html) on line 3 - choose one of 20+ [Bootswatch themes](https://bootswatch.com/4/) or the default theme. Please note that generated sites look good with light themes, and not so good (in my personal opinion) with dark themes. -* Highly recommended: remove out-of-the-box Google analytics script at lines 23-33 - replace it with your own or remove the header section (lines 22-33) altogether. -* Remove line 36 or set ``fluid`` to ``false``. -* Modify [navigation panel style](https://html-app.models.nasdanika.org/references/eClassifiers/NavigationPanelStyle/index.html) at line 38 - -See [Bootstrap Page Load Specification](https://bootstrap.models.nasdanika.org/references/eClassifiers/Page/load-specification.html) for supported confiuration keys. - -## Root action - -The root action defines: - -* The header (root action[^action_types]). You may modify the icon and the title. -* Root navigation actions - lines 6 - 20. Glossary and search are functional, but not perfect - they need TLC, which I don't have capacity for at the moment. You may use them AS-IS, remove/replace, or improve and create a pull request. Their advantage is that they are standalone - no external dependencies. For public web sites you may consider something like [Algolia](https://www.algolia.com) - they have a [free tier](https://www.algolia.com/pricing/) and a [Vue.js](https://vuejs.org/) search component, [InstantSearch](https://www.algolia.com/doc/guides/building-search-ui/what-is-instantsearch/vue/) -* Footer (root navigation) at lines 21+. Out of the box is links to the template repository site - update or remove. - -See [Action Load Specification](https://html-app.models.nasdanika.org/references/eClassifiers/Action/load-specification.html) for supported configuration keys. - -[^action_types]: See [Action types](https://html-app.models.nasdanika.org/index.html#action-types) - -## Diagram elements - -You can add documentation to diagram elements, ``title`` and ``icon`` property, customize element ID, and link elements to pages or other elements, including pages and elements in other diagram files. - -Site pages are generated only for elements with documentation. - -Important: Pages are not generated for diagram elements without labels or ``title`` property! It may lead to broken links. - -### Documentation - -You can add inline documentation in ``documentation`` property as it is done for [Alice](https://nasdanika-templates.github.io/drawio-site/alice/index.html). - -Documentation is by default treated as Markdown. -Use ``doc-format`` property to specify documentation format. -Out of the box there are 3 formats supported: - -* ``markdown`` -* ``html`` -* ``text`` - -You can add support for more formats, e.g. [Asciidoc](https://docs.asciidoctor.org/asciidoc/latest/) using [AsciidoctorJ](https://github.com/asciidoctor/asciidoctorj) - see "Adding support for documentation format" below. - -You may reference an external documentation resources with ``doc-ref`` property - this how it is done for the diagram root (click on the diagram canvas and then on "Edit Data" button in the right panel). -Documentation reference is a URL resolved relative to the diagram file location. - -If you use ``doc-ref`` property, the documentation format is inferred from the extension. -You may override the inferred value using ``doc-format`` property. - -### Title - -By default the element label is used as action text. -For elements with long labels it may be desirable to use shorter text. -To do so use ``title`` property. - -### Icon - -By default element icons are derived from element images where possible. -Otherwise a default icon is used. -You may use ``icon`` property to customize element icon. -The icon can be a URL (including data URL) or a CSS style e.g. ``fas fa-user``. - -### ID - -Element ID's are used to construct element page URL's. -Element ID's are generated as long random strings. -They are editable - double-click on the ID at the top of the data dialog. -So, if you'd like to have semantic URL's - customize the ID's. - -## Page and element links - -You may link elements to pages and other element using the [extended link syntax](https://docs.nasdanika.org/core/drawio/index.html#page-and-element-links). - -When an element links to a page, the page root[^api] is logically merged with the linking element and page elements (except elements liking to other elements) become logical children of the linking element. - -If an element links to another element, then that element is not considered a logical child of the page/root/page linking element. -The link chain is traversed and the diagram element on the generated site is linked to the page of the link target element if that element has a page (i.e. it is documented). Otherwise there is no link. - -[^api]: See [Drawio API](https://docs.nasdanika.org/core/drawio/index.html#api) - -## Multiple top-level pages - -A top-level diagram page is a page that is not linked from any diagram element. -If there is more than one top-level page, then you may want to add a principal action to the ``root-action.yml`` and link pages to the principal action by removing ``--add-to-root`` option from the command line. - -See [Declarative Command Pipelines](https://nasdanika-demos.github.io/declarative-command-pipelines/) for an example. - -## Icons - -Drawio has more than two thousand built-in icons. You can find more icons on the below sites: - -* [FlatIcons](https://www.flaticon.com/pricing) - 16.8 million icons. Free with attribution, a paid plan is available - no attribution. In-browser editor. PNG and SVG (premium) formats. -* [IconFinder](https://www.iconfinder.com/) - the world's largest marketplace for icons, ... 6 million icons at your fingertips including free icons. Multiple subscription levels. -* [Icons8](https://icons8.com/) - more than a million icons in 47 styles. Free and subscription. Icons can be edited in-place before downloading. -* [Iconduck](https://iconduck.com/) - more than 250 000 free open source icons -* Cloud providers: - * [Azure](https://learn.microsoft.com/en-us/azure/architecture/icons/) - * [AWS](https://aws.amazon.com/architecture/icons/) - -## Markdown - -This section demonstrates advanced capabilities of Markdown documentation. - -### Embedded images - -You can embed PNG and JPEG using fenced blocks. - -#### PNG resource - - ```png-resource - isa.png - ``` - -Resource location is resolved relative to the diagram file location. - -#### JPEG resource - - ```jpeg-resource - my.jpeg - ``` - -#### PNG - - ```png - Base 64 encoded png - ``` -#### JPEG - - ```jpeg - Base 64 encoded jpeg - ``` - -### Embedded diagrams - -You can also embed [PlantUML](https://plantuml.com/), Drawio, and [Mermaid](https://mermaid-js.github.io/mermaid/#/) diagrams using fenced blocks. - -#### Drawio - - ```drawio-resource - aws.drawio - ``` - -Resource location is resolved in the same way as for image files as explained above. - -#### PlantUML - -PlantUML diagrams can be defined inline or loaded from resources. - -##### Loading from a resource - - ```uml-resource - sequence.plantuml - ``` - -##### Inline - -The following language specifications (dialects) are supported: - -* ``uml`` - for the following diagram types: - * [Sequence](https://plantuml.com/sequence-diagram), - * [Use Case](https://plantuml.com/use-case-diagram), - * [Class](https://plantuml.com/class-diagram), - * [Activity](https://plantuml.com/activity-diagram-beta), - * [Component](https://plantuml.com/component-diagram), - * [State](https://plantuml.com/state-diagram), - * [Object](https://plantuml.com/object-diagram), - * [Deployment](https://plantuml.com/deployment-diagram), - * [Timing](https://plantuml.com/timing-diagram), - * [Network](https://plantuml.com/nwdiag). -* ``wireframe`` - for [Wireframe diagrams](https://plantuml.com/salt) -* ``gantt`` - for [Gantt diagrams](https://plantuml.com/gantt-diagram) -* ``mindmap`` - for [Mind Maps](https://plantuml.com/mindmap-diagram) -* ``wbs`` - for [Work Breakdown Structures](https://plantuml.com/wbs-diagram) - -###### UML - -**Sequence** - -Fenced block: - - ```uml - Alice -> Bob: Authentication Request - Bob --> Alice: Authentication Response - ``` - -Diagram: - -```uml -Alice -> Bob: Authentication Request -Bob --> Alice: Authentication Response -``` - -**Component** - -Component diagram with links to component pages. - - -Fenced block: - - ```uml - package Core { - component Common [[https://github.com/Nasdanika/core/tree/master/common]] - } - - package HTML { - component HTML as html [[https://github.com/Nasdanika/html/tree/master/html]] - [html] ..> [Common] - } - ``` - -Diagram: - -```uml -package Core { - component Common [[https://github.com/Nasdanika/core/tree/master/common]] -} - -package HTML { - component HTML as html [[https://github.com/Nasdanika/html/tree/master/html]] - [html] ..> [Common] -} -``` - -**Wireframe** - -Fenced block: - - ```wireframe - { - Just plain text - [This is my button] - () Unchecked radio - (X) Checked radio - [] Unchecked box - [X] Checked box - "Enter text here " - ^This is a droplist^ - } - ``` - - -Diagram: - -```wireframe -{ - Just plain text - [This is my button] - () Unchecked radio - (X) Checked radio - [] Unchecked box - [X] Checked box - "Enter text here " - ^This is a droplist^ -} -``` - -**Gantt** - -Fenced block: - - ```gantt - [Prototype design] lasts 15 days and links to [[https://docs.nasdanika.org/index.html]] - [Test prototype] lasts 10 days - -- All example -- - [Task 1 (1 day)] lasts 1 day - [T2 (5 days)] lasts 5 days - [T3 (1 week)] lasts 1 week - [T4 (1 week and 4 days)] lasts 1 week and 4 days - [T5 (2 weeks)] lasts 2 weeks - ``` - -Diagram: - -```gantt -[Prototype design] lasts 15 days and links to [[https://docs.nasdanika.org/index.html]] -[Test prototype] lasts 10 days --- All example -- -[Task 1 (1 day)] lasts 1 day -[T2 (5 days)] lasts 5 days -[T3 (1 week)] lasts 1 week -[T4 (1 week and 4 days)] lasts 1 week and 4 days -[T5 (2 weeks)] lasts 2 weeks -``` - -**Mind Map** - -Fenced block: - - ```mindmap - * Debian - ** [[https://ubuntu.com/ Ubuntu]] - *** Linux Mint - *** Kubuntu - *** Lubuntu - *** KDE Neon - ** LMDE - ** SolydXK - ** SteamOS - ** Raspbian with a very long name - *** Raspmbc => OSMC - *** Raspyfi => Volumio - ``` - -Diagram: - -```mindmap -* Debian -** [[https://ubuntu.com/ Ubuntu]] -*** Linux Mint -*** Kubuntu -*** Lubuntu -*** KDE Neon -** LMDE -** SolydXK -** SteamOS -** Raspbian with a very long name -*** Raspmbc => OSMC -*** Raspyfi => Volumio -``` - -**WBS** - -WBS elements can have links. This type of diagram can also be used to display organization structure. - - ```wbs - * [[https://docs.nasdanika.org/index.html Business Process Modelling WBS]] - ** Launch the project - *** Complete Stakeholder Research - *** Initial Implementation Plan - ** Design phase - *** Model of AsIs Processes Completed - **** Model of AsIs Processes Completed1 - **** Model of AsIs Processes Completed2 - *** Measure AsIs performance metrics - *** Identify Quick Wins - ** Complete innovate phase - ``` - -Fenced block: - - -Diagram: - -```wbs -* [[https://docs.nasdanika.org/index.html Business Process Modelling WBS]] -** Launch the project -*** Complete Stakeholder Research -*** Initial Implementation Plan -** Design phase -*** Model of AsIs Processes Completed -**** Model of AsIs Processes Completed1 -**** Model of AsIs Processes Completed2 -*** Measure AsIs performance metrics -*** Identify Quick Wins -** Complete innovate phase -``` - -#### Mermaid - -You can define [Mermaid](https://mermaid-js.github.io/mermaid/#/) diagrams in ``mermaid`` fenced blocks: - - ```mermaid - flowchart LR - Alice --> Bob & Chuck --> Deb - ``` - -results in this diagram: - -```mermaid -flowchart LR - Alice --> Bob & Chuck --> Deb -``` - -##### Loading from a resource - -It is also possible to load a diagram definition from a resource resolved relative to the model resource: - - ```mermaid-resource - sequence.mermaid - ``` - -### Extensions - -* [Table of contents](https://github.com/vsch/flexmark-java/wiki/Table-of-Contents-Extension) - add ``[TOC]`` to the document as explained in the documentation. This extension will create a table of contents from markdown headers. -* [Footnotes](https://github.com/vsch/flexmark-java/wiki/Footnotes-Extension) -* Strikethrough: ``~~strikethrough~~``-> ~~strikethrough~~ -* Subscript: ``H~2~O`` -> H~2~0 -* Superscript: ``2^5^ = 32`` -> 2^5^ = 32 - -## Failing on errors - -``-r=-1`` command line option means "don't fail on page errors" such as: - -* Blank pages -* Broken internal links -* Missing resources - -Missing resources are reported on pages using danger alert blocks. - -If you want to prevent deployment of a site with page errors, remove the option or set it to the expected number of errors - there might be "known errors" which you are OK to live with. - -## Upgrading NSD CLI version - -When a new version of Nasdanika CLI is released you may update lines 33 and 35 in ``site.yml`` to point to the new distribution. - -## Adding support for a new documentation format - -To add a new documentation format: - -* Create a Maven module -* Create a documentation [capability](https://docs.nasdanika.org/core/capability/index.html) factory class, see [MarkdownDocumentationFactory](https://github.com/Nasdanika/core/blob/master/exec/src/main/java/org/nasdanika/exec/util/MarkdownDocumentationFactory.java) -* Register it in ``module-info.java`` - [example](https://github.com/Nasdanika/core/blob/master/exec/src/main/java/module-info.java) -* Build a custom CLI with the above module as a dependency. See [Demo CLI](https://github.com/Nasdanika-Demos/cli) for an example. -* Build a distribution, deploy to a web location, and update ``site.yml`` lines 33 and 35. - -## Interoperability with Confluence Drawio plugin -If you use Confluence you may keep diagrams on Confluence with diagram-level descriptions and generate detailed element-level documentation sites with Nasdanika CLI. -To do so: - -* Create a personal access token -* On the page which hosts your diagram go to attachments and copy the download link for your diagram file -* Use ``curl -H "Authorization: Bearer " -o diagram.drawio`` command to download the diagram before generating a documentation site - -Note: I tested this approach with on-prem Confluence - it worked fine, but I couldn't make it work with the Cloud Confluence free plan. - -## Next steps - -This section outlines possible next steps once you have a site generated from a diagram or a set of diagrams. - -### Executable diagrams - -You may make the diagrams executable. Details and demos are coming soon. - -#### Scripted processors - -#### Dynamic proxy - -#### HTTP Routes - -### Semantic mapping - -You can also "upgrade" to semantic mapping as explained in the [Visual Communication Continuum](https://medium.com/nasdanika/visual-communication-continuum-4946f44ba853) Medium story and [Beyond Diagrams](https://leanpub.com/beyond-diagrams) book. diff --git a/create-diagram.md b/create-diagram.md new file mode 100644 index 0000000..cb82a64 --- /dev/null +++ b/create-diagram.md @@ -0,0 +1 @@ +TODO... \ No newline at end of file diff --git a/diagram.drawio b/diagram.drawio index 1ab267c..84f00a2 100644 --- a/diagram.drawio +++ b/diagram.drawio @@ -1 +1 @@ -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 \ No newline at end of file +1ZZNc5swEIZ/jY/ugDBue0xs52PGnknrQ3vryGgDqiXECGHs/PoKs8Rg4cTJpDPOCfTu6uvZlx0GwURubzXNkoViIAbEY9tBMB0Q4ofe2D4qZVcrJPS/1kqsOcOsg7DkT4Cih2rBGeSdRKOUMDzripFKU4hMR6Naq7Kb9qhEd9eMxuAIy4gKV/3FmUlQ9cffD4E74HGCW38jeD9Jm2S8SZ5QpsqWFMwGwUQrZeo3tfpbXYB4gq4sxX0ewlPRUMNjLf2cXU0Xsy+S1bEG4mFFuZ2AsFW4qYf2BVfuRD1+zEFDatoHvjkxgTz9Ka6G9+rHfB3K3wVZb7J4iKtsqCgQ3JTTWFMpeRrbwINWEeQ5kjC7Bm9eciloakfXUcIFm9OdKqpj5IZG62Z0rSG3znhozugfSQtaGc6zqp2mDbqIVEJipMAZkRKCZjlf7Tf39kpqKE9B4xgvAdrA9iQdv0X6FpQEo3c2BSeMsdro92EYolAe3DNukpKWccJGpOjY+Hlt0i4m1uOkZRru9lKuedhz0DEQ68zrlr6/YG9jfRbb095ygTcdxeXrj/r4jt7O9+jb6cM90UANWA2590CP9ilDBOyA74ZfhK9VkTJgyLhMuIFlRqMqWtr+2y3BWcB7q+662u+6OuhhTnqYv8PSr7WrXocETvfBfqN0VRnYgFBZ80FcpJm3R859wdy9zeMd5j4P7chBO+crTTWn6eXjDLzXcfb59v/hDB2cC5p9CmuOyKWxHDssJyrNC/kZaIZnfOgfRdMOD3+Z+1jrZz2Y/QM= \ No newline at end of file diff --git a/diagrammer.md b/diagrammer.md new file mode 100644 index 0000000..cb82a64 --- /dev/null +++ b/diagrammer.md @@ -0,0 +1 @@ +TODO... \ No newline at end of file diff --git a/page-template.yml b/page-template.yml index 45f4d03..0ea6fbc 100644 --- a/page-template.yml +++ b/page-template.yml @@ -1,24 +1,25 @@ bootstrap.Page: cdn: true - theme: Cerulean + theme: Litera name: Application Page Template language: EN stylesheets: - https://cdn.jsdelivr.net/gh/Nasdanika/html@master/model/app.gen/web-resources/css/app.css - https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.15.1/css/all.min.css - https://cdn.jsdelivr.net/npm/jstree@3.3.11/dist/themes/default/style.min.css - - https://cdn.jsdelivr.net/npm/github-markdown-css@5.1.0/github-markdown.min.css - - https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11.3.1/build/styles/default.min.css - - https://cdn.jsdelivr.net/npm/bootstrap-vue@2.21.2/dist/bootstrap-vue.css + - https://cdn.jsdelivr.net/npm/github-markdown-css@5.7.0/github-markdown.min.css + - https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11.9.0/build/styles/default.min.css + - https://cdn.jsdelivr.net/npm/bootstrap-vue@2.23.0/dist/bootstrap-vue.css scripts: - https://cdn.jsdelivr.net/gh/Nasdanika/html@master/model/app.gen/web-resources/js/common.js - https://cdn.jsdelivr.net/gh/Nasdanika/html@master/model/app.gen/web-resources/js/dark-head.js - https://cdn.jsdelivr.net/npm/jstree@3.3.11/dist/jstree.min.js - - https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11.3.1/build/highlight.min.js + - https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11.9.0/build/highlight.min.js - https://cdn.jsdelivr.net/npm/vue@2.6.14/dist/vue.min.js - - https://cdn.jsdelivr.net/npm/bootstrap-vue@2.21.2/dist/bootstrap-vue.min.js + - https://cdn.jsdelivr.net/npm/bootstrap-vue@2.23.0/dist/bootstrap-vue.min.js - https://cdn.jsdelivr.net/gh/Nasdanika/html@master/model/app.gen/web-resources/js/components/table.js - https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.min.js + - https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/languages/groovy.min.js head: # Google analytics content.Text: |+2 diff --git a/root-action.yml b/root-action.yml index 8c47af6..73210f1 100644 --- a/root-action.yml +++ b/root-action.yml @@ -1,6 +1,6 @@ Action: icon: https://docs.nasdanika.org/images/nasdanika-logo.png - text: Nasdanika Templates + text: Nasdanika Demos # location: https://github.com/Nasdanika-Demos - breaks the site in 2024.8.0, will be fixed in subsequent releases children: - Action: @@ -22,4 +22,4 @@ Action: - Action: text: Source icon: fab fa-github - location: https://github.com/Nasdanika-Templates/drawio-site + location: https://github.com/Nasdanika-Demos/general-purpose-executable-diagrams-story