Flask Docs Translation

Contributing Guide

Installation

• Click the "Fork" button to fork this repository on GitHub.
• Clone your fork repository locally (replace {username} with your username):

$ git clone https://github.com/{username}/flask-docs-fr.git
$ cd flask-docs-fr
$ git remote add upstream https://github.com/vlevieux/flask-docs-fr

• Create a virtual environment and install requirements:

For Linux/macOS:

$ python3 -m venv env
$ source env/bin/activate
$ python -m pip install --upgrade pip setuptools
$ pip install -r requirements/dev.txt
$ pip install -e .
$ pre-commit install

For Windows:

> python -m venv env
> env\Scripts\activate
> python -m pip install --upgrade pip setuptools
> pip install -r .\requirements\dev.txt
> pip install -e .
> pre-commit install

Self-Assignment

• Open https://github.com/vlevieux/flask-docs-fr/edit/main/README.md.
• Find the "Translation To-do List" section, mark the chapter you want to translate in following format:

- [ ] example @your_username Your Name

You can link the username to your GitHub profile:

- [ ] example [@your_username](https://github.com/your_username) Your Name

• Leave a commit message (e.g., "Assign example to @your_username"), then click the "Propose changes" button to create a PR.

Recommended Translation software

As explained below, translations are done using .po files. One good editor is POEdit (not to be confused with POEditor)

Translation

• When the self-assignment PR is merged, create a new branch locally (be sure to update the example branch name, for example, translate-cli):

$ git fetch upstream
$ git checkout -b your-branch-name upstream/main

• Translate the .po file in the docs/locales/fr/LC_MESSAGES directory.

An example of one such file, from docs/.../index.po, is given below.

#: ../../index.rst:4
msgid "Welcome to Flask"
msgstr "Bienvenue sur Flask"

Another case, msgid is multi-line text and contains reStructuredText syntax:

#: ../../index.rst:11
msgid ""
"Welcome to Flask's documentation. Get started with :doc:`installation` "
"and then get an overview with the :doc:`quickstart`."
msgstr ""
"Bienvenue sur la documentation de Flask. Commencez par consulter le document "
":doc:`installation`, puis obtenez un aperçu avec le document :doc:`quickstart`."

Please be careful not to break reST notation. Most po-editors will help you with that.

• Mark the chapter as finished (fill the checkbox with "x"):

- [x] example @your_username Your Name

• Update the Last-Translator field at the top of the .po file.
• Commit the changes:

$ git add docs/locales/fr/LC_MESSAGES/example.po README.md
$ git commit -m "Translate docs/example"

• Build the docs and preview the changes:

For Linux/macOS:

$ cd docs
$ make html

For Windows:

> cd docs
> .\make.bat html

Open {project_location}/docs/_build/html/index.html in your browser to view the docs.

• If everything is working as expected, push the changes to GitHub:

$ git push origin your-branch-name

• Open the home page of your forked repository, you will see a notice about the new branch. Click the "Compare & pull request" button to create a PR.
• The translation coordinator will review your PR very soon. Thank you!

Translation To-do List

Be sure only mark one chapter at a time, mark another one when the former PR is created. Unless it's a long chapter, we may reset the assignment if you doesn't finish the translation in ten days.

docs/

• advanced_foreword (reserved) @vlevieux Victor LEVIEUX
• appcontext
• async-await
• becomingbig
• blueprints
• changes
• cli
• config @vlevieux Victor LEVIEUX
• contributing
• debugging
• design
• errorhandling @vlevieux Victor LEVIEUX
• extensiondev
• extensions
• foreword (reserved) @vlevieux Victor LEVIEUX
• htmlfaq
• index (reserved) @vlevieux Victor LEVIEUX
• installation (reserved) @vlevieux Victor LEVIEUX
• logging (reserved) @Mindiell
• quickstart (reserved) @vlevieux Victor LEVIEUX
• reqcontext
• security
• server
• shell
• signals
• templating @vlevieux Victor LEVIEUX
• testing @vlevieux Victor LEVIEUX
• views

docs/tutorial/ (reserved)

• blog @vlevieux Victor LEVIEUX
• database @vlevieux Victor LEVIEUX
• deploy @vlevieux Victor LEVIEUX
• factory @vlevieux Victor LEVIEUX
• index @vlevieux Victor LEVIEUX
• install @vlevieux Victor LEVIEUX
• layout @vlevieux Victor LEVIEUX
• next @vlevieux Victor LEVIEUX
• static @vlevieux Victor LEVIEUX
• templates @vlevieux Victor LEVIEUX
• tests @vlevieux Victor LEVIEUX
• views @vlevieux Victor LEVIEUX

docs/deploying/

• asgi (reserved) @Mindiell
• cgi (reserved) @Mindiell
• fastcgi (reserved) @Mindiell
• index (reserved) @Mindiell
• mod_wsgi (reserved) @Mindiell
• uwsgi (reserved) @Mindiell
• wsgi-standalone (reserved) @Mindiell

docs/patterns/

• appdispatch
• appfactories
• caching
• celery
• deferredcallbacks
• distribute
• fabric
• favicon
• fileuploads
• flashing
• index
• jquery
• lazyloading
• methodoverrides
• mongoengine
• packages
• requestchecksum
• singlepageapplications
• sqlalchemy
• sqlite3
• streaming
• subclassing
• templateinheritance
• urlprocessors
• viewdecorators
• wtforms

docs/api

• L0~L1000
• L1000~L1500
• L1500~L2000
• L2000~L2500
• L2500~L3000
• L3000~L3500
• L3500~L4000
• L4000~L4500
• L4500~L5000
• L5000~L5500
• L5500~L6000
• L6000~L6500