我正在使用yard来生成我的项目的文档。即使文档可以生成,因此不需要进行版本控制,我们还是决定这样做,因为它可以更容易地查看代码(注释)更改对实际文档的影响。
问题是每次 yard 生成文档时,它都会更改每个文件开头的日期,导致所有文件都被视为已更改。
有没有办法告诉 git 忽略这些行以检测文件是否已更改,或者有一种方法可以将 yard 配置为如果它们相同则不重新生成文件?
谢谢
更新
我知道我可以做一个脚本或其他任何东西,如果只有日期发生了变化,它就会清理文件。所以我的问题是有一种 Git 方法可以做,即我应该费心阅读差异驱动程序还是应该执行干净的脚本。
如果我要走向清理路径,那么使用 git hook 或将其集成到 doc 生成中会更好吗?
最终,我对任何其他方式来跟踪由于生成的文档中的特定提交而导致的更改感兴趣。
我还没有真正解释我的问题是什么(以及为什么我要尝试对不需要的东西进行版本化)所以我们开始了。
有时,代码中的一些修改会搞砸文档,因此我将能够看到提交对文档的影响。
示例:我为 vim 使用模式行(文件第一行的注释告诉 vim 不同的信息)
知道我有一个包含模块文档的文件
#vi: my vim setting
# Documentation of module A
module A
.... some code
end
在其他地方我使用这个模块
#vi : my vim setting
( 2 blank lines)
module A
.... some different code
end
那时,一切都很好,A 的文档将是Documentation of module A
. 但是,如果有人(比如我)删除了最后一个文件中的一个空行并只留下一个(是的,我在模式行和代码之间留了 2 个空行),那么院子认为模式行是模块 A 的文档,它将是vi : my vim setting
.
问题是,除了查看每一页之外,没有办法检测到文档是否被搞砸了。使用 git,我可以快速查看和检查更改的内容,甚至可以找到更改的时间(这很重要,因为这样我就可以找出更改的原因)。