Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly
Appearance settings

Commit 9638aea

Browse filesBrowse files
gilgamezhgilgamezh
authored
Merge pull request python#27 from raulcd/rst2po
Script `rst2po.py` to migrate tutorial.python.org.ar to this new version
2 parents 912fe24 + 322f1a7 commit 9638aea
Copy full SHA for 9638aea

File tree

Expand file treeCollapse file tree

15 files changed

+2415
-714
lines changed
Filter options
Expand file treeCollapse file tree

15 files changed

+2415
-714
lines changed

‎.gitmodules

Copy file name to clipboardExpand all lines: .gitmodules
+3Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,3 +3,6 @@
33
url = https://github.com/python/cpython.git
44
branch = 3.7
55
shallow = true
6+
[submodule "tutorialpyar"]
7+
path = .migration/tutorialpyar
8+
url = https://github.com/pyar/tutorial.git

‎.migration/rst2po.py

Copy file name to clipboard
+134Lines changed: 134 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,134 @@
1+
# rst2po.py
2+
# Script to migrate the Python official tutorial that we have already translated in PyAr
3+
# (https://github.com/PyAr/tutorial) from reStructuredText to the new official translation format (.po)
4+
#
5+
# It parses the .rst and compare sentence/paragraph by sentence/paragraph and if the match is exact,
6+
# and there is no translation for that sentence/paragraph it updates the .po file with the translated text
7+
# from the .rst file.
8+
9+
import re
10+
import glob
11+
import os
12+
import polib # fades
13+
14+
15+
PO_DIR = os.path.abspath(
16+
os.path.join(
17+
os.path.dirname(__file__),
18+
'..',
19+
))
20+
21+
RST_TRADUCIDOS_DIR = os.path.abspath(
22+
os.path.join(
23+
os.path.dirname(__file__),
24+
'tutorialpyar',
25+
'traducidos',
26+
))
27+
28+
RST_ORIGINAL_DIR = os.path.abspath(
29+
os.path.join(
30+
os.path.dirname(__file__),
31+
'tutorialpyar',
32+
'original',
33+
))
34+
35+
36+
37+
def get_rst_file(pofilename):
38+
"""Given a .po filename returns the corresponding .rst filename"""
39+
basename = os.path.basename(pofilename)
40+
basename, ext = basename.rsplit('.', 1)
41+
rstfilename = os.path.join(RST_TRADUCIDOS_DIR, f'{basename}.rst')
42+
if os.path.exists(rstfilename):
43+
return rstfilename
44+
45+
46+
def get_rst_original_filename(rstfilename):
47+
rst_original_filename = ''
48+
if rstfilename.endswith('real-index.rst'):
49+
rst_original_filename = 'index.rst'
50+
51+
basename = os.path.basename(rst_original_filename or rstfilename)
52+
rst_original_filename = os.path.join(RST_ORIGINAL_DIR, basename)
53+
if os.path.exists(rst_original_filename):
54+
return rst_original_filename
55+
56+
57+
def create_english_spanish_sentences(rstfilename):
58+
"""Create a tuple of (english, spanish) sentences for rstfilename"""
59+
60+
def get_paragraph(fd):
61+
lines = []
62+
paragraph = []
63+
for line in fd.read().splitlines():
64+
# import pdb; pdb.set_trace()
65+
if any([
66+
line.startswith('.. '),
67+
line.startswith('==='),
68+
line.startswith('---'),
69+
line.startswith('***'),
70+
]):
71+
continue
72+
73+
if line == '' and not paragraph:
74+
continue
75+
76+
if line == '':
77+
lines.append(' '.join(paragraph))
78+
paragraph = []
79+
continue
80+
paragraph.append(line)
81+
82+
return lines
83+
84+
# NOTE: we could use docutils and parse the rst in the correct way, but
85+
# that will probably take more time
86+
with open(get_rst_original_filename(rstfilename)) as fd:
87+
english = get_paragraph(fd)
88+
89+
with open(rstfilename) as fd:
90+
spanish = get_paragraph(fd)
91+
92+
result = list(zip(english, spanish))
93+
return result
94+
95+
96+
def get_rst_translation_text(rstfilename, english_spanish, text):
97+
"""Given an rstfilename an a text returns the corresponding translated text if exists"""
98+
for en, es in english_spanish:
99+
if en.replace("!", "") == text.replace("!", ""):
100+
return es
101+
102+
103+
def update_po_translation(pofilename, english, spanish):
104+
"""Update the pofilename with the translated spanish text"""
105+
pass
106+
107+
108+
for pofilename in glob.glob(PO_DIR + '**/*/*.po'):
109+
translated = False
110+
rstfilename = get_rst_file(pofilename)
111+
if rstfilename is None:
112+
continue
113+
114+
english_spanish = create_english_spanish_sentences(rstfilename)
115+
116+
po = polib.pofile(pofilename)
117+
for entry in po:
118+
english_text = entry.msgid
119+
spanish_text = entry.msgstr
120+
if spanish_text:
121+
# Do not override already translated text
122+
continue
123+
124+
translated_text = get_rst_translation_text(rstfilename, english_spanish, english_text)
125+
if translated_text is None:
126+
continue
127+
128+
translated = True
129+
130+
entry.msgstr = translated_text
131+
# update_po_translation(po, english_text, translated_text)
132+
133+
if translated:
134+
po.save(pofilename)

