|
| 1 | +O traducere în românește a documentației limbajului Python |
| 2 | +========================================================== |
| 3 | + |
| 4 | +Traducerea se realizează pe fragmente de text numite **mesaje**. |
| 5 | +Aceste mesaje se găsesc/introduc în fișiere |
| 6 | +`PO <https://www.gnu.org/software/gettext/manual/html_node/PO-Files.html>`_. |
| 7 | + |
| 8 | +Fișierele PO pot fi generate, dacă lucrăm sub sistemul de |
| 9 | +operare Microsoft **Windows 11**, într-un cont de **administrator**, |
| 10 | +astfel: |
| 11 | + |
| 12 | +- instalăm cea mai recentă versiune **stabilă** de |
| 13 | + `Python <https://www.python.org/>`_; |
| 14 | +- instalăm generatorul de documentație |
| 15 | + `Sphinx <https://www.sphinx-doc.org/en/master/usage/installation.html>`_; |
| 16 | +- instalăm unealta |
| 17 | + `sphinx-intl <https://www.sphinx-doc.org/en/master/usage/advanced/intl.html>`_; |
| 18 | +- descărcăm într-un director convenabil codul-sursă al celei mai recente |
| 19 | + versiuni **stabile** de Python (aceeași ca mai sus); de exemplu, |
| 20 | + `3.13.2 <https://www.python.org/downloads/source/>`_ ; |
| 21 | +- în subdirectorul **Doc** al codului-sursă Python se găsește fișierul |
| 22 | + **conf.py**, la sfârșitul căruia adăugăm |
| 23 | + |
| 24 | + :: |
| 25 | + |
| 26 | + # Optiuni pentru traducerea in romaneste |
| 27 | + # Adaugat in [ 03.03.2025 ] |
| 28 | + # Conform [ https://www.sphinx-doc.org/en/master/usage/advanced/intl.html ] |
| 29 | + # ------------------------------------------------------------------------- |
| 30 | + |
| 31 | + locale_dirs = ['locale/'] # path is example but recommended. |
| 32 | + gettext_compact = False # optional. |
| 33 | + language = 'ro' |
| 34 | + |
| 35 | +- din subdirectorul **Doc**, deschidem un |
| 36 | + `terminal Windows <https://learn.microsoft.com/en-us/windows/terminal/>`_ |
| 37 | + și executăm comanda |
| 38 | + |
| 39 | + :: |
| 40 | + |
| 41 | + ./make gettext |
| 42 | + |
| 43 | + Ea va genera subdirectorul **build/gettext**, care conține fișiere |
| 44 | + `POT <https://www.drupal.org/community/contributor-guide/reference-information/localize-drupal-org/working-with-offline/po-and-pot-files>`_. |
| 45 | + |
| 46 | +- în același terminal, comanda |
| 47 | + |
| 48 | + :: |
| 49 | + |
| 50 | + sphinx-intl update -p build/gettext -l ro |
| 51 | + |
| 52 | + va produce subdirectorul **locale/ro/LC_MESSAGES**. Acesta conține fișierele |
| 53 | + PO căutate. |
| 54 | + |
| 55 | +Putem genera codul HTML al documentației folosind scriptul |
| 56 | +**compilarea_documentatiei.ps1** din acest proiect. Astfel, |
| 57 | +într-un terminal Windows cu **drepturi de administrator** |
| 58 | +(tastele Win + X, A), deschis din directorul unde se găsește |
| 59 | +scriptul Python, executăm comenzile : |
| 60 | + |
| 61 | +:: |
| 62 | + |
| 63 | + Set-ExecutionPolicy Unrestricted |
| 64 | + ./compilarea_documentatiei |
| 65 | + Set-ExecutionPolicy Restricted |
| 66 | + |
| 67 | + |
| 68 | + |
0 commit comments