查看“帮助:文件修改记录”的源代码

{{ProfessionalArticle/zh}}

'''文件修改记录'''经常会出现在本Wiki[[:Category:游戏补丁|游戏补丁类页面]]中，它通常表示对应游戏补丁对游戏文件做了何种修改。

此页面将介绍如何读懂'''文件修改记录'''以及如何编制它。

== 阅读 ==

=== 示例 ===

{{FileChanges/zh|content=
 +-- Ballance
     +-- 3D Entities
         +-- [M] MenuLevel.NMO - 9067E326F8E0DAF817F1DE5EF599A494C1040BC9A933DE10591AEA6573CE5F25
         +-- [N] mod1.NMO - 98DEFF48168CB8148A1D98AC63E7B15E17724A3D52DB135A5F1603D4681F6068
         +-- [N] Modloader.NMO - 618BEEA4EA2A24087D4C07788644868930DDBD2EDB87657412E87B8104338A89
}}

=== 文件修改方式 ===

如果文件名前面没有任何标注，就代表它无需修改。

有效的文件修改标注如下：

* [N]：此文件在原版Ballance中没有，是此游戏补丁新建的
* [M]：此文件在原版Ballance中有，但是此游戏补丁修改了它
* [D]：此文件在原版Ballance中有，但是此游戏补丁删除了它

=== 文件[[wikipedia:zh-cn:哈希|哈希]]校验值 ===

文件的哈希校验值会帮助你判断哪一个文件是你需要的，以及判断你当前有没有安装某款插件。

哈希校验值使用一个两端带有空格的连字符 {{kbd|''' - '''}} 来作为开头，之后紧跟着哈希值。

在文件修改记录中，哈希算法一律使用[https://zh.wikipedia.org/wiki/SHA%E5%AE%B6%E6%97%8F SHA256]。

== 编写 ==

您可以选择手工编写目录树，但我建议使用一款依赖[https://zh.wikipedia.org/wiki/Python Python]的软件。您可以在[https://github.com/mbr/asciitree 对应的Github页面]上找到一些示例和使用方法。

然后使用<nowiki><pre></nowiki>标签添加你生成的目录树，并附带如下样式：<nowiki>style="word-wrap: break-long; overflow-x: auto"</nowiki>。

如果您认为生成的目录树过长而易造成刷屏，您可以改为使用 <code><nowiki>{{</nowiki>FileChanges/zh|content=''目录树''<nowiki>}}</nowiki></code>，这样产生的结果可折叠且默认折叠。

需要注意的是，使用 <code><nowiki>{{FileChanges/zh}}</nowiki></code> 时，您需要手动将 <code>|</code> 符号替换为 <code><nowiki>{{!}}</nowiki></code>，否则将无法正常显示。

[[Category:帮助]]