Project Intelligence

欢迎来到 Project Intelligence！又名“PI”

本项目的目标是借助 Minecraft 社区的力量，打造一个真正通用的文档模组。

那么这将如何运作呢？首先，任何模组开发者都可以为他们的模组向 PI 添加文档。问题在于模组开发者都很忙，所以大多数人没有时间为 PI 这样一个随机的文档模组编写文档，在我看来，这是当前大多数文档模组的一个主要问题。它们需要模组作者的直接支持。PI 旨在解决这个问题，让社区中的任何人都能使用相对简单的内置编辑器为各种模组编写文档来做出贡献。然后他们可以通过拉取请求提交文档，如果通过审核，它就会被添加到在线仓库中。

PI 所做的一切都是开源的，并且完全透明。所有文档都以原始形式存储在 github 上。然后由 jenkins 服务器构建并上传到由 covers1624 控制的 Web 服务器，PI 可以从那里访问它。PI 使用的所有内容都来自这个服务器，包括文档中使用的所有图片。不会向 pi.brandon3055.com 之外的任何服务器发出请求。唯一可能的例外是整合包文档，你可以在下面了解更多相关信息。

编辑：covers 完成 pi bot 后，上述声明将成立，该 bot 将自动确保 pi 中使用的所有图片都托管在我们的服务器上。在此之前，某些文档可能包含托管在 imgur.com 或其他此类托管站点上的图片。

功能：（随着 PI 的发展，此列表预计会增加）

高度可自定义的用户界面
整个 PI 用户界面都高度可由用户自定义。PI 目前只有 2 个默认样式预设，但将来会添加更多。并且用户可以保存自己的自定义预设。附注：如果你创建了一个你认为可以为默认预设增色的预设，欢迎在 github 上发布它。

JEI 集成
PI 完全支持 JEI 配方，这意味着 JEI 支持的任何配方都可以在 PI 文档中显示。

内容链接与“解释这个”
这允许你将物品、方块或实体链接到文档页面。它与一项名为“解释这个”的功能配合使用，让你只需在看着世界中的某个对象时，或将鼠标悬停在物品栏中的某个物品上时按下按键，即可打开链接的文档页面。 

将文档链接到 GUI
此功能目前需要模组支持（不过将来可能会改变） 此功能允许模组开发者将特定文档页面链接到他们模组中的 GUI。然后 Pi 会向受支持的 GUI 添加一个“信息”按钮，点击后会在 GUI 内打开一个迷你 pi 窗口，其中包含链接到该 GUI 的页面。

语言本地化支持

内置编辑器
pi 文档编辑器仍需要一些完善，但就目前而言，该编辑器提供了编写和维护文档所需的所有基本功能。 

支持多个模组版本
在为不断变化的模组编写文档时，这是一项必不可少的功能。此功能允许你在模组发生更改时更新文档，而不会破坏与模组先前版本的兼容性。

整合包文档
这是为整合包开发者添加的功能。它允许你编写与模组文档相同的文档，不同之处在于它不绑定到特定模组，并且它存储在整合包配置的本地，这意味着它可以随整合包一起分发。值得注意的是，与模组文档不同，我无法控制整合包文档中所用图片的托管。整合包开发者需要自行将这些图片托管在 imgur.com 之类的网站或自己的私有图片托管服务器上。

贡献：
你可以找到关于为 PI 自身的游戏内文档做出贡献所需的全部信息。  

请注意，能够轻松管理用户贡献文档的后端系统仍由 covers1624 开发中。我确实有能力手动接受文档，但我建议等待 covers 完成后端。

编辑：转念一想，covers 正忙于其他项目，所以目前这只能保持手动流程。