‎.migration/tutorialpyar

Copy file name to clipboard
Submodule tutorialpyar added at 0349d89

‎tutorial/appendix.po

Copy file name to clipboardExpand all lines: tutorial/appendix.po
+91-30Lines changed: 91 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -18,63 +18,90 @@ msgstr ""
1818

1919
#: ../Doc/tutorial/appendix.rst:5
2020
msgid "Appendix"
21-
msgstr ""
21+
msgstr "Apéndice"
2222

2323
#: ../Doc/tutorial/appendix.rst:11
2424
msgid "Interactive Mode"
25-
msgstr ""
25+
msgstr "Modo interactivo"
2626

2727
#: ../Doc/tutorial/appendix.rst:16
2828
msgid "Error Handling"
29-
msgstr ""
29+
msgstr "Manejo de errores"
3030

3131
#: ../Doc/tutorial/appendix.rst:18
3232
msgid ""
3333
"When an error occurs, the interpreter prints an error message and a stack "
3434
"trace. In interactive mode, it then returns to the primary prompt; when "
3535
"input came from a file, it exits with a nonzero exit status after printing "
36-
"the stack trace. (Exceptions handled by an :keyword:`except` clause in a :"
37-
"keyword:`try` statement are not errors in this context.) Some errors are "
38-
"unconditionally fatal and cause an exit with a nonzero exit; this applies to "
39-
"internal inconsistencies and some cases of running out of memory. All error "
40-
"messages are written to the standard error stream; normal output from "
36+
"the stack trace. (Exceptions handled by an :keyword:`except` clause in a "
37+
":keyword:`try` statement are not errors in this context.) Some errors are "
38+
"unconditionally fatal and cause an exit with a nonzero exit; this applies to"
39+
" internal inconsistencies and some cases of running out of memory. All "
40+
"error messages are written to the standard error stream; normal output from "
4141
"executed commands is written to standard output."
4242
msgstr ""
43+
"Cuando ocurre un error, el intérprete imprime un mensaje de error y la traza"
44+
" del error. En el modo interactivo, luego retorna al prompt primario; "
45+
"cuando la entrada viene de un archivo, el programa termina con código de "
46+
"salida distinto a cero luego de imprimir la traza del error. (Las "
47+
"excepciones manejadas por una clausula :keyword:`except` en una sentencia "
48+
":keyword:`try` no son errores en este contexto). Algunos errores son "
49+
"incondicionalmente fatales y causan una terminación con código de salida "
50+
"distinto de cero; esto se debe a inconsistencias internas o a que el "
51+
"intérprete se queda sin memoria. Todos los mensajes de error se escriben en "
52+
"el flujo de errores estándar; las salidas normales de comandos ejecutados se"
53+
" escriben en la salida estándar."
4354

4455
#: ../Doc/tutorial/appendix.rst:28
4556
msgid ""
4657
"Typing the interrupt character (usually :kbd:`Control-C` or :kbd:`Delete`) "
4758
"to the primary or secondary prompt cancels the input and returns to the "
48-
"primary prompt. [#]_ Typing an interrupt while a command is executing raises "
49-
"the :exc:`KeyboardInterrupt` exception, which may be handled by a :keyword:"
50-
"`try` statement."
59+
"primary prompt. [#]_ Typing an interrupt while a command is executing raises"
60+
" the :exc:`KeyboardInterrupt` exception, which may be handled by a "
61+
":keyword:`try` statement."
5162
msgstr ""
63+
"Al ingresar el caracter de interrupción (por lo general :kbd:`Control-C` o "
64+
":kbd:`Supr`) en el prompt primario o secundario, se cancela la entrada y "
65+
"retorna al prompt primario. [#]_ Tipear una interrupción mientras un "
66+
"comando se están ejecutando lanza la excepción :exc:`KeyboardInterrupt`, que"
67+
" puede ser manejada con una sentencia :keyword:`try`."
5268

