## 阅读指南

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)。仅与文档服务器相关的问题与建议则在其开发仓库中跟踪，具体信息请参阅开发者指南。