stg deploy

.drone.yml

@@ -1,133 +0,0 @@
----
-kind: pipeline
-type: kubernetes
-name: build
-
-trigger:
-  event: [ push ]
-  branch: [ master ]
-
-platform:
-  os: linux
-  arch: arm64
-
-node_selector:
-  kubernetes.io/os: linux
-  kubernetes.io/arch: arm64
-
-steps:
-- name: build-website
-  image: gitea.home.jbrumond.me/doc-utils/utils:0.1.1
-  commands:
-  - docs2website config.yaml
-- name: build-docker
-  image: plugins/docker
-  settings:
-    registry: https://gitea.home.jbrumond.me
-    username: drone
-    password:
-      from_secret: gitea-jbrumond-me-password
-    repo: gitea.home.jbrumond.me/doc-utils/docs
-    cache_from: gitea.home.jbrumond.me/doc-utils/docs:ci
-    tags:
-    - ci
-
----
-kind: pipeline
-type: kubernetes
-name: deploy-stg
-
-trigger:
-  event: [ promote ]
-  target: [ stg ]
-
-platform:
-  os: linux
-  arch: arm64
-
-node_selector:
-  kubernetes.io/os: linux
-  kubernetes.io/arch: arm64
-
-steps:
-- name: build-website
-  image: gitea.home.jbrumond.me/doc-utils/utils:0.1.1
-  commands:
-  - docs2website config.yaml
-- name: build-and-publish
-  image: plugins/docker
-  settings:
-    registry: https://gitea.home.jbrumond.me
-    username: drone
-    password:
-      from_secret: gitea-jbrumond-me-password
-    repo: gitea.home.jbrumond.me/doc-utils/docs
-    cache_from: gitea.home.jbrumond.me/doc-utils/docs:ci
-    build_args:
-    - OS=linux
-    - ARCH=arm64
-    tags:
-    - stg
-
-- name: deploy-stg
-  image: gitea.home.jbrumond.me/images/kubectl:1.24
-  pull: always
-  environment:
-    KUBERNETES_SERVER: https://nephthys:6443
-    KUBERNETES_TOKEN:
-      from_secret: kubernetes-web-ns-service-account-token
-    KUBERNETES_CERT:
-      from_secret: kubernetes-web-ns-service-account-cert
-  commands:
-  - /bin/kubectl-setup
-  - kubectl -n web set image "deployment/doc-utils-stg-deploy" "doc-utils-stg=gitea.home.jbrumond.me/doc-utils/docs:stg"
-  - kubectl -n web rollout restart "deployment/doc-utils-stg-deploy"
-  - kubectl -n web rollout status "deployment/doc-utils-stg-deploy"
-
----
-kind: pipeline
-type: kubernetes
-name: deploy-prod
-
-trigger:
-  event: [ promote ]
-  target: [ prod ]
-
-steps:
-- name: tag-image
-  image: gitea.home.jbrumond.me/images/docker
-  pull: always
-  volumes:
-  - name: dockersock
-    path: /var/run/
-  environment:
-    DOCKER_REGISTRY: https://gitea.home.jbrumond.me
-    DOCKER_USER: drone
-    DOCKER_PASS:
-      from_secret: gitea-jbrumond-me-password
-  commands:
-  - /bin/docker-setup
-  - docker pull gitea.home.jbrumond.me/doc-utils/docs:stg
-  - docker tag gitea.home.jbrumond.me/doc-utils/docs:stg gitea.home.jbrumond.me/doc-utils/docs:prod
-  - docker push gitea.home.jbrumond.me/doc-utils/docs:prod
-
-- name: deploy-prod
-  image: gitea.home.jbrumond.me/images/kubectl:1.24
-  pull: always
-  environment:
-    KUBERNETES_SERVER: https://nephthys:6443
-    KUBERNETES_TOKEN:
-      from_secret: kubernetes-web-ns-service-account-token
-    KUBERNETES_CERT:
-      from_secret: kubernetes-web-ns-service-account-cert
-  commands:
-  - /bin/kubectl-setup
-  - kubectl -n web set image "deployment/doc-utils-prod-deploy" "doc-utils-prod=gitea.home.jbrumond.me/doc-utils/docs:prod"
-  - kubectl -n web rollout restart "deployment/doc-utils-prod-deploy"
-  - kubectl -n web rollout status "deployment/doc-utils-prod-deploy"
-
-volumes:
-- name: dockersock
-  host:
-    path: /var/run/
-

