Skip to content

Commit 573f489

Browse files
authored
Update and rename README.md to README.rst
1 parent 01fb927 commit 573f489

2 files changed

Lines changed: 68 additions & 2 deletions

File tree

README.md

Lines changed: 0 additions & 2 deletions
This file was deleted.

README.rst

Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
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

Comments
 (0)