Docs: source code don't can be translate

[adorilson]

BPO	38057
Nosy	@terryjreedy, @ammaraskar, @adorilson

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2019-09-14.06:28:09.869>
created_at = <Date 2019-09-08.14:58:23.285>
labels = ['invalid', 'type-feature', '3.8', 'docs']
title = "Docs: source code don't can be translate"
updated_at = <Date 2019-09-14.06:28:09.866>
user = 'https://github.com/adorilson'

bugs.python.org fields:

activity = <Date 2019-09-14.06:28:09.866>
actor = 'terry.reedy'
assignee = 'docs@python'
closed = True
closed_date = <Date 2019-09-14.06:28:09.869>
closer = 'terry.reedy'
components = ['Documentation']
creation = <Date 2019-09-08.14:58:23.285>
creator = 'adorilson'
dependencies = []
files = []
hgrepos = []
issue_num = 38057
keywords = []
message_count = 4.0
messages = ['351330', '351333', '351334', '352415']
nosy_count = 4.0
nosy_names = ['terry.reedy', 'docs@python', 'ammar2', 'adorilson']
pr_nums = []
priority = 'normal'
resolution = 'not a bug'
stage = 'resolved'
status = 'closed'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue38057'
versions = ['Python 3.8']

[adorilson]

The source code examples in documentation doesn't can be translated because it doesn't included in po files (and after in transifex).

It would be wonderful if we can to translate the code:

class MyClass:
    """A simple example class"""
    i = 12345

    def f(self):
        return 'hello world'

to:

class MinhaClasse:
    """Um exemplo simples de classe"""
    i = 12345
    def f(self):
        return 'olá, mundo'

[ammaraskar]

What version of Sphinx are you using? As far as I know, Sphinx supports internationalization for autodoc, so this should be possible.

[adorilson]

I'm not using the Sphinx itself. I'm just a translator.

[terryjreedy]

This tracker is for issues possibly leading to patches for the CPython repository. Translations are not part of this repository and I am pretty sure that .po files are not either.