.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,10 +2,10 @@
 name: Build container images
 
 on:
-# - workflow_dispatch
-  push:
-    branches:
-    - master
+  workflow_dispatch: { }
+  # push:
+  #   branches:
+  #   - master
 
 jobs:
   build:
@@ -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

@@ -0,0 +1,49 @@
+
+name: Deploy staging to production environment
+
+on:
+  workflow_dispatch: { }
+  # push:
+  #   branches:
+  #   - master
+
+jobs:
+  tag-image:
+    runs-on: ubuntu-latest
+    container:
+      image: catthehacker/ubuntu:act-latest
+    steps:
+    - name: Check out the repo
+      uses: actions/checkout@v3
+
+    - name: Log in to the Container registry
+      uses: docker/login-action@v2
+      with:
+        registry: gitea.jbrumond.me
+        username: ${{ secrets.REGISTRY_USER }}
+        password: ${{ secrets.REGISTRY_TOKEN }}
+
+    - name: Tag "stg" with "prod"
+      run: |
+        docker pull gitea.jbrumond.me/doc-utils/docs-web:stg
+        docker tag gitea.jbrumond.me/doc-utils/docs-web:stg gitea.jbrumond.me/doc-utils/docs-web:prod
+        docker push gitea.jbrumond.me/doc-utils/docs-web:prod
+
+  deploy:
+    runs-on: ubuntu-latest
+    container:
+      image: gitea.jbrumond.me/images/kubectl:1.28
+    needs:
+    - tag-image
+    env:
+      KUBERNETES_SERVER: https://nephthys.local.jbrumond.me:6443
+      KUBERNETES_TOKEN: ${{ secrets.K8S_WEB_NS_SERVICE_ACCT_TOKEN }}
+      KUBERNETES_CERT: ${{ secrets.K8S_WEB_NS_SERVICE_ACCT_CERT }}
+    steps:
+    - name: Configure kubectl and set credentials
+      run: /bin/kubectl-setup
+    - name: Deploy "prod" image to kubernetes production (doc-utils.jbrumond.me)
+      run: |
+        kubectl -n web set image "deployment/doc-utils-prod-deploy" "doc-utils-prod=gitea.jbrumond.me/doc-utils/docs-web:prod"
+        kubectl -n web rollout restart "deployment/doc-utils-prod-deploy"
+        kubectl -n web rollout status "deployment/doc-utils-prod-deploy"

.gitea/workflows/deploy-stg.yaml

@@ -0,0 +1,52 @@
+
+name: Deploy latest to staging environment
+
+on:
+  workflow_dispatch: { }
+  push:
+    branches:
+    - master
+
+jobs:
+  tag-image:
+    runs-on: ubuntu-latest
+    container:
+      image: catthehacker/ubuntu:act-latest
+    steps:
+    - name: Check out the repo
+      uses: actions/checkout@v3
+
+    - name: Log in to the Container registry
+      uses: docker/login-action@v2
+      with:
+        registry: gitea.jbrumond.me
+        username: ${{ secrets.REGISTRY_USER }}
+        password: ${{ secrets.REGISTRY_TOKEN }}
+
+    - name: Re-tag "latest" with "stg"
+      uses: https://gitea.jbrumond.me/actions/tag-manifest@v0.1
+      with:
+        registry: gitea.jbrumond.me
+        username: ${{ secrets.REGISTRY_USER }}
+        password: ${{ secrets.REGISTRY_TOKEN }}
+        manifest: doc-utils/docs-web:latest
+        tags: stg
+
+  deploy:
+    runs-on: ubuntu-latest
+    container:
+      image: gitea.jbrumond.me/images/kubectl:1.28
+    needs:
+    - tag-image
+    env:
+      KUBERNETES_SERVER: https://nephthys.local.jbrumond.me:6443
+      KUBERNETES_TOKEN: ${{ secrets.K8S_WEB_NS_SERVICE_ACCT_TOKEN }}
+      KUBERNETES_CERT: ${{ secrets.K8S_WEB_NS_SERVICE_ACCT_CERT }}
+    steps:
+    - name: Configure kubectl and set credentials
+      run: /bin/kubectl-setup
+    - name: Deploy "stg" image to kubernetes staging (doc-utils-stg.home.jbrumond.me)
+      run: |
+        kubectl -n web set image "deployment/doc-utils-stg-deploy" "doc-utils-stg=gitea.jbrumond.me/doc-utils/docs-web:stg"
+        kubectl -n web rollout restart "deployment/doc-utils-stg-deploy"
+        kubectl -n web rollout status "deployment/doc-utils-stg-deploy"

