Create docfx-pages.yml

Author: sator-imaging

.github/workflows/docfx-pages.yml

@@ -0,0 +1,93 @@
+name: docfx for GitHub Pages
+
+on:
+  # Runs on pushes targeting the default branch
+  push:
+    branches:
+      - 'main'
+      ##- 'releases/**'
+  release:
+    types: [published]
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  # Single deploy job since we're just deploying
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+
+
+    #########################################
+    ######  sator-imaging/docfx-pages  ######
+    #########################################
+    steps:
+
+      # for extensibility, docfx-pages does NOT checkout your repository.
+      # so you need to checkout manually prior to sator-imaging/docfx-pages.
+      - name: Checkout
+        uses: actions/checkout@v4
+
+
+      # after checkout, you can checkout another repo, copy logo image or
+      # other assets into '.docfx' folder to setup your own docfx environment.
+      # note that images must be copied into '.docfx/images', 'images' or '.images'.
+
+
+      ######  main  ######
+
+      - uses: sator-imaging/docfx-pages@v1
+        id: deployment   # required to show url in actions result page.
+        with:
+
+          # required options
+          # NOTE: double-quote (") cannot be used, backquote (`) must be escaped (\`).
+          app_name:    'CSharp-TarArchiver'
+          site_title:  'CSharp-TarArchiver'
+          site_footer: '© 2023-2025 Sator Imaging'
+
+          # optional
+          class_members: 'separatePages'  # 'separatePages' or 'samePage'
+          google_analytics: ''  # empty to disable
+          define_symbols: ''  # additional preprocessor symbols separated by ';'
+
+          # paths must be relative from .docfx folder. default value is used when not set.
+          # note that url works but only in top page. see sample website for detail.
+          ###site_logo:    '<logo>.svg'
+          ###site_favicon: '<favicon>.svg'
+
+          # advanced options
+          # --> https://dotnet.github.io/docfx/docs/template.html?tabs=modern#custom-template
+          # main.js
+          # NOTE: double-quote (") cannot be used, backquote (`) must be escaped (\`).
+          main_js: |
+            export default {
+                defaultTheme: 'light',
+                showLightbox: (img) => true,
+                iconLinks: [
+                    {
+                        icon: 'github',
+                        href: 'https://github.com/sator-imaging',
+                        title: 'GitHub'
+                    },
+                ],
+            }
+
+          # main.css
+          # NOTE: double-quote (") cannot be used, backquote (`) must be escaped (\`).
+          main_css: |