Merge pull request #29 from nics-tw/task/website-updates

Task/website updates

docs/summary.md

@@ -0,0 +1,21 @@
+# 數位韌性
+
+## 易用性
+
+1. 能有效率地幫助使用者達到需求
+2. 達到可近用性(Accessibility)標準
+3. 設計、流程清楚，操作體驗流暢，滿足一致性
+
+## 可維護性
+
+1. 監控、備份、災難復原能力
+2. 良好的自動擴充能力，能應對流量高峰及刻意阻斷，避免單點故障影響服務
+3. 網路、設備、電力受損時，能持續提供服務的能力
+
+## 高可用性
+
+1. 有足以適應變化，利於開發，可持續發展的架構
+2. 有清楚的架構、程式、文件或設定檔，讓開發、維運者能快速上手
+3. 有自動化地系統部署、測試流程，並於系統擴展時能簡單執行，避免人為出錯。
+4. 系統保持足夠簡單，架構不過度設計。
+5. 使用主流且持續發展中的技術，利於選用人才及傳承。

docusaurus.config.ts

@@ -36,21 +36,21 @@ const config: Config = {
         docs: {
           sidebarPath: './sidebars.ts',
           routeBasePath: 'material',
-          // Please change this to your repo.
-          // Remove this to remove the "edit this page" links.
           editUrl:
             'https://github.com/nics-tw/resilience-material/tree/main/',
         },
         theme: {
           customCss: './src/css/custom.css',
         },
+        gtag: {
+          trackingID: 'G-HY2XBCL1WK',
+          anonymizeIP: true,
+        },
       } satisfies Preset.Options,
     ],
   ],
 
   themeConfig: {
-    // Replace with your project's social card
-    // image: 'img/docusaurus-social-card.jpg',
     navbar: {
       title: '數位韌性教材專區',
       logo: {
@@ -62,7 +62,12 @@ const config: Config = {
           type: 'docSidebar',
           sidebarId: 'materialSidebar',
           position: 'left',
-          label: '教材',
+          label: '共通性建議',
+        },
+        {
+          label: '數位韌性教材', // 新增 Tab
+          to: '/material/training',
+          position: 'left',
         },
         {
           href: 'https://github.com/nics-tw/resilience-material',
@@ -74,21 +79,12 @@ const config: Config = {
     footer: {
       style: 'dark',
       links: [
-        {
-          title: '教材',
-          items: [
-            {
-              label: '數位韌性領航員培訓課程教材',
-              to: '/material/training',
-            },
-          ],
-        },
         {
           title: '相關連結',
           items: [
             {
               label: '政府網站設計原則',
-              href: 'https://guide.nics.nat.gov.tw/'
+              href: 'https://guide.nics.nat.gov.tw/',
             },
           ],
         },
@@ -102,4 +98,4 @@ const config: Config = {
   } satisfies Preset.ThemeConfig,
 };
 
-export default config;
+export default config;

sidebars.ts

@@ -2,78 +2,37 @@ import type { SidebarsConfig } from '@docusaurus/plugin-content-docs';
 
 const sidebars: SidebarsConfig = {
   materialSidebar: [
+    {
+      type: 'doc',
+      id: 'summary', // 指向 summary.md
+      label: '數位韌性', // 顯示的標籤
+    },
     {
       type: 'category',
       label: '易用性',
       collapsed: false,
       link: {
-        type: 'doc',
-        id: 'accessbility/accessbility', // 指向主文檔
+        type: 'generated-index',
       },
-      items: [
-        {
-          type: 'doc',
-          id: 'accessbility/digital-accessibility', // 子文檔
-          label: '組織中的網頁可及性：角色與職責',
-        },
-      ],
+      items: [{ type: 'autogenerated', dirName: 'accessbility' }], // 自動從 accessbility 資料夾生成
     },
     {
       type: 'category',
       label: '可維護性',
       collapsed: false,
       link: {
-        type: 'doc',
-        id: 'maintainable/maintainable', // 指向主文檔
+        type: 'generated-index',
       },
-      items: [
-        {
-          type: 'doc',
-          id: 'maintainable/ci-cd-guideline', // 子文檔
-          label: 'CI/CD - 於 GitHub 上建立自動生成 SBOM 及漏洞掃描',
-        },
-        {
-          type: 'doc',
-          id: 'maintainable/Guide_to_SBOM_and_OSV_Tools', // 子文檔
-          label: 'SBOM 開源工具使用說明',
-        },
-        {
-          type: 'doc',
-          id: 'maintainable/operational-excellence', // 子文檔
-          label: '卓越營運設計原則',
-        },
-        {
-          type: 'doc',
-          id: 'maintainable/operational-excellence-cloud', // 子文檔
-          label: '支援卓越營運的雲端架構設計模式',
-        },
-      ],
+      items: [{ type: 'autogenerated', dirName: 'maintainable' }], // 自動從 maintainable 資料夾生成
     },
     {
       type: 'category',
       label: '高可用性',
       collapsed: false,
       link: {
-        type: 'doc',
-        id: 'high-availability/high-availability', // 指向主文檔
+        type: 'generated-index',
       },
-      items: [
-        {
-          type: 'doc',
-          id: 'high-availability/cdn-gov-guideline', // 子文檔
-          label: '政府憑證如何使用於 CDN 之說明',
-        },
-        {
-          type: 'doc',
-          id: 'high-availability/system-reliability', // 子文檔
-          label: '可靠性設計原則',
-        },
-        {
-          type: 'doc',
-          id: 'high-availability/high-reliability-cloud', // 子文檔
-          label: '支援高可靠性的雲端架構設計模式',
-        },
-      ],
+      items: [{ type: 'autogenerated', dirName: 'high-availability' }], // 自動從 high-availability 資料夾生成
     },
   ],
 };