Weblate のソースコード

Weblateは GitHub 上で開発しています。コードをフォークしてプルリクエストを開くことができます。他の形式のパッチも歓迎します。

参考

Weblate の内部構造 を確認して、Weblate の内部構造がどうなっているか調べてください。

コーディングのガイドライン

Weblate のコードはすべて、 セキュリティ設計原則 を念頭に記述してください。

すべてのコードには、動作を説明するドキュメントが付属しています。メソッド、複雑なコードブロック、またはユーザーに表示される機能は文書化することを忘れないでください。

新しいコードでは、PEP 484 型のヒントを使用してください。既存のコードにはまだ含まれていないため、CI ではまだ検査できていません。

コーディング規約と低品質コードの検出

コードは PEP-8 コーディング規約に従い、ruff コード整形ツールを使用してフォーマットしてください。

コードの品質を検査するには、ruff を使用できます。その設定は pyproject.toml に保存されています。

The easiest approach to enforce all this is to install pre-commit. The repository contains configuration for it to verify the committed files are sane. After installing it (it is already included in the pyproject.toml) turn it on by running pre-commit install in Weblate checkout. This way all your changes will be automatically checked.

手動で検査を実行し、すべてのファイルを検査する方法:

pre-commit run --all