Skip to content

In the turtledemo docs, some scripts and functions names are being translated #139533

@aureliobarbosa

Description

@aureliobarbosa

Documentation on module turtledemo

Currently turtledemo documentation provides a table of listing demo scripts, which are expected to be run as:

python -m turtledemo.clock

Nevertheless the script names are not marked as code and, in some cases, they represent words and get translated by internationalization teams. As an example the script clock got translated to relógio in Brazilian Portuguese and as reloj in Spanish.

The same table also presents a column showcasing the features of each script, which is a typically a small description and/or a list of functions being used in a given script. Some of these functions are properly marked as functions, while others aren't. This implies it is also possible that some of them got translated by internationalization teams. As an example, the function update (which is a method from turtle.screen.update) was eventually translated as atualizar in Brazilian Portuguese.

The solution for these issues is similar and consists in marking them as code using reStructuredText markups used on this repo. I already tested this locally and will submit a PR in the following.

(I would like to thank the python pt-br translation team, particularly @adorilson and Rafael for pointing that the problem should be bigger than the translation to brazilian portuguese alone.)

Linked PRs

Metadata

Metadata

Assignees

No one assigned

    Labels

    docsDocumentation in the Doc dir

    Projects

    Status

    No status

    Status

    Todo

    Status

    In Progress

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions