format.md

资料格式

资料存放在 data.json 内，格式为JSON，内容如下:

{
    "common-words": [
        ["名称", "解释"]
    ],
    "threads": {
        "url": {
            "一个帖子的资料，请看下方帖子资料"
        }
    }
}

可以使用 npm run check 命令检查格式是否正确。

主页设计

主页应被分为以下部分:

• 推荐帖子
• 新人必读
• 常用字词表
• ...以及各种帖子类型

注意，每部分应先以推荐程度倒序排序，越重点推荐越前；同一推荐程度则以最后更新日期倒序排序，越新的教程越前。

主页亦应有搜寻功能，及根据年份、标签的筛选功能。

帖子资料

每个被录入的帖子都需要包括以下资料:

• title: 帖子标题，不一定需要和实际帖子标题相同，以可读性和正确性为重，禁止过于夸张的标题。
• last-update: 帖子最后更新日期，格式为 yyyy-mm-dd。（注：最后更新日期应为 大更新 的更新日期，小修改不应修改这日期。）
• tags: 帖子内容标签作搜寻之用，每个帖子可有不多于5个标签，请参见下方标签列表。
• category: 帖子类型，作为分类之用，请参见下方类型列表。
• versions: 帖子适用版本，参见下方版本列表。
• recommended: 帖子被推荐程度，参见下方推荐指南。

例子:

{
    "title": "例子",
    "last-update": "2018-03-23",
    "tags": ["基础", "其他生成器/资源"],
    "category": "其他",
    "versions": ["1.8", "1.9", "1.10", "1.11", "1.12", "1.13"],
    "recommended": 2
}

标签列表

标签必须与下方列表中的完全相同，否则将会被视作错误。

一般标签:

• 基础: 适合新手阅读。
• 进阶: 适合对命令有一定认识的玩家阅读。
• 计算: 牵涉一些比较高阶的数学计算。
• 几何: 牵涉一些几何知识。
• 算法: 牵涉一些电脑算法。
• 特技: 一些视觉、听觉为主的功能。
• NBT: 与NBT相关的教程。
• 游戏机制: 与游戏非命令的机制相关。
• 黑科技: 一些接近bug或匪夷所思的功能。
• 人生经验: 一些实用的提示。
• 游戏系统: 可用于游戏内的现成系统。
• 命令介绍: 特定命令的介绍。
• 原版模组: 设计为可以方便地在不同地图安装的系统作品。
• 地图作品: 包括地图的命令系统作品。
• 概念验证: Proof of Concept，只作为验证概念的作品。
• OOC生成: OOC（一条命令）生成器。
• 自定义生成器: 自定义命令生成器（或集合）。
• 其他生成器/资源: 不（只）是OOC也不是自定义的命令生成器，或其他资源。

特殊标签:

• 实例: 教程内有充足实例。
• 过时: 教程在当前最新正式版过时。
• 即将过时: 教程适用于最新正式版，但在最新预览版过时。
• 英语: 该教程以英语编写。（国外教程）

类型列表

• 有趣问答: 对读者命令、逻辑的小测试，必须附答案。（答案可以不在帖子内，但帖子内必须有答案链接）
• 算法逻辑: 主要教导算法、逻辑的帖子。（包括POC）
• 系统制作技巧: 一些在系统制作中可以使用的技巧。（部分黑科技可以归类进此类）
• NBT介绍: 主要介绍特定NBT标签的格式及用处。
• 作品例子: 作品展示，包括制作心得、教程。
• 游戏机制: 对游戏机制的讲解。
• 教程索引: 玩家/团队帖子索引。（应有至少5篇帖子）
• 命令/格式教程: 个别命令或格式介绍。
• 常用网站: 一些命令常用网站，只接受大型网站及Wiki页面。
• 生成器/资源: 一些生成器及命令资源。
• 其他: 不能归类到上述类别的内容。

版本列表

本索引仅接受1.8或之后的教程，再之前的教程我们一概不接受。 如果教程涉及失效了的预览版功能，则请进行修改，我们是不会接受失效了的预览版功能的。 如果教程在预览版的时候编写但在正式版的时候能够使用，则请写上正式版的版本。

• 1.8
• 1.9
• 1.10
• 1.11
• 1.12
• 1.13 (最新预览版)

推荐指南

• 2: 极度推荐于新人阅读，将会在推荐教程里列出直至被标签为 过时 。如过时，也会录入新人必读部分。
• 1: 相当值得阅读，最新的10篇尚未过时的将会在推荐教程里列出。
• 0: 不错的教程。