Development

Code of Conduct

By contributing you agree to abide by the Contributor Code of Conduct.

Contribution Guideline

Report Issue

To Be Written

• https://github.com/sphinx-doc/sphinx-intl/issues

Pull Request

To Be Written

• https://github.com/sphinx-doc/sphinx-intl/pulls

Setup development environment

• Requires supported Python version

• Do setup under sphinx-intl.git repository root as:

  $ pip install -U uv
  $ uv sync
  

• Install Transifex CLI tool (refer to Installation instructions):

  $ curl -o- https://raw.githubusercontent.com/transifex/cli/master/install.sh | bash
  

Testing

Tests with supported python version that are in:

• tox.ini

• .github/workflow/ci.yml

Run test

Just run tox:

$ tox

tox have several sections for testing.

CI (Continuous Integration)

All tests will be run on GitHub Actions.

• https://github.com/sphinx-doc/sphinx-intl/tree/master/.github/workflows/

Releasing

New package version

The sphinx-intl package will be uploaded to PyPI: https://pypi.org/project/sphinx-intl/.

Here is a release procedure:

Procedure:

1. update release version/date in CHANGES.rst

2. create GitHub Release with new version tag, it will create a release on PyPI. tag MUST following semver. e.g.: 2.3.1

3. check PyPI page: https://pypi.org/p/sphinx-intl

4. prepareing for the next release: bump version in CHANGES.rst then commit/push it onto GitHub

Updated documentation

Sphinx documentation under doc/ directory on the master branch will be automatically uploaded into ReadTheDocs: http://sphinx-intl.rtfd.io/.