This project is used as a preview, not yet used for production workflow. Integrations efforts are ongoing as well as figuring out the funding.

Please refer to https://devguide.python.org/documentation/translating/ for guidance about the translations.

This project is in a trial period, be cautious while contributing. Setup can still change before being approved as a libre project.

Source strings

428 Strings 100%
Browse Translate
8,331 Words 100%
54,557 Characters 100%
This translation is being used as source strings within this component.

Strings status

Strings Words Characters
428 8,331 54,557
All strings Browse Translate Zen
428 8,331 54,557
Read-only strings Browse Translate Zen
2 63 421
Strings with any failing checks Browse Translate Zen
2 63 421
Failing check: Ellipsis Browse Translate Zen

Overview

Project website docs.python.org
Instructions for translators

See devguide.python.org/documentation/translating.
Project maintainers User avatar rafaelff User avatar josix User avatar m-aciek
Translation license Creative Commons Zero v1.0 Universal
Translation process
  • Translations can be made directly.
  • Translation suggestions can be made.
  • Any authenticated user can contribute.
  • The translation uses bilingual files.
Source code repository git@github.com:m-aciek/python-docs-weblate.git
Repository branch main
Last remote commit [3.12] Misc cleanups and wording improvements for the itertools docs (gh-119631) b5b47cc
github-actions[bot] authored an hour ago
Weblate repository https://hosted.weblate.org/git/python-docs/latest/bugs/
File mask */latest/howto/clinic.po
Translation file Not available
Last change Nov. 8, 2023, 10:19 p.m.
Last author None
2 weeks ago

String statistics

Strings percent Hosted strings Words percent Hosted words Characters percent Hosted characters
Total 428 8,331 54,557
Translated 100% 428 100% 8,331 100% 54,557
Needs editing 0% 0 0% 0 0% 0
Read-only 100% 428 100% 8,331 100% 54,557
Failing checks 1% 2 1% 63 1% 421
Strings with suggestions 0% 0 0% 0 0% 0
Untranslated strings 0% 0 0% 0 0% 0
Last 12 months Previous

Activity in last 12 months

0 changes 0 changes 0 changes 0 changes 0 changes 0 changes 0 changes 0 changes 0 changes 0 changes 0 changes 0 changes 0 changes 428 changes 0 changes 0 changes 0 changes 0 changes 0 changes 0 changes 0 changes 0 changes 0 changes 0 changes
May Jun Jul Aug Sep Oct Nov Dec Jan Feb Mar Apr

Quick numbers

8,331
Hosted words
428
Hosted strings
100%
Translated
0
Contributors
and previous 30 days

Trends of last 30 days

—
Hosted words
+100%
—
Hosted strings
+100%
—
Translated
+100%
—
Contributors
—
User avatar None

Source string added

  1. Python documentation
  2. 3.12
  3. latest/howto/clinic
  4. English
Since Python comments are different from C comments, Argument Clinic blocks embedded in Python files look slightly different. They look like this:
6 months ago
User avatar None

Source string added

  1. Python documentation
  2. 3.12
  3. latest/howto/clinic
  4. English
It's actually possible to use Argument Clinic to preprocess Python files. There's no point to using Argument Clinic blocks, of course, as the output wouldn't make any sense to the Python interpreter. But using Argument Clinic to run Python blocks lets you use Python as a Python preprocessor!
6 months ago
User avatar None

Source string added

  1. Python documentation
  2. 3.12
  3. latest/howto/clinic
  4. English
Using Argument Clinic in Python files
6 months ago
User avatar None

Source string added

  1. Python documentation
  2. 3.12
  3. latest/howto/clinic
  4. English
When this happens, just open your file, find the ``dump buffer`` block that Argument Clinic added to your file (it'll be at the very bottom), then move it above the ``PyMethodDef`` structure where that macro is used.
6 months ago
User avatar None

Source string added

  1. Python documentation
  2. 3.12
  3. latest/howto/clinic
  4. English
In this situation, Argument Clinic writes the extra code to the "buffer" destination. This may mean that you get a complaint from Argument Clinic:
6 months ago
User avatar None

Source string added

  1. Python documentation
  2. 3.12
  3. latest/howto/clinic
  4. English
However, this causes one ticklish problem: where should Argument Clinic put this extra code when using the "block" output preset? It can't go in the output block, because that could be deactivated by the ``#ifdef``. (That's the whole point!)
6 months ago
User avatar None

Source string added

  1. Python documentation
  2. 3.12
  3. latest/howto/clinic
  4. English
That means the macro always works. If the function is defined, this turns into the correct structure, including the trailing comma. If the function is undefined, this turns into nothing.
6 months ago
User avatar None

Source string added

  1. Python documentation
  2. 3.12
  3. latest/howto/clinic
  4. English
Here's where Argument Clinic gets very clever. It actually detects that the Argument Clinic block might be deactivated by the ``#ifdef``. When that happens, it generates a little extra code that looks like this::
6 months ago
User avatar None

Source string added

  1. Python documentation
  2. 3.12
  3. latest/howto/clinic
  4. English
Perhaps you're wondering: what if ``HAVE_FUNCTIONNAME`` isn't defined? The ``MODULE_FUNCTIONNAME_METHODDEF`` macro won't be defined either!
6 months ago
User avatar None

Source string added

  1. Python documentation
  2. 3.12
  3. latest/howto/clinic
  4. English
(You can find the real name for this macro inside the generated code. Or you can calculate it yourself: it's the name of your function as defined on the first line of your block, but with periods changed to underscores, uppercased, and ``"_METHODDEF"`` added to the end.)
6 months ago
Browse all translation changes