git - .gitattributes 语言学家属性标准

Question

我刚刚创建了一个新的 Laravel 项目，我正在设置我的 .gitattributes语言属性。问题是，我不确定要为哪些文件/目录设置哪些。

默认.gitattributes文件如下所示:

* text=auto
*.css linguist-vendored
*.scss linguist-vendored
*.js linguist-vendored
CHANGELOG.md export-ignore

首先，为什么都是 .css , .scss和 .js文件设置为 linguist-vendored ?这不仅会从语言学家中排除所有此类用户创建的文件，而且 Laravel 也分别只有 1、2 和 4 个这些文件，这将如何显着影响语言学家的统计数据？

其次，是否有任何关于哪些文件应该标记为 linguist-vendored 的约定/标准？ ?我是否应该标记所有 Laravel 文件，只有那些我没有修改的文件，只有 vendor目录，还是根本没有？或者甚至是别的什么？

提前致谢 !

Answer 1

First of all, why are all .css, .scss and .js files set to linguist-vendored?

据我了解，阅读关于提交的评论 e3630a5和 93876d6 , 作者希望确保 Laravel 项目被标记为 PHP (GitHub 使用语言统计中的第一种语言标记项目)。

Not only would this exclude all such user-created files from Linguist, but Laravel also only has respectively 1, 2 and 4 of these files, how would this significantly impact Linguist stats?

在 Linguist 中，语言统计数据来自每种语言的文件大小(您可以在 how Linguist works 上阅读我的回答以了解更多详细信息)。因此， 单个大文件可以改变语言统计 .

在 Laravel 的情况下，如果我删除语言学家覆盖并在存储库上再次运行语言学家，我会得到以下统计信息:

94.11%  PHP
3.30%   HTML
1.42%   JavaScript
0.68%   Vue
0.49%   CSS

因此无需使用语言学家覆盖来将存储库标记为 PHP。但是，添加覆盖时可能存在较大的文件。

请注意，Laravel 存储库包含两个大的缩小文件。语言学家认识到存在缩小并将它们标记为生成的，从而自动将它们从统计数据中排除。

Secondly, is there any convention/standard regarding which files should be marked as linguist-vendored? Should I mark all Laravel files, only the ones that I don't modify, only the vendor directory, or none at all? Or maybe even something else?

这真的取决于你；据我所知， 关于什么构成供应商代码没有约定 .

在语言学家， we try to mark as vendored所有可能影响统计数据但不是由存储库所有者编写的第三方代码。不过，您可以使用覆盖更改默认行为。