5369
#: ../Doc/tutorial/appendix.rst:38
5470
msgid "Executable Python Scripts"
55-
msgstr ""
71+
msgstr "Programas ejecutables de Python"
5672

5773
#: ../Doc/tutorial/appendix.rst:40
5874
msgid ""
5975
"On BSD'ish Unix systems, Python scripts can be made directly executable, "
6076
"like shell scripts, by putting the line ::"
6177
msgstr ""
78+
"En los sistemas Unix y tipo BSD, los programas Python pueden convertirse "
79+
"directamente en ejecutables, como programas del intérprete de comandos, "
80+
"poniendo la linea::"
6281

6382
#: ../Doc/tutorial/appendix.rst:45
6483
msgid ""
6584
"(assuming that the interpreter is on the user's :envvar:`PATH`) at the "
6685
"beginning of the script and giving the file an executable mode. The ``#!`` "
67-
"must be the first two characters of the file. On some platforms, this first "
68-
"line must end with a Unix-style line ending (``'\\n'``), not a Windows "
86+
"must be the first two characters of the file. On some platforms, this first"
87+
" line must end with a Unix-style line ending (``'\\n'``), not a Windows "
6988
"(``'\\r\\n'``) line ending. Note that the hash, or pound, character, "
7089
"``'#'``, is used to start a comment in Python."
7190
msgstr ""
91+
"...al principio del script y dándole al archivo permisos de ejecución "
92+
"(asumiendo que el intérprete están en la variable de entorno :envvar:`PATH` "
93+
"del usuario). ``#!`` deben ser los primeros dos caracteres del archivo. En"
94+
" algunas plataformas, la primera línea debe terminar al estilo Unix "
95+
"(``'\\n'``), no como en Windows (``'\\r\\n'``). Notá que el caracter "
96+
"numeral ``'#'`` se usa en Python para comenzar un comentario."
7297

7398
#: ../Doc/tutorial/appendix.rst:52
7499
msgid ""
75-
"The script can be given an executable mode, or permission, using the :"
76-
"program:`chmod` command."
100+
"The script can be given an executable mode, or permission, using the "
101+
":program:`chmod` command."
77102
msgstr ""
103+
"Se le puede dar permisos de ejecución al script usando el comando "
104+
":program:`chmod`::"
78105

79106
#: ../Doc/tutorial/appendix.rst:59
80107
msgid ""
@@ -84,10 +111,15 @@ msgid ""
84111
"extension can also be ``.pyw``, in that case, the console window that "
85112
"normally appears is suppressed."
86113
msgstr ""
114+
"En sistemas Windows, no existe la noción de \"modo ejecutable\". El "
115+
"instalador de Python asocia automáticamente la extensión ``.py`` con "
116+
"``python.exe`` para que al hacerle doble click a un archivo Python se corra "
117+
"el script. La extensión también puede ser ``.pyw``, en este caso se omite "
118+
"la ventana con la consola que normalmente aparece."
87119

88120
#: ../Doc/tutorial/appendix.rst:69
89121
msgid "The Interactive Startup File"
90-
msgstr ""
122+
msgstr "El archivo de inicio interactivo"
91123

92124
#: ../Doc/tutorial/appendix.rst:71
93125
msgid ""
@@ -97,54 +129,83 @@ msgid ""
97129
"the name of a file containing your start-up commands. This is similar to "
98130
"the :file:`.profile` feature of the Unix shells."
99131
msgstr ""
132+
"Cuando usás Python en forma interactiva, suele ser útil que algunos comandos"
133+
" estándar se ejecuten cada vez que el intérprete se inicia. Podés hacer "
134+
"esto configurando la variable de entorno :envvar:`PYTHONSTARTUP` con el "
135+
"nombre de un archivo que contenga tus comandos de inicio. Esto es similar "
136+
"al archivo :file:`.profile` en los intérpretes de comandos de Unix."
100137

