2024/09/23 release

Signed-off-by: Shield of Self-Defense (ocf.tw) <[email protected]>

.github/workflows/build_docs.yml

@@ -0,0 +1,45 @@
+name: Build Docs
+on:
+  push:
+    branches:
+      - shield
+permissions:
+  contents: write
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Configure Git Credentials
+        run: |
+          git config user.name ocf-ssd[bot]
+          git config user.email [email protected]
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Cache Poetry venv
+        uses: actions/cache@v4
+        with:
+          path: ./.venv
+          key: poetry-venv-${{ hashFiles('**/poetry.lock') }}
+      - name: Cache Poetry local
+        uses: actions/cache@v4
+        with:
+          path: ~/.local/share/pypoetry
+          key: poetry-local-${{ hashFiles('**/poetry.lock') }}
+      - name: Cache Poetry cache
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pypoetry
+          key: poetry-cache-${{ hashFiles('**/poetry.lock') }}
+      - name: Install and configure Poetry
+        uses: snok/install-poetry@v1
+        with:
+          version: 1.8.3
+          virtualenvs-create: true
+          virtualenvs-in-project: true
+          installer-parallel: true
+      - name: Install dependencies
+        run: poetry install
+      - name: Build Docs
+        run: poetry run mkdocs gh-deploy --force

.gitignore

@@ -0,0 +1,2 @@
+/site
+.cache

.vscode/settings.json

@@ -0,0 +1,13 @@
+{
+    "yaml.schemas": {
+      "https://squidfunk.github.io/mkdocs-material/schema.json": "mkdocs.yml"
+    },
+    "yaml.customTags": [ 
+      "!ENV scalar",
+      "!ENV sequence",
+      "!relative scalar",
+      "tag:yaml.org,2002:python/name:material.extensions.emoji.to_svg",
+      "tag:yaml.org,2002:python/name:material.extensions.emoji.twemoji",
+      "tag:yaml.org,2002:python/name:pymdownx.superfences.fence_code_format"
+    ]
+  }

README.md

@@ -0,0 +1,31 @@
+# 資安防護基礎教材
+
+給公民團體 CSOs 的資安防護基礎教材，教材收錄內容適用於個人與組織內管理者，並提供組織內可實行的政策範本。
+
+教材網站： <https://ssd.ocf.tw/>
+
+各章節主題：
+
+1. 威脅建模：風險評估。
+2. 裝置安全：iOS、macOS、Windows、Android。
+3. 身份驗證：密碼管理器、密碼強度、多因子驗證。
+4. 網路使用行為：隱私瀏覽行為、釣魚詐騙、VPN、網路與 Wi-Fi。
+5. 加密通訊：加密即時通訊、加密電子郵件。
+6. 帳號管理：權限管理與追蹤。
+7. 資料管理與備份：檔案存取權限、資料備份與封存、更新軟體。
+8. 海外出差：準備工作、返回時的檢查。
+
+## 內容授權
+
+教材網站內容採用「[CC-BY 4.0 姓名標示](https://creativecommons.org/licenses/by/4.0/deed.zh-hant)」，如何標示引用可以[參考說明](https://ssd.ocf.tw/support/copyright.html)。
+
+---
+> [!NOTE]
+> - SSD：Shield of Self-Defense (SSD)
+
+> [!NOTE]
+> 參考資源：
+> - Security in-a-box: <https://securityinabox.org/en/>
+> - Privacy Guides: <https://www.privacyguides.org/>
+> - Surveillance Self-Defense, EFF: <https://ssd.eff.org/>
+> - CSCS: <https://cscs.asia/>

docs/CNAME

@@ -0,0 +1 @@
+ssd.ocf.tw