## 閱讀指南

FDS 文件是 Field of Dreams Studio（FDS）的公開文件站點。這裡集中存放組織的各項政策、合作夥伴與協作站點的資訊、公告與新聞，以及文件伺服器自身的使用說明。您正在閱讀的這一頁就是面向讀者的指南，簡要介紹如何在站內瀏覽、切換語言、分享連結以及將內容下載到本地。

### 站點結構

首頁展示兩個頂級分組。**FDS** 收錄組織自身的資料，包含 `policies`（政策）、`cooperation`（合作）、`news`（新聞）和 `doc`（即本文件板塊）。**Events** 收錄與具體活動相關的資料，目前包含 **Minecraft Server** 一項。

每個頁面頂部都有一行麵包屑導覽。麵包屑的最後一項會作為該頁的標題渲染，因此您隨時都能一眼看清自己所處的位置，點擊前面的任何一項即可向上回到所在分支。

在某個分組內部，**板塊**頁面以網格形式列出子區域的入口，**列表**頁面則直接連結到具體的文章。新聞板塊是一個按時間倒序排列的列表，最新的內容排在最前面。

### 語言

站點支援三種語言：**English**（預設）、**中文**、**日本語**。

請使用導覽列中的語言下拉選單進行切換。下拉選單會請求 `/op/switch_lang/<代碼>`，先設定一個語言 Cookie，再將您重新導向回原本所在頁面的對應語言版本。

URL 有兩種形式：

- `/policies/` 這類**裸 URL** 會跟隨您的語言 Cookie。首次造訪、尚未設定 Cookie 的訪客會看到英文版本。
- `/zh/policies/`、`/ja/policies/` 這類**帶前綴的 URL** 會顯式鎖定語言。搜尋引擎會抓取帶前綴的形式，因此每種語言都能被獨立索引和檢索。

`/doc/` 下的管理員指南和開發者指南刻意只提供英文版本，因為其中涉及大量程式碼路徑、設定鍵等不易翻譯的識別符。它們的標題和描述仍會按語言本地化，因此在各語言的板塊列表中會以您選擇的語言出現。

### 分享連結

站內的任何 URL 都可以直接分享。如果您希望對方無論自身 Cookie 設定如何都能看到特定語言的版本，請分享帶前綴的形式：例如 `/zh/news/` 鎖定中文，`/ja/news/` 鎖定日文。

### 下載內容

在大多數頁面的 URL 後追加 `?view=download`，即可把內容作為檔案取回：

- 對於 `singlemd` 頁面（單篇文件），返回的是 Markdown 原始檔，作為 `.md` 附件下載。
- 對於 `mdbook` 頁面（多章書籍），返回的是包含全部章節 Markdown 的 `.zip`，章節按閱讀順序排列。
- 對於檔案頁面，返回的是上傳時的原始位元組，檔名也保持不變。

下載遵循與頁面瀏覽相同的權限。只要您能在瀏覽器中檢視該頁面，就可以將其下載下來。

### 搜尋與瀏覽

全文搜尋功能尚未提供。在此之前，請透過各分區的索引頁進行瀏覽。板塊檢視與列表檢視的設計目標，就是讓您能從首頁順暢地一路走到具體文章。

### 回饋

對 FDS 組織本身的諮詢或綜合性意見，請前往主站 [https://fds.moe](https://fds.moe)。僅與文件伺服器相關的問題與建議則在其開發倉庫中追蹤，具體資訊請參閱開發者指南。