101138
#: ../Doc/tutorial/appendix.rst:77
102139
msgid ""
103140
"This file is only read in interactive sessions, not when Python reads "
104141
"commands from a script, and not when :file:`/dev/tty` is given as the "
105142
"explicit source of commands (which otherwise behaves like an interactive "
106143
"session). It is executed in the same namespace where interactive commands "
107-
"are executed, so that objects that it defines or imports can be used without "
108-
"qualification in the interactive session. You can also change the prompts "
144+
"are executed, so that objects that it defines or imports can be used without"
145+
" qualification in the interactive session. You can also change the prompts "
109146
"``sys.ps1`` and ``sys.ps2`` in this file."
110147
msgstr ""
148+
"Este archivo es solo leído en las sesiones interactivas del intérprete, no "
149+
"cuando Python lee comandos de un script ni cuando :file:`/dev/tty` se "
150+
"explicita como una fuente de comandos (que de otro modo se comporta como una"
151+
" sesión interactiva). Se ejecuta en el mismo espacio de nombres en el que "
152+
"los comandos interactivos se ejecutan, entonces los objetos que define o "
153+
"importa pueden ser usados sin cualificaciones en la sesión interactiva. En "
154+
"este archivo también podés cambiar los prompts ``sys.ps1`` y ``sys.ps2``."
111155

112156
#: ../Doc/tutorial/appendix.rst:85
113157
msgid ""
114158
"If you want to read an additional start-up file from the current directory, "
115-
"you can program this in the global start-up file using code like ``if os."
116-
"path.isfile('.pythonrc.py'): exec(open('.pythonrc.py').read())``. If you "
117-
"want to use the startup file in a script, you must do this explicitly in the "
118-
"script::"
159+
"you can program this in the global start-up file using code like ``if "
160+
"os.path.isfile('.pythonrc.py'): exec(open('.pythonrc.py').read())``. If you "
161+
"want to use the startup file in a script, you must do this explicitly in the"
162+
" script::"
119163
msgstr ""
164+
"Si querés leer un archivo de inicio adicional desde el directorio actual, "
165+
"podés programarlo en el archivo de inicio global usando algo como ``if "
166+
"os.path.isfile('.pythonrc.py'): exec(open('.pythonrc.py').read())``. Si "
167+
"querés usar el archivo de inicio en un script, tenés que hacer lo siguiente "
168+
"de forma explícita en el script::"
120169

121170
#: ../Doc/tutorial/appendix.rst:102
122171
msgid "The Customization Modules"
123-
msgstr ""
172+
msgstr "Los módulos de customización"
124173

125174
#: ../Doc/tutorial/appendix.rst:104
126175
msgid ""
127-
"Python provides two hooks to let you customize it: :mod:`sitecustomize` and :"
128-
"mod:`usercustomize`. To see how it works, you need first to find the "
176+
"Python provides two hooks to let you customize it: :mod:`sitecustomize` and "
177+
":mod:`usercustomize`. To see how it works, you need first to find the "
129178
"location of your user site-packages directory. Start Python and run this "
130179
"code::"
131180
msgstr ""
181+
"Python provee dos formas para customizarlo: :mod:`sitecustomize` y "
182+
":mod:`usercustomize`. Para ver como funciona, necesitás primero encontrar "
183+
"dónde está tu directorio para tu usuario de paquetes del sistema. Arrancá "
184+
"Python y ejecutá el siguiente código::"
132185

133186
#: ../Doc/tutorial/appendix.rst:112
134187
msgid ""
135188
"Now you can create a file named :file:`usercustomize.py` in that directory "
136-
"and put anything you want in it. It will affect every invocation of Python, "
137-
"unless it is started with the :option:`-s` option to disable the automatic "
189+
"and put anything you want in it. It will affect every invocation of Python,"
190+
" unless it is started with the :option:`-s` option to disable the automatic "
138191
"import."
139192
msgstr ""
193+
"Ahora podés crear un archivo llamado :file:`usercustomize.py` en ese "
194+
"directorio y poner lo que quieras en él. Eso afectará cada ejecución de "
195+
"Python, a menos que se arranque con la opción :option:`-s` para deshabilitar"
196+
" esta importación automática."
140197

141198
#: ../Doc/tutorial/appendix.rst:116
142199
msgid ""
143200
":mod:`sitecustomize` works in the same way, but is typically created by an "
144201
"administrator of the computer in the global site-packages directory, and is "
145-
"imported before :mod:`usercustomize`. See the documentation of the :mod:"
146-
"`site` module for more details."
202+
"imported before :mod:`usercustomize`. See the documentation of the "
203+
":mod:`site` module for more details."
147204
msgstr ""
205+
":mod:`sitecustomize` funciona de la misma manera, pero normalmente lo crea "
206+
"el administrador de la computadora en el directorio global de paquetes para "
207+
"el sistema, y se importa antes que :mod:`usercustomize`. Para más detalles, "
208+
"mirá la documentación del módulo :mod:`site`."
148209

149210
#: ../Doc/tutorial/appendix.rst:123
150211
msgid "Footnotes"

0 commit comments

Comments
0 (0)
Morty Proxy This is a proxified and sanitized view of the page, visit original site.