Add files via upload

Author: octaG-M

README.rst

@@ -0,0 +1,112 @@
+O traducere în românește a documentației limbajului Python
+==========================================================
+
+Traducerea se realizează pe fragmente de text numite **mesaje**.
+Aceste mesaje se găsesc/introduc în fișiere
+`PO <https://www.gnu.org/software/gettext/manual/html_node/PO-Files.html>`_.
+
+Fișierele PO pot fi generate, dacă lucrăm sub sistemul de 
+operare Microsoft **Windows 11**, într-un cont de **administrator**, 
+astfel:
+
+- instalăm cea mai recentă versiune **stabilă** de 
+  `Python <https://www.python.org/>`_;
+- instalăm generatorul de documentație 
+  `Sphinx <https://www.sphinx-doc.org/en/master/usage/installation.html>`_::
+
+     pip install -U sphinx
+
+- instalăm unealta
+  `sphinx-intl <https://www.sphinx-doc.org/en/master/usage/advanced/intl.html>`_::
+
+     pip install sphinx-intl
+
+- descărcăm într-un director convenabil codul-sursă al celei mai recente
+  versiuni **stabile** de Python (aceeași ca mai sus); de exemplu, 
+  `3.13.5 <https://www.python.org/downloads/source/>`_;
+- în subdirectorul **Doc** al codului-sursă Python se găsește fișierul
+  **conf.py**, la sfârșitul căruia adăugăm::
+
+     # Optiuni pentru traducerea in romaneste
+     # Adaugat in [ 17.06.2025 ]
+     # Conform [ https://www.sphinx-doc.org/en/master/usage/advanced/intl.html ]
+     # -------------------------------------------------------------------------
+
+     locale_dirs = ['locale_python_3_13_5/']   # path is example but recommended.
+     gettext_compact = False                   # optional.
+     language = 'ro'
+
+- din subdirectorul **Doc**, deschidem un 
+  `terminal Windows <https://learn.microsoft.com/en-us/windows/terminal/>`_
+  și executăm comanda::
+
+     ./make gettext
+
+  Ea va genera subdirectorul **build/gettext** al directorului **Doc**, 
+  care conține fișiere
+  `POT <https://www.drupal.org/community/contributor-guide/reference-information/localize-drupal-org/working-with-offline/po-and-pot-files>`_.
+
+- în același terminal, comanda::
+
+     sphinx-intl update -p build/gettext -l ro
+
+  va produce subdirectorul **locale_python_3_13_5/ro/LC_MESSAGES** al directorului
+  **Doc**. Acesta conține fișierele PO căutate.
+
+Putem genera codul HTML al documentației folosind scriptul 
+**scripturi/compilarea_traducerii.ps1** din acest proiect. Astfel,
+într-un terminal Windows cu **drepturi de administrator**
+(tastele Win + X, A), deschis din directorul unde se găsește
+scriptul PowerShell, executăm comenzile::
+
+    Set-ExecutionPolicy Unrestricted
+    ./compilarea_traducerii
+
+Abateri de la recomandările oficiale privind traducerea
+-------------------------------------------------------
+Am optat, în versiunea de față a traducerii, pentru *variante românești*
+ale majorității numelor de variabile, de funcții, de clase, de argumente
+care intervin în exemplele de cod.
+Aceasta constituie o abatere de la 
+`recomandarea oficială <https://devguide.python.org/documentation/translations/translating/#code-examples>`_.
+Ea este justificată, în opinia mea, de ușurința cu care anumite idiomuri
+ale sintaxei Python-ului pot fi sesizate de către un nou-venit atunci când 
+acesta se lansează în cititul unor fragmente aleatoare de cod.
+
+Pentru a compila *abaterile*, am operat mici modificări în fișierele
+**.rst** corespunzătoare.
+
+Compilarea tutorialului
+-----------------------
+Tutorialul de Python, în românește, poate fi citit
+`aici <https://www.octawian.ro/fisiere/tutoriale/python/build/tutorial/>`_. 
+El trebuie considerat *șantier* (fuzzy) de către 
+eventualii săi cititori.
+
+Acord asupra contribuției aduse la documentație
+-----------------------------------------------
+
+NOTĂ PRIVIND LICENȚA TRADUCERILOR: documentația Python
+este întreținută de o rețea globală de voluntari. Prin
+publicarea acestui proiect pe Transifex, GitHub sau în
+alt loc public și prin invitația adresată dumneavoastră
+de a participa la el vă propunem un acord în baza căruia
+dumneavoastră vă veți oferi îmbunătățirile aduse 
+documentației Python sau traducerii acesteia spre 
+folosință de către PSF sub licența CC0 (disponibilă la 
+adresa
+https://creativecommons.org/publicdomain/zero/1.0/legalcode).
+În schimb, veți putea pretinde recunoaștere asupra 
+porțiunii din traducere la care ați contribuit și, dacă
+traducerea dumneavoastră este acceptată de către PSF, veți
+putea (fără a fi obligat la aceasta) să transmiteți o
+corecție cuprinzând adnotarea potrivită a fișierului
+Misc/ACKS sau TRANSLATORS. Deși nimic din acest acord
+asupra contribuției aduse la documentație nu obligă
+PSF să încorporeze textul contribuției dumneavoastră,
+participarea dumneavoastră la comunitatea Python este
+binevenită și apreciată.
+
+Consfințiți acceptarea acestui acord prin transmiterea
+muncii dumneavoastră către PSF pentru a fi inclusă în
+documentație.