stg deploy

.gitea/workflows/build-and-publish.yaml

@@ -2,7 +2,7 @@
 name: Build and publish container images
 
 on:
-- workflow_dispatch
+  workflow_dispatch: { }
   # push:
   #   branches:
   #   - master
@@ -47,4 +47,4 @@ jobs:
         # linux/arm/v6
         build-args: |
           DOC_UTILS_VERSION=0.2
-          NGINX_VERSION=1.25
+          NGINX_VERSION=1.25-alpine-slim

.gitea/workflows/build.yaml

@@ -2,7 +2,7 @@
 name: Build container images
 
 on:
-- workflow_dispatch
+  workflow_dispatch: { }
   # push:
   #   branches:
   #   - master
@@ -38,4 +38,4 @@ jobs:
         # linux/arm/v6
         build-args: |
           DOC_UTILS_VERSION=0.2
-          NGINX_VERSION=1.25
+          NGINX_VERSION=1.25-alpine-slim

.gitea/workflows/deploy-prd.yaml

@@ -2,7 +2,10 @@
 name: Deploy staging to production environment
 
 on:
-- workflow_dispatch
+  workflow_dispatch: { }
+  # push:
+  #   branches:
+  #   - master
 
 jobs:
   tag-image:

.gitea/workflows/deploy-stg.yaml

@@ -2,7 +2,7 @@
 name: Deploy latest to staging environment
 
 on:
-# - workflow_dispatch
+  workflow_dispatch: { }
   push:
     branches:
     - master

Dockerfile

@@ -5,8 +5,12 @@ ARG NGINX_VERSION
 FROM gitea.jbrumond.me/doc-utils/utils:${DOC_UTILS_VERSION} AS build_stage
 WORKDIR /workspace
 
+COPY docs/ /workspace/docs
+COPY layouts/ /workspace/layouts
+COPY partials/ /workspace/partials
+COPY config.yaml metadata.json /workspace/
+
 # build website from source files
-COPY docs layouts partials config.yaml metadata.json /workspace/
 RUN mkdir /workspace/www
 RUN docs2website config.yaml
 
@@ -16,10 +20,9 @@ FROM nginx:${NGINX_VERSION} AS deploy_stage
 EXPOSE 80
 
 # copy actual web content built above
-COPY --from=build_stage /workspace/www/ /usr/share/nginx/html
-RUN chmod -R +rX /usr/share/nginx/html
+COPY --from=build_stage --chown=nginx:nginx /workspace/www/ /usr/share/nginx/html
 
 # nginx config files
-COPY conf/nginx.conf /etc/nginx/nginx.conf
-COPY conf/default.conf /etc/nginx/conf.d/default.conf
-COPY conf/mime.types /etc/nginx/mime.types
+COPY --chown=nginx:nginx conf/nginx.conf /etc/nginx/nginx.conf
+COPY --chown=nginx:nginx conf/default.conf /etc/nginx/conf.d/default.conf
+COPY --chown=nginx:nginx conf/mime.types /etc/nginx/mime.types

config.yaml

@@ -1,7 +1,7 @@
 
 metadata: ./metadata.json
 
-base_url: http://localhost:46137
+# base_url: http://localhost:46137
 
 # Input Configuration (where your documents are)
 input:

docs/markdown2html/markdown-format.md

@@ -135,6 +135,35 @@ Indentation in `<dl>` blocks must two consecutive spaces; Other indentation styl
 
 
 
