Weblate 源代码

Weblate 在 GitHub 上开发。欢迎您将代码复刻并开一个拉取请求。同样欢迎任何形式的补丁。

参见

查阅 Weblate 内部 来看看 Weblate 内部是什么样子的。

代码编写准则

在为 Weblate 编写任何代码时都应该考虑到 通过设计保证安全原则。

任何代码都应附带解释行为的文档。不要忘记记录方法、复杂的代码块或用户可见的功能。

任何新代码都应使用 PEP 484 类型提示。我们尚未在 CI 中检查此项，因为现有代码尚未包含它们。

Git commits should follow Conventional Commits specification.

编码标准和代码检查

代码应该遵循 PEP-8 代码编写准则，并且应该使用 ruff 代码格式化程序进行代码格式化。

要检查代码质量，你可以使用 ruff，其配置存储在 pyproject.toml 中。

将所有这些强制的最简单的方法是安装 pre-commit。仓库为此包含了配置，来确定提交的文件是正常的。安装后（它已经包括在 pyproject.toml`中了）通过在 Weblate 的付款台运行 ``pre-commit install` 来将它打开。通过这种方法，所有更改都将被自动检查。

还能够手动触发检查，来检查所有文件的运行：

pre-commit run --all