Forgejo 发布 Forge 编程语言检测与统计配置指南

高级 采用现有 git 目录 入站电子邮件 实例提交签名 界面定制 JWT 密钥管理与轮换 审核工具 OAuth2 提供方 OIDC 组映射 搜索引擎索引 软配额 命令行界面 配置速查表 Forgejo Actions 管理员指南 Forgejo Runner 配置 Forgejo Runner 注册 安装 从二进制文件安装 从软件包安装 使用 Docker 安装 保护 Forgejo Actions 部署安全 在 Actions 中使用 Docker 安装 数据库准备 从二进制文件安装 使用 Docker 安装 发布计划 设置 身份验证 备份与备份恢复 电子邮件设置 推荐设置与技巧 反向代理 存储设置 故障排查 日志配置 性能分析 寻求帮助 升级指南 Forgejo 贡献者指南 架构 Bug、功能与讨论 行为准则与审核团队 code.forgejo.org 从源码编译 依赖管理 开发者原创证书（DCO） 开发环境 在 Forgejo 中寻找可参与的工作 治理 硬件基础设施 界面定制 本地化 英语基础本地化 Weblate 管理员职责 管理仓库之间的依赖关系 发布管理 仓库迁移 机密信息 静态页面 测试 威胁分析 威胁分析：远程登录传播 Web 浏览器支持 欢迎使用 Forgejo Forgejo 用户指南 Actions Forgejo Actions | 高级功能 Forgejo Actions | 基本概念 Forgejo Actions | GitHub Actions Forgejo Actions | 快速入门指南 Forgejo Actions | 参考 Forgejo Actions | 安全 Forgejo Actions | Pull Request 安全 Forgejo Actions | 安全 OpenID Connect Forgejo Actions | 故障排查 Forgejo Actions | 用户指南 Forgejo Actions | 使用 Actions API API 用法 授权集成 Forgejo 编号方案 身份验证 访问令牌作用域 OAuth2 提供方 协作 在 Issue、Pull Request 和提交消息中自动关联引用 屏蔽用户 标签 个人资料定制 项目 Pull Request 与 Git 流程 仓库活动 仓库权限 通过电子邮件评论 Issue 和 Pull Request Forgejo Next 入门 电子邮件设置 集成 Wiki Issue 跟踪基础 你的第一个仓库 Git CLI AGit 工作流用法 推送选项 软件包注册表 Alpine 软件包仓库 ALT 软件包注册表 Arch 软件包注册表 Cargo 软件包注册表 Chef 软件包注册表 Composer 软件包注册表 Conan 软件包注册表 Conda 软件包注册表 容器注册表 CRAN 软件包注册表 Debian 软件包注册表 通用软件包注册表 Go 软件包注册表 Helm Chart 注册表 Maven 软件包注册表 npm 软件包注册表 NuGet 软件包注册表 Pub 软件包注册表 PyPI 软件包注册表 RPM 软件包注册表 RubyGems 软件包仓库 Swift 软件包仓库 Vagrant 软件包仓库 仓库 Blame 文件视图 分支与标签保护 FUNDING 文件 Issue 与 Pull Request 模板 合并消息模板 编程语言检测 README 徽章 标签与发布 Webhook 仓库镜像 搜索 代码搜索 Issue 搜索 编程语言检测 内置语言检测 关于类别的简要说明 调整语言检测 覆盖语言 覆盖类别 覆盖检测 编程语言检测 Forgejo 会尝试检测仓库中每个文件所使用的语言，并将此信息以多种方式加以利用。最显著的用途是在仓库主页顶部显示语言统计条，但同样的信息也用于在 diff 中排除生成的文件和第三方引入的文件。 它自带适用于大多数场景的合理默认配置，但并非没有缺陷或妥协，而且有些场景下检测需要一些引导。下面我们将说明如何影响检测结果，不过先来看看默认行为吧！ 每当仓库内容发生变化，Forgejo 都会检查文件，并尝试将它们归入以下类别之一：“编程语言”、“标记语言”、“文档”、“Dotfile”、“配置”、“生成”、“第三方引入”。分类工作由 go-enry 包完成，具体细节请查阅其文档。该库与 linguist 基本兼容，后者被一些其他 forge 使用。统计基于仓库的主分支计算，仅在主分支变化时更新，且更新可能需要一些时间。 对于仓库语言统计，在默认配置下，只有匹配“编程语言”或“标记”语言类别的文件会被纳入考虑，其他一切都会被忽略。查看 diff 时，所有文件都会显示，但“生成”的文件默认折叠，“第三方引入”的文件会被如此标记。 虽然有些类别相当直白，但对它们稍作解释也无妨，尤其是当你考虑将文件重新归类到其他类别时。 第三方引入文件是指你签入仓库、但并非你自己编写、而是从其他地方导入的任何文件。这些可能包括你希望在特定版本保留本地副本的依赖项——例如 JavaScript 库或 Go 包。它们可能会夸大项目的语言统计，甚至可能导致项目被标记为另一种语言。将这些文件标记为第三方引入，就可以在统计中忽略它们。

（原文较长，此处译出前 6000 字，完整内容请点「打开原文」。）