summaryrefslogtreecommitdiff
path: root/Documentation/source/zh_TW/introduction.rst
diff options
context:
space:
mode:
authorBertrand Yuan <me@bertyuan.com>2026-04-27 20:52:54 +0800
committerBertrand Yuan <me@bertyuan.com>2026-04-27 20:53:14 +0800
commitdbb5e791f0c228369605d126dd590962ebe1eddc (patch)
tree8c83fc84bd9547630e6733929dec77e102e055a8 /Documentation/source/zh_TW/introduction.rst
parent658798b3a2378bb6df16cfbb16d707c6fb719e1e (diff)
docs: add comprehensive documentation for operations
This commit introduces a complete set of documentation files covering various aspects of the project, including environment setup, quality checks, command references, and architecture. The documentation is structured to assist developers and contributors in understanding the project's configuration, workflow, and best practices. Additionally, translations for Simplified and Traditional Chinese have been added to ensure accessibility for a wider audience. This enhances the overall usability and maintainability of the project. Signed-off-by: Bertrand Yuan <github@bertyuan.com>
Diffstat (limited to 'Documentation/source/zh_TW/introduction.rst')
-rw-r--r--Documentation/source/zh_TW/introduction.rst46
1 files changed, 46 insertions, 0 deletions
diff --git a/Documentation/source/zh_TW/introduction.rst b/Documentation/source/zh_TW/introduction.rst
new file mode 100644
index 0000000..8ca15d4
--- /dev/null
+++ b/Documentation/source/zh_TW/introduction.rst
@@ -0,0 +1,46 @@
+專案介紹
+========
+
+Next Blog 是一個以閱讀體驗為核心的全端部落格平台。它使用 Next.js App Router 建置公開站台,使用 Payload CMS 管理內容,並透過 PostgreSQL、Drizzle ORM、better-auth 與 Fuma Comments 提供認證、留言與應用資料能力。
+
+產品範圍
+--------
+
+目前專案聚焦於以下能力:
+
+* 透過 Payload CMS 建立、編輯、發布文章;
+* 呈現首頁、文章列表、文章詳情、標籤頁與個人頁面;
+* 透過 Google 與 GitHub OAuth 登入;
+* 為登入使用者提供留言功能;
+* 輸出搜尋索引、RSS、網站地圖、JSON-LD 與 Open Graph 圖片;
+* 提供 Newsletter 表單與 React Email 範本。
+
+這個專案不是通用社群 CMS,而是一個受控的個人發布系統:公開側重閱讀,後台側重內容管理。
+
+核心角色
+--------
+
+.. list-table::
+ :header-rows: 1
+ :widths: 20 34 36
+
+ * - 角色
+ - 目標
+ - 主要入口
+ * - 訪客
+ - 瀏覽和閱讀內容。
+ - ``/``、``/posts``、``/posts/[slug]``、``/tags``
+ * - 回訪讀者
+ - 透過標籤篩選內容並使用訂閱入口。
+ - ``/tags/[tag]``、``/rss.xml``
+ * - 登入使用者
+ - 發表留言與使用帳號相關操作。
+ - ``/login``、``/posts/[slug]``
+ * - 內容管理員
+ - 維護、排程與發布內容。
+ - ``/admin``
+
+文件定位
+--------
+
+``Documentation/source`` 是本專案正式的 Sphinx 文件來源目錄。``docs/`` 中的 Markdown 檔案可以作為調研或草稿材料,但穩定的工程文件應整理為 reStructuredText 後進入本目錄。