Dockerfile

@@ -5,8 +5,13 @@ 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
 
 
@@ -15,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:8000
+# base_url: http://localhost:46137
 
 # Input Configuration (where your documents are)
 input:

docs/docs2website/command-line-use.md

@@ -14,4 +14,7 @@ Command line use is very straight-forward, as there is only one valid way to cal
 docs2website <config file>
 ```
 
-The `<config file>` parameter should refer to a file containing [the configuration](./configuration.html) to build with.
+## Parameters
+
+: `<config file>`
+  : File path to the file containing [build configuration](./configuration.html)

docs/docs2website/index.md

@@ -13,7 +13,7 @@ The docs2website project is a static site generator primarily focused on technic
 - [Configuration](./configuration.html)
 - [Command Line Use](./command-line-use.html)
 - [Programatic Use](./programatic-use.html)
-- [Preview Built-in Color Themes](color-themes/preview.html)
+- [Preview Built-in Color Themes](../color-themes/preview.html)
 - [Source Code {:external-link:}](https://gitea.jbrumond.me/doc-utils/docs2website)
 
 

docs/index.md

@@ -3,7 +3,7 @@ title: doc-utils
 layout: main.html
 ---
 
-# doc-utils {#-}
+# doc-utils
 
 Documentation for the doc-utils projects.
 

docs/markdown2html/markdown-format.md

@@ -81,6 +81,89 @@ function say_hello() {
 
 
 
+## Definition / Description Lists {#dl}
+
+Definition lists or description lists (`<dl>` elements) can be rendered using lines that being with a colon (`:`) character.
+
+An unindented line starting with a colon is a `<dt>`, and an indented line starting with a colon is a `<dd>`. Indentation without a starting colon can be used to have multiple lines of content in either type of block. These lists can be nested.
+
+Indentation in `<dl>` blocks must two consecutive spaces; Other indentation styles are not allowed.
+
+```md
+: First Term
+  : First Definition
+  : Second Definition
+
+: Second Term
+  with multiple lines
+  of content
+  : Third Definition
+
+    : Nested List, First Term
+      : Nested List, First Definition
+    : Nested List Second Term
+      : Nested List, First Definition
+        with a _second_ line inside a definition, indicated by indenting again with no colon
+  
+  : Fourth Definition
+
+: Third Term
+  : Fifth Definition
+```
+
+!!! {.markdown-example-output}
+: First Term
+  : First Definition
+  : Second Definition
+
+: Second Term
+  with multiple lines
+  of content
+  : Third Definition
+
+    : Nested List, First Term
+      : Nested List, First Definition
+    : Nested List Second Term
+      : Nested List, First Definition
+        with a _second_ line inside a definition, indicated by indenting again with no colon
+  
+  : Fourth Definition
+
+: Third Term
+  : Fifth Definition
+!!!
+
+
+
+## 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}
 
@@ -189,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
+```
+!!!
 
 
 
@@ -254,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">
@@ -122,7 +123,6 @@
 	</script>
 </header>
 
-<div id="root">
 {{> breadcrumb.html }}
 
 <main>
