Help translate the Python Package Guide into Spanish

[flpm]

We are currently working on translating the Python Package Guide into Spanish and we could use the help of new contributors. This is a great issue to work on if you speak Spanish and you are new to open source contributions!

How to help

The guide is divided in sections. The English text in each section is extracted and stored in a .po in the folder ./locales/es/LC_MESSAGES. Next to each of the original English string, you will find a place to enter the Spanish translation for that string.

Start by looking at the Translation Guide, it describes the translation workflow and has instructions about how to set up your local environment to work on translations.

If you are new to open source contributions, you can also contribute directly in the GitHub website. In that case you will need to fork the repository into your personal GitHub and make the changes on your forked copy before making a Pull Request. Some sections of the Translation Guide will still be useful, like Editing the Translation Files and Frequently Asked Questions (FAQ).

Look at the table below and choose a translation file to work on. The files are named after the sections of the guide.

Look at the comments to this issue and check if someone else is already working on that file. If nobody is, add a comment to this issue indicating that you will start working on that file.

If someone else is already working on the file, you will need to coordinate with them to make sure you don't duplicate work.

If you want to see an example of a file that already has been translated, take a look at ./locales/es/LC_MESSAGES/index.po. It contains the strings for the landing page of the guide.

Translation Status as of 09/14/2024

We are about 27% done!

The table below shows the number of strings in each translation file. Strings marked 'fuzzy' indicate that the original text has changed and the translation needs to be reviewed and fixed if necessary.

Translation file	Status	Translated	Fuzzy	Untranslated	Contributions from
documentation.po		52	0	378	@yardasol and @RobPasMue
index.po	done	92	0	1	@flpm
package-structure-code.po		399	0	486	@RobPasMue
tests.po	done	158	0	0	@flpm
tutorials.po		17	0	933	@ncclementi
CONTRIBUTING.po	-	-	-	-	Do not translate, original file is not finished yet.
TRANSLATING.po	-	-	-	-	Do not translate, original file is not finished yet.

[RobPasMue]

Working on this! #SciPy2024! --> Working mostly on CONTRIBUTING.md

[yardasol]

Same here!

[flpm]

@RobPasMue @yardasol We are currently rewriting the English file in issue #310, so it's NOT the best one to work on!

[flpm]

Some of the files are very big, but you don't need to translate it all! Feel free to work on as few strings as you want. If you both decide to work on the same file, you will need to coordinate to avoid double work.

[RobPasMue]

Gotcha thanks @flpm - I'll work on https://github.com/pyOpenSci/python-package-guide/blob/main/locales/es/LC_MESSAGES/package-structure-code.po

[RobPasMue]

I opened independent PRs for all the files in the packaging guide. This will take time to review but I'll be as responsive and active as possible. Just want to help you all!

[flpm]

This is awesome! Thanks everyone 😍

[flpm]

I updated the text of the issue with the stats as of today (pending a few PR waiting review). We are about 27% done.