https://github.com/python/python-docs-ro

O traducere în românește a documentației Python.
https://github.com/python/python-docs-ro

Last synced: 5 months ago
JSON representation

O traducere în românește a documentației Python.

• Host: GitHub
• URL: https://github.com/python/python-docs-ro
• Owner: python
• License: other
• Created: 2025-03-04T12:45:13.000Z (8 months ago)
• Default Branch: main
• Last Pushed: 2025-06-07T09:14:21.000Z (5 months ago)
• Last Synced: 2025-06-12T15:19:39.442Z (5 months ago)
• Language: PowerShell
• Size: 4.46 MB
• Stars: 1
• Watchers: 1
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.rst
  • License: license.po

Awesome Lists containing this project

README

          
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 `_.

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 `_;

- instalăm generatorul de documentație 

  `Sphinx `_::

     pip install -U sphinx

- instalăm unealta

  `sphinx-intl `_::

     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.3 `_;

- î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 [ 09.05.2025 ]

     # Conform [ https://www.sphinx-doc.org/en/master/usage/advanced/intl.html ]

     # -------------------------------------------------------------------------

     locale_dirs = ['locale_python_3_13_3/']   # path is example but recommended.

     gettext_compact = False                   # optional.

     language = 'ro'

- din subdirectorul **Doc**, deschidem un 

  `terminal Windows `_

  și executăm comanda::

     ./make gettext

  Ea va genera subdirectorul **build/gettext** al directorului **Doc**, 

  care conține fișiere

  `POT `_.

- în același terminal, comanda::

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

  va produce subdirectorul **locale_python_3_13_3/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

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.