@@ -133,7 +133,6 @@
 	<p class="left">Built with docs2website at <time datetime="{{ build_time.iso }}">{{ build_time.rfc2822 }}</time></p>
 	<p class="right">Copyright 2023 James Brumond</p>
 </footer>
-</div>
 
 </body>
 </html>

metadata.json

@@ -1,17 +1,22 @@
 {
   "last_build": {
-    "time": "2023-05-21T14:05:46.078-07:00",
-    "config_hash": "nMNkbiTmRQIzHx34srMn7f92meJx0AxbIEpTROsRZAehGNcOwfdEEajqLWNTH4lTdll82uyf7C4P95PVANcNAA=="
+    "time": "2023-08-19T17:17:00.889-07:00",
+    "config_hash": "uE1vXrV0+DVs3fpCIPIUlu7niYXyfxOe0JMGwmlUN/RzI5jJMW7A+8B5V2tK0CKdGVjmtwo+weTWXgF9N9JBIw=="
   },
   "files": {
+    "/_assets/theme-animation.css": {
+      "first_seen_time": "2023-05-19T00:06:52.103-07:00",
+      "last_build_hash": "wG/o3ApyPe2u15mZwpy5E+y5Koz5KZuhO2gyAZURxJiuX3qid7FBfpbIrhWDYEwc29R4mUIzuc2pyaBqSbW7dQ==",
+      "last_updated_time": "2023-05-19T00:06:52.103-07:00"
+    },
     "/_assets/structure.css": {
       "first_seen_time": "2023-05-19T00:06:52.103-07:00",
       "last_build_hash": "XtOPnd/zOEAr0DByWuvGfJyTHsdDIXTiZny5g2M2gItpdw/Ce8jaJ1hCMC72AIjkelYl1icrsqAfjNs6dtnn+A==",
       "last_updated_time": "2023-05-19T00:06:52.103-07:00"
     },
-    "/_assets/theme-animation.css": {
+    "/_assets/figures.css": {
       "first_seen_time": "2023-05-19T00:06:52.103-07:00",
-      "last_build_hash": "wG/o3ApyPe2u15mZwpy5E+y5Koz5KZuhO2gyAZURxJiuX3qid7FBfpbIrhWDYEwc29R4mUIzuc2pyaBqSbW7dQ==",
+      "last_build_hash": "GWqAs7DM3p2pZe37WHjRTBvPs/ft77X7v8hLb6AjU3nwEoSwgqyhvXnHSycmfXKAiQj9745tHnnpVU7gSbfS4Q==",
       "last_updated_time": "2023-05-19T00:06:52.103-07:00"
     },
     "/_assets/prism.css": {
@@ -24,9 +29,9 @@
       "last_build_hash": "vKON+tNIef2LVqhNv6IlMaHZW7gr40F7lbd9mLWYg9k0Kqrn1Nyon1Nf3t63hjNq/V6IAeV7+9svHCJqIiGj5g==",
       "last_updated_time": "2023-05-19T00:06:52.103-07:00"
     },
-    "/_assets/figures.css": {
+    "/_assets/colors.css": {
       "first_seen_time": "2023-05-19T00:06:52.103-07:00",
-      "last_build_hash": "GWqAs7DM3p2pZe37WHjRTBvPs/ft77X7v8hLb6AjU3nwEoSwgqyhvXnHSycmfXKAiQj9745tHnnpVU7gSbfS4Q==",
+      "last_build_hash": "UteDx72dZXzdJcv/IO6dluhgiN9ddwTn1GDGek4F7cYPRYQv/RDD4cuI97/Yxf+89ykpoKcmHHqt6Tudxi1H8A==",
       "last_updated_time": "2023-05-19T00:06:52.103-07:00"
     },
     "/_assets/extras.js": {
@@ -34,9 +39,9 @@
       "last_build_hash": "NH5RPkRjdvMpOm4QppT7blGPGdNK5b2J+cQ6Wsv22cmDfm3b7Tc9GeZn4qd5D+fTSoGoESNarEnN+sRV1ihrRA==",
       "last_updated_time": "2023-05-19T00:06:52.103-07:00"
     },
-    "/_assets/colors.css": {
+    "/_assets/breadcrumb.css": {
       "first_seen_time": "2023-05-19T00:06:52.103-07:00",
-      "last_build_hash": "UteDx72dZXzdJcv/IO6dluhgiN9ddwTn1GDGek4F7cYPRYQv/RDD4cuI97/Yxf+89ykpoKcmHHqt6Tudxi1H8A==",
+      "last_build_hash": "B3ajZA+BTRFIWfk6CA/Sa71n8MFp5GPB9TWsNLi0VrIV+N0hWiAJvSvnhV2BgHzRXooT1WWotLne7hgDi5qJcw==",
       "last_updated_time": "2023-05-19T00:06:52.103-07:00"
     },
     "/_assets/color-theme-preview.css": {
@@ -44,11 +49,6 @@
       "last_build_hash": "ggmN8fAn+W3ejVa+WjwgwCrqe/TD2lr3kmG77TUHrwDAuE8wOeWEmPV/YzhD9f57eYIA+ZHypp9s797CDjpbpA==",
       "last_updated_time": "2023-05-19T00:06:52.103-07:00"
     },
-    "/_assets/breadcrumb.css": {
-      "first_seen_time": "2023-05-19T00:06:52.103-07:00",
-      "last_build_hash": "B3ajZA+BTRFIWfk6CA/Sa71n8MFp5GPB9TWsNLi0VrIV+N0hWiAJvSvnhV2BgHzRXooT1WWotLne7hgDi5qJcw==",
-      "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,30 +99,30 @@
       "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"
     },
+    "/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"
+    },
     "/docs2website/configuration.md": {
       "first_seen_time": "2023-05-19T00:06:52.103-07:00",
       "last_build_hash": "JrZ6FQGKils7nBmTtoBYvWoqe4AcFcggKQryAou4dZHbFUjLpUNk2mtZ1w3Q3cKRVLF+maLbFirOARAJbAbtwA==",
       "last_updated_time": "2023-05-19T00:06:52.103-07:00"
     },
-    "/docs2website/index.md": {
-      "first_seen_time": "2023-05-19T00:06:52.103-07:00",
-      "last_build_hash": "U2kuTS/Nhdb0ybWkwr9b/tzHC4YWaBhfyW/dR1Ff3sBw4A4c6TBkigEv11xiQxFeWPODfT9QJoJm0fgF3zkQFg==",
-      "last_updated_time": "2023-05-19T00:06:52.103-07:00"
-    },
     "/docs2website/command-line-use.md": {
       "first_seen_time": "2023-05-19T00:06:52.103-07:00",
-      "last_build_hash": "3wbDdc/xVE3jbepPs0YrMToj76lrmuO+W/K1GvOAcZdichO9fmQ38ZmxfWTYc3JZSrhhasBo6rgkhEAL6TsndQ==",
-      "last_updated_time": "2023-05-19T00:06:52.103-07:00"
+      "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",
@@ -136,7 +136,12 @@
     },
     "/index.md": {
       "first_seen_time": "2023-05-19T00:06:52.103-07:00",
-      "last_build_hash": "q8n6caIA/k02lNP6jj1PwwSwIEVc+esAAd822KwkT8fMsZ2zhP+rUhOKChmM5ogRo1bCtrCmUDwaI92tCzDb5A==",
+      "last_build_hash": "7/5Kwma++r3MFm7KET9N4E2+f5Fbm/LPZoZLIakt6Tj68WnjQ0ygx1kmOuLaqhq5hlFtyvUmqUWVfvt4QhT3+A==",
+      "last_updated_time": "2023-05-27T17:55:56.863-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": {
@@ -146,13 +151,8 @@
     },
     "/markdown2html/markdown-format.md": {
       "first_seen_time": "2023-05-19T00:06:52.103-07:00",
-      "last_build_hash": "v93fInLvyGUltDLds4BIbqFKplwm7wXDEN+eNY+hu93jzzsH7bZy6imdCghadsMoiQlkgBnn2Z28f71su65rBw==",
-      "last_updated_time": "2023-05-21T14:05:46.078-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"
+      "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",