+## Section Blocks {#sections}
+
+HTML `<section>` elements can be rendered around portions of your document by fencing them in triple-bang blocks (i.e. preceded and followed by `!!!`).
+
+```md
+!!!
+This is inside a `<section>` element
+!!!
+```
+
+!!!! {.markdown-example-output}
+!!!
+This is inside a `<section>` element
+!!!
+!!!!
+
+Similarly to fenced code blocks, you can nest these fenced blocks by adding additional bang (`!`) characters to the opening and closing lines.
+
+These blocks also support [attribute annotations](#attribute-annotations) on the first line:
+
+```md
+!!! {.editors-note :role=note}
+**Editor's Note:**
+Section blocks can be used to create special call-out blocks
+!!!
+```
+
+
+
 
 ## Feather Icons {#feather}
 
@@ -243,7 +272,19 @@ _todo_
 
 ## QR Codes {#qr-codes}
 
-_todo_
+QR Codes can be rendered using fenced blocks.
+
+````md
+```qrcode :small
+https://doc-utils.jbrumond.me/markdown2html/markdown-format.html
+```
+````
+
+!!! {.markdown-example-output}
+```qrcode :small
+https://doc-utils.jbrumond.me/markdown2html/markdown-format.html
+```
+!!!
 
 
 
@@ -308,7 +349,7 @@ This is another line of sample output
 
 Some markdown elements allow for attributes to be appended in a curly-brace (`{ }`) wrapped block.
 
-The braces contain a space-delimeted list attributes to assign to the rendered attribute, identified as either:
+The braces contain a space-delimited list of attributes to assign to the rendered element, identified as either:
 
 - An `id` attribute, prefixed by a `#` character,
 - A `class` attribute value, prefixed by `.` character,

layouts/main.html

@@ -4,6 +4,7 @@
 	<meta charset="UTF-8">
 	<title>{{ page.title }}</title>
 	<base href="{{{ page_url }}}">
+	<meta name="viewport" content="width=device-width, initial-scale=1" />
 	<link rel="stylesheet" href="/_vendor/open-sans/open-sans-v34.css">
 	<link rel="stylesheet" href="/_vendor/katex/katex.min.css">
 	<link rel="stylesheet" href="/_assets/colors.css">

layouts/preview-color-themes.html

@@ -4,6 +4,7 @@
 	<meta charset="UTF-8">
 	<title>{{ page.title }}</title>
 	<base href="{{{ page_url }}}">
+	<meta name="viewport" content="width=device-width, initial-scale=1" />
 	<link rel="stylesheet" href="/_vendor/open-sans/open-sans-v34.css">
 	<link rel="stylesheet" href="/_vendor/katex/katex.min.css">
 	<link rel="stylesheet" href="/_assets/colors.css">

metadata.json

@@ -1,7 +1,7 @@
 {
   "last_build": {
-    "time": "2023-05-27T18:14:11.014-07:00",
-    "config_hash": "iZVIBu7zTewWsPUbEDMgC+ROqW2Q9n0cmgGuBh93jjvm/M2B3QjsdN6cYsSZ0yO4xx5Sk2wrcOkpQJp1Urq0Fg=="
+    "time": "2023-08-19T17:17:00.889-07:00",
+    "config_hash": "uE1vXrV0+DVs3fpCIPIUlu7niYXyfxOe0JMGwmlUN/RzI5jJMW7A+8B5V2tK0CKdGVjmtwo+weTWXgF9N9JBIw=="
   },
   "files": {
     "/_assets/theme-animation.css": {
@@ -14,9 +14,9 @@
       "last_build_hash": "XtOPnd/zOEAr0DByWuvGfJyTHsdDIXTiZny5g2M2gItpdw/Ce8jaJ1hCMC72AIjkelYl1icrsqAfjNs6dtnn+A==",
       "last_updated_time": "2023-05-19T00:06:52.103-07:00"
     },
-    "/_assets/forms-inputs.css": {
+    "/_assets/figures.css": {
       "first_seen_time": "2023-05-19T00:06:52.103-07:00",
-      "last_build_hash": "vKON+tNIef2LVqhNv6IlMaHZW7gr40F7lbd9mLWYg9k0Kqrn1Nyon1Nf3t63hjNq/V6IAeV7+9svHCJqIiGj5g==",
+      "last_build_hash": "GWqAs7DM3p2pZe37WHjRTBvPs/ft77X7v8hLb6AjU3nwEoSwgqyhvXnHSycmfXKAiQj9745tHnnpVU7gSbfS4Q==",
       "last_updated_time": "2023-05-19T00:06:52.103-07:00"
     },
     "/_assets/prism.css": {
@@ -24,14 +24,9 @@
       "last_build_hash": "wULo4ZHx6x9XHCZVV0v1Jp9dZ/tP2UiGgp3S61FJsebGoWzQIty/DF2Oyoo5cuVn+3Sg21P5clcacbF9SL04nw==",
       "last_updated_time": "2023-05-19T00:06:52.103-07:00"
     },
-    "/_assets/figures.css": {
+    "/_assets/forms-inputs.css": {
       "first_seen_time": "2023-05-19T00:06:52.103-07:00",
-      "last_build_hash": "GWqAs7DM3p2pZe37WHjRTBvPs/ft77X7v8hLb6AjU3nwEoSwgqyhvXnHSycmfXKAiQj9745tHnnpVU7gSbfS4Q==",
-      "last_updated_time": "2023-05-19T00:06:52.103-07:00"
-    },
-    "/_assets/extras.js": {
-      "first_seen_time": "2023-05-19T00:06:52.103-07:00",
-      "last_build_hash": "NH5RPkRjdvMpOm4QppT7blGPGdNK5b2J+cQ6Wsv22cmDfm3b7Tc9GeZn4qd5D+fTSoGoESNarEnN+sRV1ihrRA==",
+      "last_build_hash": "vKON+tNIef2LVqhNv6IlMaHZW7gr40F7lbd9mLWYg9k0Kqrn1Nyon1Nf3t63hjNq/V6IAeV7+9svHCJqIiGj5g==",
       "last_updated_time": "2023-05-19T00:06:52.103-07:00"
     },
     "/_assets/colors.css": {
@@ -39,9 +34,9 @@
       "last_build_hash": "UteDx72dZXzdJcv/IO6dluhgiN9ddwTn1GDGek4F7cYPRYQv/RDD4cuI97/Yxf+89ykpoKcmHHqt6Tudxi1H8A==",
       "last_updated_time": "2023-05-19T00:06:52.103-07:00"
     },
-    "/_assets/color-theme-preview.css": {
+    "/_assets/extras.js": {
       "first_seen_time": "2023-05-19T00:06:52.103-07:00",
-      "last_build_hash": "ggmN8fAn+W3ejVa+WjwgwCrqe/TD2lr3kmG77TUHrwDAuE8wOeWEmPV/YzhD9f57eYIA+ZHypp9s797CDjpbpA==",
+      "last_build_hash": "NH5RPkRjdvMpOm4QppT7blGPGdNK5b2J+cQ6Wsv22cmDfm3b7Tc9GeZn4qd5D+fTSoGoESNarEnN+sRV1ihrRA==",
       "last_updated_time": "2023-05-19T00:06:52.103-07:00"
     },
     "/_assets/breadcrumb.css": {
@@ -49,6 +44,11 @@
       "last_build_hash": "B3ajZA+BTRFIWfk6CA/Sa71n8MFp5GPB9TWsNLi0VrIV+N0hWiAJvSvnhV2BgHzRXooT1WWotLne7hgDi5qJcw==",
       "last_updated_time": "2023-05-19T00:06:52.103-07:00"
     },
+    "/_assets/color-theme-preview.css": {
+      "first_seen_time": "2023-05-19T00:06:52.103-07:00",
+      "last_build_hash": "ggmN8fAn+W3ejVa+WjwgwCrqe/TD2lr3kmG77TUHrwDAuE8wOeWEmPV/YzhD9f57eYIA+ZHypp9s797CDjpbpA==",
+      "last_updated_time": "2023-05-19T00:06:52.103-07:00"
+    },
     "/_vendor/open-sans/open-sans-v34.css": {
       "first_seen_time": "2023-05-19T00:06:52.103-07:00",
       "last_build_hash": "8rNJHIlE33r84MLmf+pOCU68Lr1iZYUeFIpZ8d2xB4U3cEV/W1ejc/JStY/MXCxLSOURx5KdULaKiP1klKGoAQ==",
@@ -99,20 +99,15 @@
       "last_build_hash": "z4PhNX7vuL3xVChQ1m2AB9Yg5AULVxXcg/SpIdNs6c5H0NE8XYXysP+DGNKHfuwvY7kxvUdBeoGlODJ6+SfaPg==",
       "last_updated_time": "2023-05-19T00:06:52.103-07:00"
     },
-    "/markdown2html/index.md": {
-      "first_seen_time": "2023-05-19T00:06:52.103-07:00",
-      "last_build_hash": "IVJ7BVd9RqXGiZjl+57k9itDrZy6WIG/TjvkK/r7DqkIzlCIbABtyZfmdjVoFgdliJwSAwnMTFikbKqUV5w5zQ==",
-      "last_updated_time": "2023-05-19T00:06:52.103-07:00"
-    },
     "/markdown2html/building-from-source.md": {
       "first_seen_time": "2023-05-19T00:06:52.103-07:00",
       "last_build_hash": "Y0Gct7zFDfLxzXqRph3RjfZ7OjGu5s1cac/R4E1dG9XZiyDOiFYl6EA1EqCfM6qhBSoxcpIYNFP9+TXxo09GFw==",
       "last_updated_time": "2023-05-19T00:06:52.103-07:00"
     },
-    "/docs2website/index.md": {
+    "/markdown2html/index.md": {
       "first_seen_time": "2023-05-19T00:06:52.103-07:00",
-      "last_build_hash": "oGqQtPmVdLea18qkpFrA6XayZd6IFrlesgoo9bxzgx+ibbMK4cJ//jsQyPGRc6QuW2daJZS2gnPo4QygHh65vA==",
-      "last_updated_time": "2023-05-27T17:50:24.808-07:00"
+      "last_build_hash": "IVJ7BVd9RqXGiZjl+57k9itDrZy6WIG/TjvkK/r7DqkIzlCIbABtyZfmdjVoFgdliJwSAwnMTFikbKqUV5w5zQ==",
+      "last_updated_time": "2023-05-19T00:06:52.103-07:00"
     },
     "/docs2website/configuration.md": {
       "first_seen_time": "2023-05-19T00:06:52.103-07:00",
@@ -124,6 +119,11 @@
       "last_build_hash": "8eN9+TPZCdHz8zvZFRHZOIKOTkc3jGt/vaXTmlJNwKMYVw14eQB5MYn/DwEDUkg5X5vtAKNO6knlfdsyv5ODuA==",
       "last_updated_time": "2023-05-27T17:48:44.437-07:00"
     },
+    "/docs2website/index.md": {
+      "first_seen_time": "2023-05-19T00:06:52.103-07:00",
+      "last_build_hash": "oGqQtPmVdLea18qkpFrA6XayZd6IFrlesgoo9bxzgx+ibbMK4cJ//jsQyPGRc6QuW2daJZS2gnPo4QygHh65vA==",
+      "last_updated_time": "2023-05-27T17:50:24.808-07:00"
+    },
     "/docs2website/building-from-source.md": {
       "first_seen_time": "2023-05-19T00:06:52.103-07:00",
       "last_build_hash": "nR+ORQrII8uVXBbNEZGWLTSR7lDW8faZlVK50WjZd9esf47rofpLoHSBABf77OKvFlrPD3RWyKVwIQaWC+U9VA==",
@@ -139,20 +139,20 @@
       "last_build_hash": "7/5Kwma++r3MFm7KET9N4E2+f5Fbm/LPZoZLIakt6Tj68WnjQ0ygx1kmOuLaqhq5hlFtyvUmqUWVfvt4QhT3+A==",
       "last_updated_time": "2023-05-27T17:55:56.863-07:00"
     },
-    "/docs2website/programatic-use.md": {
-      "first_seen_time": "2023-05-19T00:06:52.103-07:00",
-      "last_build_hash": "oy6eFcHsBwyhv8hI10jbmi392GGBgo5MsR68qP8wN7xu0ny+7BDUcJyp2KK28wwASnDd/zSOSgEx/9rmxG/O6w==",
-      "last_updated_time": "2023-05-19T00:06:52.103-07:00"
-    },
     "/color-themes/preview.md": {
       "first_seen_time": "2023-05-19T00:06:52.103-07:00",
       "last_build_hash": "zMiA4rvAFVXAI2fx6VCFXavfkZSuVxO7bH5hxIU79Tup8Q6lOjXrzT9CPsHYBuNajVDwZIPZ126fKiwM6TSNFQ==",
       "last_updated_time": "2023-05-19T00:06:52.103-07:00"
     },
+    "/docs2website/programatic-use.md": {
+      "first_seen_time": "2023-05-19T00:06:52.103-07:00",
+      "last_build_hash": "oy6eFcHsBwyhv8hI10jbmi392GGBgo5MsR68qP8wN7xu0ny+7BDUcJyp2KK28wwASnDd/zSOSgEx/9rmxG/O6w==",
+      "last_updated_time": "2023-05-19T00:06:52.103-07:00"
+    },
     "/markdown2html/markdown-format.md": {
       "first_seen_time": "2023-05-19T00:06:52.103-07:00",
-      "last_build_hash": "i/quZAVVMVDaTsq44d4eezoddkUsRCdydU609LkbMqEt1397zHsix2e1AMM4D+Lgzxxk6JIhqX1fSOO/1+3VKw==",
-      "last_updated_time": "2023-05-27T18:14:11.014-07:00"
+      "last_build_hash": "u7W15JZzkqveONMa6ErF/EEBlvO3jKn4hHmM2HNoY6bpqSElWx8RiEOXYSyPINR7F+YncCqubHTta/NOYfky4g==",
+      "last_updated_time": "2023-08-19T16:54:55.074-07:00"
     },
     "/color-themes/schema/v1.yaml": {
       "first_seen_time": "2023-05-19T00:06:52.103-07:00",