Merge pull request #3647 from sandstorm-io/docs-delete-graphviz

Docs: delete graphviz

.github/workflows/doc-ci.yml

@@ -18,7 +18,7 @@ jobs:
     - name: install dependencies
       run: |
         sudo apt-get update
-        sudo apt-get install -y git virtualenv graphviz
+        sudo apt-get install -y git virtualenv
         virtualenv tmp/docs-virtualenv
         tmp/docs-virtualenv/bin/pip install -r docs/requirements.txt
     - name: build docs

docs/generate.sh

@@ -42,7 +42,7 @@ my_git() {
 assert_dependencies() {
   if [ "${DO_SETUP}" == "yes" ] ; then
     if ! (which dot && which virtualenv); then
-      sudo apt-get install -y git virtualenv graphviz
+      sudo apt-get install -y git virtualenv
     fi
     if [ ! -e "$OUTPUT_DIR/.git" ] ; then
       my_git clone --branch gw-pages --depth 1 "$SANDSTORM_DOC_URL" "$OUTPUT_DIR"

docs/requirements.txt

@@ -1,2 +1,3 @@
+jinja2==3.0.3
+markdown==3.3.7
 mkdocs==1.0.4
-mkdocs-markdown-graphviz==1.3

docs/using/how-it-works.md

@@ -22,7 +22,12 @@ and the grain occur over the Cap'n Proto WebSession format.  With existing
 applications, the Sandstorm HTTP bridge is used to translate between Cap'n
 Proto and HTTP.
 
-```graphviz dot communication_overview_http_app.svg
+![Diagram with HTTP Bridge](communication_overview_http_app.svg)
+
+<!--
+NOTE: Included SVGs on this page were created in Graphviz DOT language, and are provided here for convenience in regenerating the files if needed.
+
+graphviz dot communication_overview_http_app.svg
     graph communication_overview_http_app {
       rankdir=LR;
       compound=true;
@@ -47,12 +52,15 @@ Proto and HTTP.
       websession -- bridge;
       bridge -- app;
     }
-```
+-->
 
 When an application can speak Cap'n Proto directly to Sandstorm, the HTTP
 bridge is not needed.
 
-```graphviz dot communication_overview_native_app.svg
+![Diagram without HTTP Bridge](communication_overview_native_app.svg)
+
+<!--
+graphviz dot communication_overview_native_app.svg
     graph communication_overview_native_app {
       rankdir=LR;
       compound=true;
@@ -75,4 +83,4 @@ bridge is not needed.
       proxy -- websession;
       websession -- app;
     }
-```
+-->

mkdocs.yml

@@ -7,7 +7,6 @@ theme:
 repo_url: https://github.com/sandstorm-io/sandstorm
 edit_uri: edit/master/docs/
 markdown_extensions:
-    - mkdocs_markdown_graphviz
     - admonition
 extra_css:
     - "extra.css"