Skip to content

Translation Repository for frc-docs

License

Apache-2.0, Unknown licenses found

Licenses found

Apache-2.0
LICENSE
Unknown
license.txt
Notifications You must be signed in to change notification settings

wpilibsuite/frc-docs-translations

Folders and files

NameName
Last commit message
Last commit date

Latest commit

d42ebe2 · Mar 27, 2025
Jun 11, 2024
Mar 27, 2025
Mar 21, 2025
Jul 27, 2020
Mar 18, 2025
May 10, 2023
Aug 28, 2020
Jun 26, 2020
Aug 9, 2022
Jul 27, 2020
Oct 28, 2023
Jun 26, 2020
Jan 28, 2023
Aug 9, 2022

Repository files navigation

Update Translations

frc-docs-translations

This is the central repository that RTD points toward to view translations.

Interested in Translating?

Please visit the translation guide here

Building Locally

Please note: Python 3.6 or higher is required to build this documentation

First, clone this repo using the follwowing command

  • git clone --recurse-submodules https://github.com/wpilibsuite/frc-docs-translations.git

and ensure that all requirements are up-to-date by running

  • pip install -r frc-docs/source/requirements.txt

Translated documents can be built by running

  • sphinx-build -D language=LANG -b html . _build/html

where LANG is the locale code of your language. You can view a list of supported locales, by checking the locale directory.

Updating Translations

Grabbing your API Key

Updating translations locally requires a Transifex API key. To get started, select your avatar in the top right of the transifex dashboard.

Then select "User settings"

Then select the "API token" option in the lefthand menu.

Now press the "Generate a token" button

This will bring up a screen containing your API key. Write this down and save it.

Pulling from Transifex

The first step is to generate all translatable files from Sphinx. This can be done with the gettext builder. Type the below command to generate translatable POT files.

sphinx-build -T -b gettext frc-docs/source locale/pot

Go ahead and run the below command to save your transifex token to the python transifex client.

tx init --force-save

This will bring up a prompt where you can paste in your API token.

Now we need to grab a list of currently used resources (and their slugs) to grab from transifex. Go ahead and run the command below to do that.

sphinx-intl update-txconfig-resources -p locale/pot -d locale --transifex-project-name frc-docs

In the translation project directory, the below command can be used to grab all reviewed French (Canada) translations.

tx pull -l fr_CA --mode onlyreviewed --use-git-timestamps

You can replace fr_CA with the language code that you want to pull from transifex.