Skip to content

Commit 71b0d2e

Browse files
authored
Update README.rst
1 parent 12233af commit 71b0d2e

File tree

1 file changed

+21
-4
lines changed

1 file changed

+21
-4
lines changed

README.rst

Lines changed: 21 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -23,16 +23,16 @@ astfel:
2323

2424
- descărcăm într-un director convenabil codul-sursă al celei mai recente
2525
versiuni **stabile** de Python (aceeași ca mai sus); de exemplu,
26-
`3.13.3 <https://www.python.org/downloads/source/>`_;
26+
`3.13.5 <https://www.python.org/downloads/source/>`_;
2727
- în subdirectorul **Doc** al codului-sursă Python se găsește fișierul
2828
**conf.py**, la sfârșitul căruia adăugăm::
2929

3030
# Optiuni pentru traducerea in romaneste
31-
# Adaugat in [ 09.05.2025 ]
31+
# Adaugat in [ 17.06.2025 ]
3232
# Conform [ https://www.sphinx-doc.org/en/master/usage/advanced/intl.html ]
3333
# -------------------------------------------------------------------------
3434

35-
locale_dirs = ['locale_python_3_13_3/'] # path is example but recommended.
35+
locale_dirs = ['locale_python_3_13_5/'] # path is example but recommended.
3636
gettext_compact = False # optional.
3737
language = 'ro'
3838

@@ -50,7 +50,7 @@ astfel:
5050

5151
sphinx-intl update -p build/gettext -l ro
5252

53-
va produce subdirectorul **locale_python_3_13_3/ro/LC_MESSAGES** al directorului
53+
va produce subdirectorul **locale_python_3_13_5/ro/LC_MESSAGES** al directorului
5454
**Doc**. Acesta conține fișierele PO căutate.
5555

5656
Putem genera codul HTML al documentației folosind scriptul
@@ -62,6 +62,23 @@ scriptul PowerShell, executăm comenzile::
6262
Set-ExecutionPolicy Unrestricted
6363
./compilarea_traducerii
6464

65+
Abateri de la recomandările oficiale privind traducerea
66+
-------------------------------------------------------
67+
Am optat, în versiunea de față a traducerii, pentru *versiuni românești*
68+
ale majorității numelor de variabile, de funcții, de clase, de argumente
69+
care intervin în exemplele de cod.
70+
Aceasta constituie o abatere de la
71+
`recomandarea oficială <https://devguide.python.org/documentation/translations/translating/#code-examples>`_.
72+
Ea este justificată, în opinia mea, de ușurința cu care anumite idiomuri
73+
ale sintaxei Python-ului pot fi sesizate de către un nou-venit atunci când
74+
acesta se lansează în cititul unor fragmente aleatoare de cod.
75+
76+
Compilarea tutorialului
77+
-----------------------
78+
Tutorialul de Python, în românește, poate fi citit
79+
`aici <https://www.octawian.ro/fisiere/tutoriale/python/build/tutorial/>`_.
80+
El trebuie considerat *șantier* (fuzzy) de către
81+
eventualii săi cititori.
6582

6683
Acord asupra contribuției aduse la documentație
6784
-----------------------------------------------

0 commit comments

Comments
 (0)