8000 Merge branch '3.12' into reference-datamodel · python/python-docs-el@a9b14f6 · GitHub
[go: up one dir, main page]

Skip to content

Commit a9b14f6

Browse files
committed
Merge branch '3.12' into reference-datamodel
2 parents 6ad8fbe + fc2cf2b commit a9b14f6
  • deprecations
  • dictionaries
  • distributing
  • extending
  • faq
  • howto
  • installing
  • library
  • reference
  • tutorial
  • using
  • whatsnew
  • Some content is hidden

    Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

    511 files changed

    +106247
    -28547
    lines changed

    .devcontainer/devcontainer.json

    Lines changed: 47 additions & 0 deletions
    Original file line numberDiff line numberDiff line change
    @@ -0,0 +1,47 @@
    1+
    {
    2+
    "name": "Python Translation Devcontainer",
    3+
    "image": "python:3.12-slim",
    4+
    "customizations": {
    5+
    "vscode": {
    6+
    "extensions": [
    7+
    "eamodio.gitlens",
    8+
    "github.vscode-pull-request-github",
    9+
    "github.vscode-github-actions",
    10+
    "redhat.vscode-yaml",
    11+
    "gettext.gettext",
    12+
    "restructuredtext.restructuredtext"
    13+
    ],
    14+
    "settings": {
    15+
    "[python]": {
    16+
    "editor.formatOnSave": true,
    17+
    "editor.codeActionsOnSave": {
    18+
    "source.organizeImports": "always"
    19+
    }
    20+
    },
    21+
    "python.defaultInterpreterPath": "/usr/local/bin/python3",
    22+
    "terminal.integrated.defaultProfile.linux": "zsh",
    23+
    "terminal.integrated.profiles.linux": {
    24+
    "zsh": {
    25+
    "path": "/bin/zsh"
    26+
    }
    27+
    },
    28+
    "terminal.integrated.env.linux": {
    29+
    "ZSH": "/bin/zsh"
    30+
    }
    31+
    }
    32+
    }
    33+
    },
    34+
    "features": {
    35+
    "ghcr.io/devcontainers/features/git:1": {
    36+
    "version": "latest"
    37+
    },
    38+
    "ghcr.io/devcontainers/features/common-utils:2": {}
    39+
    },
    40+
    "workspaceFolder": "/python-docs-gr",
    41+
    "workspaceMount": "source=${localWorkspaceFolder},target=/python-docs-gr,type=bind,consistency=cached",
    42+
    "postCreateCommand": "sudo apt-get update && sudo apt-get install -y hunspell hunspell-el && pip install -r ./requirements.txt",
    43+
    "mounts": [
    44+
    "source=pip-cache,target=/home/translator/.cache/pip,type=volume"
    45+
    ],
    46+
    "remoteUser": "translator"
    47+
    }

    .github/workflows/precommit.yaml

    Lines changed: 2 additions & 2 deletions
    Original file line numberDiff line numberDiff line change
    @@ -14,7 +14,7 @@ jobs:
    1414
    steps:
    1515
    - uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332 # v4.1.7
    1616
    with:
    17-
    submodules: "true"
    17+
    submodules: true
    1818
    fetch-depth: 2
    1919
    - name: Setup python
    2020
    uses: actions/setup-python@39cd14951b08e74b54015e9e001cdefcf80e669f # v5.1.1
    @@ -25,5 +25,5 @@ jobs:
    2525
    sudo apt-get update
    2626
    sudo apt-get install -y hunspell hunspell-el gettext language-pack-el locales-all
    2727
    - uses: pre-commit/action@2c7b3805fd2a0fd8c1884dcaebf91fc102a13ecd # v3.0.1
    28-
    - uses: pre-commit-ci/lite-action@9d882e7a565f7008d4faf128f27d1cb6503d4ebf # v1.0.2
    28+
    - uses: pre-commit-ci/lite-action@5d6cc0eb514c891a40562a58a8e71576c5c7fb43 # v1.1.0
    2929
    if: always()

    .pre-commit-config.yaml

    Lines changed: 3 additions & 3 deletions
    Original file line numberDiff line numberDiff line change
    @@ -1,6 +1,6 @@
    11
    repos:
    22
    - repo: https://github.com/pre-commit/pre-commit-hooks
    3-
    rev: 2c9f875913ee60ca25ce70243dc24d5b6415598c # v4.6.0
    3+
    rev: cef0300fd0fc4d2a87a85fa2093c6b283ea36f4b # v5.0.0
    44
    hooks:
    55
    - id: file-contents-sorter
    66
    files: "dictionaries/main.txt"
    @@ -10,7 +10,7 @@ repos:
    1010
    - id: end-of-file-fixer
    1111

    1212
    - repo: https://git.afpy.org/AFPy/powrap
    13-
    rev: df2a0a54804a6146cc9fbffb77464d4b5fe24f41 # v1.0.1
    13+
    rev: 416de333cc58dce4453d1257769d7c9abdde95f7 # v1.0.2
    1414
    hooks:
    1515
    - id: powrap
    1616

    @@ -23,6 +23,6 @@ repos:
    2323
    - "--personal-dict=dictionaries/main.txt"
    2424

    2525
    - repo: https://github.com/sphinx-contrib/sphinx-lint
    26-
    rev: ce6d7aeab24d60b6119dbad180540bf3c9ff31da # v0.9.1
    26+
    rev: ff671d6a030a3141634793e6d1e8909ab6091830 # v1.0.0
    2727
    hooks:
    2828
    - id: sphinx-lint

    CONTRIBUTING.md

    Lines changed: 93 additions & 81 deletions
    Large diffs are not rendered by default.

    Makefile

    Lines changed: 19 additions & 6 deletions
    Original file line numberDiff line numberDiff line change
    @@ -21,12 +21,11 @@
    2121
    # from which we generated our po files. We use it here so when we
    2222
    # test build, we're building with the .rst files that generated our
    2323
    # .po files.
    24-
    CPYTHON_CURRENT_COMMIT := 9cbde7c6ce6f7b93301a37f03dfa0c0d45e00a39
    24+
    CPYTHON_CURRENT_COMMIT := 0274115585db8e26d9d1c0218fe65e5041c70f2c
    2525

    2626
    CPYTHON_PATH := ./cpython
    2727

    2828
    LANGUAGE := el
    29-
    TRANSLATION_BRANCH := main
    3029
    BRANCH := 3.12
    3130

    3231
    EXCLUDED := whatsnew/ c-api/
    @@ -70,8 +69,10 @@ all: ensure_prerequisites
    7069
    -D latex_elements.inputenc= \
    7170
    -D latex_elements.fontenc=' \
    7271
    $(MODE)
    73-
    @echo "Build success, open file://$(abspath $(CPYTHON_PATH))/Doc/build/html/index.html or run 'make serve' to see them."
    74-
    72+
    @echo "Build successful! 🎉"
    73+
    @echo "You can now open the documentation in your browser:"
    74+
    @echo " file://$(abspath $(CPYTHON_PATH))/Doc/build/html/index.html"
    75+
    @echo "Or, run 'make serve' to start a local web server for the docs."
    7576

    7677
    .PHONY: ensure_prerequisites
    7778
    ensure_prerequisites:
    @@ -100,15 +101,27 @@ ensure_prerequisites:
    100101

    101102
    .PHONY: serve
    102103
    serve:
    103-
    $(PYTHON) -c "import os, webbrowser; webbrowser.open('file://' + os.path.realpath('cpython/Doc/build/html/index.html'))"
    104+
    @echo "Starting local server at http://localhost:8000..."
    105+
    $(PYTHON) -m http.server -d cpython/Doc/build/html/
    104106

    107+
    .PHONY: preview
    108+
    preview:
    109+
    make all && make serve
    105110

    106111
    .PHONY: progress
    107112
    progress:
    108113
    @$(PYTHON) -c 'import sys; print("{:.1%}".format(int(sys.argv[1]) / int(sys.argv[2])))' \
    109114
    $(shell msgcat *.po */*.po | msgattrib --translated | grep -c '^msgid') \
    110115
    $(shell msgcat *.po */*.po | grep -c '^msgid')
    111116

    117+
    .PHONY: spellcheck
    118+
    spellcheck:
    119+
    $(PYTHON) scripts/check_spelling.py $(filter-out $@, $(MAKECMDGOALS))
    120+
    121+
    .PHONY: lint
    122+
    lint:
    123+
    powrap *.po **/*.po && \
    124+
    make spellcheck
    112125

    113126
    .PHONY: todo
    114127
    todo: ensure_prerequisites
    @@ -119,7 +132,7 @@ wrap: ensure_prerequisites
    119132
    @echo "Verify wrapping"
    120133
    powrap --check --quiet *.po **/*.po
    121134

    122-
    SRCS = $(shell git diff --name-only $(TRANSLATION_BRANCH) | grep '.po$$')
    135+
    SRCS = $(shell git diff --name-only $(BRANCH) | grep '.po$$')
    123136
    # foo/bar.po => $(POSPELL_TMP_DIR)/foo/bar.po.out
    124137
    DESTS = $(addprefix $(POSPELL_TMP_DIR)/,$(addsuffix .out,$(SRCS)))
    125138

    README.md

    Lines changed: 4 additions & 4 deletions
    Original file line numberDiff line numberDiff line change
    @@ -3,7 +3,7 @@
    33
    # python-docs-gr
    44
    Η ελληνική μετάφραση των επίσημων εγγράφων της Python.
    55

    6-
    ## Συμφωνητικό Συνεισφοράς στην Μετάφραση των Εγγράφων
    6+
    ## Συμφωνητικό Συνεισφοράς στη Μετάφραση των Εγγράφων
    77

    88
    ΣΗΜΕΙΩΣΗ ΓΙΑ ΤΗΝ ΑΔΕΙΑ ΧΡΗΣΗΣ ΤΩΝ ΜΕΤΑΦΡΑΣΕΩΝ
    99

    @@ -25,9 +25,9 @@
    2525
    Υποβάλλοντας την εργασία σας στο PSF για να συμπεριληφθεί στον οδηγό χρήσης της Python,
    2626
    συμφωνείτε με αυτό το έγγραφο.
    2727

    28-
    Το πρωτότυπο κείμενο του παραπάνου συμφωνητικού στα Αγγλικά βρίσκεται στο
    28+
    Το πρωτότυπο κείμενο του παραπάνω συμφωνητικού στα Αγγλικά βρίσκεται στο
    2929
    [PEP545](https://peps.python.org/pep-0545/#setup-the-documentation-contribution-agreement).
    3030

    31-
    ## Πως μπορώ να βοηθήσω στην μετάφραση;
    31+
    ## Πως μπορώ να βοηθήσω στη μετάφραση;
    3232

    33-
    Το έργο της μετάφρασης είναι εθελοντικό και στηρίζεται στους φίλους και στα μέλη της κοινότητας της Python! Κάθε συνεισφορά στην μετάφραση είναι σημαντική! Για περισότερες πληροφορίες για το πως μπορείτε να συνεισφέρετε δείτε [εδώ](./CONTRIBUTING.md).
    33+
    Το έργο της μετάφρασης είναι εθελοντικό και στηρίζεται στους φίλους και στα μέλη της κοινότητας της Python! Κάθε συνεισφορά στη μετάφραση είναι σημαντική! Για περισσότερες πληροφορίες για το πως μπορείτε να συνεισφέρετε δείτε [εδώ](./CONTRIBUTING.md).

    TRANSLATORS

    Lines changed: 3 additions & 0 deletions
    Original file line numberDiff line numberDiff line change
    @@ -6,3 +6,6 @@ Dimitrios Papadopoulos
    66
    Marios Giannopoulos
    77
    Artemis Leonardou
    88
    Stelios Rotas
    9+
    Loukas Sakellaridis
    10+
    Αlexandros Tzioras
    11+
    Kleopatra Karapanagiotou

    about.po

    Lines changed: 23 additions & 21 deletions
    Original file line numberDiff line numberDiff line change
    @@ -8,28 +8,30 @@ msgid ""
    88
    msgstr ""
    99
    "Project-Id-Version: Python 3.12\n"
    1010
    "Report-Msgid-Bugs-To: \n"
    11-
    "POT-Creation-Date: 2024-03-14 12:51+0000\n"
    11+
    "POT-Creation-Date: 2025-02-17 21:03+0100\n"
    1212
    "PO-Revision-Date: 2024-03-31 19:50+0000\n"
    1313
    "Last-Translator: Theofanis Petkos <thepetk@gmail.com>\n"
    1414"Language-Team: PyGreece <pygreece@gmail.com>\n"
    15+
    "Language: \n"
    1516
    "MIME-Version: 1.0\n"
    1617
    "Content-Type: text/plain; charset=UTF-8\n"
    1718
    "Content-Transfer-Encoding: 8bit\n"
    1819

    1920
    #: about.rst:3
    20-
    msgid "About these documents"
    21-
    msgstr "Σχετικά με τα έγγραφα"
    21+
    msgid "About this documentation"
    22+
    msgstr "Σχετικά με την τεκμηρίωση"
    2223

    2324
    #: about.rst:6
    2425
    msgid ""
    25-
    "These documents are generated from `reStructuredText`_ sources by `Sphinx`_, "
    26-
    "a document processor specifically written for the Python documentation."
    26+
    "Python's documentation is generated from `reStructuredText`_ sources using "
    27+
    "`Sphinx`_, a documentation generator originally created for Python and now "
    28+
    "maintained as an independent project."
    2729
    msgstr ""
    28-
    "Αυτά τα έγραφα έχουν δημιουργηθεί από τα `reStructuredText`_ sources του "
    29-
    "`Sphinx`_, έναν επεξεργαστή εγγράφων που έχει δημιουργηθεί ειδικά για τα "
    30+
    "Η τεκμηρίωση της Python έχει δημιουργηθεί από τα `reStructuredText`_ sources "
    31+
    "του `Sphinx`_, έναν επεξεργαστή εγγράφων που έχει δημιουργηθεί ειδικά για τα "
    3032
    "έγγραφα της Python."
    3133

    32-
    #: about.rst:15
    34+
    #: about.rst:16
    3335
    msgid ""
    3436
    "Development of the documentation and its toolchain is an entirely volunteer "
    3537
    "effort, just like Python itself. If you want to contribute, please take a "
    @@ -41,39 +43,39 @@ msgstr ""
    4143
    "ρίξτε μια ματιά στη σελίδα :ref:`reporting-bugs` για πληροφορίες σχετικές με "
    4244
    "το πως να το κάνετε. Καινούριοι εθελοντές είναι πάντα ευπρόσδεκτοι!"
    4345

    44-
    #: about.rst:20
    46+
    #: about.rst:21
    4547
    msgid "Many thanks go to:"
    4648
    msgstr "Πολλές ευχαριστίες πηγαίνουν στους:"
    4749

    48-
    #: about.rst:22
    50+
    #: about.rst:23
    4951
    msgid ""
    5052
    "Fred L. Drake, Jr., the creator of the original Python documentation toolset "
    51-
    "and writer of much of the content;"
    53+
    "and author of much of the content;"
    5254
    msgstr ""
    53-
    "Fred L. Drake, Jr., τον δημιουργό των αρχικών εργαλείων των εγγράφων της "
    54-
    "Python και συντάκτη αρκετού περιεχομένου'"
    55+
    "Fred L. Drake, Jr., τον δημιουργό των αρχικών εργαλείων της τεκμηρίωσης της "
    56+
    "Python και συντάκτη αρκετού περιεχομένου·"
    5557

    56-
    #: about.rst:24
    58+
    #: about.rst:25
    5759
    msgid ""
    5860
    "the `Docutils <https://docutils.sourceforge.io/>`_ project for creating "
    5961
    "reStructuredText and the Docutils suite;"
    6062
    msgstr ""
    6163
    "το `Docutils <https://docutils.sourceforge.io/>`_ πρότζεκτ για την "
    62-
    "δημιουργία των εφαρμογών reStructuredText και Docutils'"
    64+
    "δημιουργία των εφαρμογών reStructuredText και Docutils·"
    6365

    64-
    #: about.rst:26
    66+
    #: about.rst:27
    6567
    msgid ""
    6668
    "Fredrik Lundh for his Alternative Python Reference project from which Sphinx "
    6769
    "got many good ideas."
    6870
    msgstr ""
    6971
    "Fredrik Lundh για το δικό του Alternative Python Reference πρότζεκτ από το "
    7072
    "οποίο το Sphinx πήρε πολύ καλές ιδέες."
    7173

    72-
    #: about.rst:31
    73-
    msgid "Contributors to the Python Documentation"
    74-
    msgstr "Συντελεστές στα έγγραφα της Python"
    74+
    #: about.rst:32
    75+
    msgid "Contributors to the Python documentation"
    76+
    msgstr "Συντελεστές στη τεκμηρίωση της Python"
    7577

    76-
    #: about.rst:33
    78+
    #: about.rst:34
    7779
    msgid ""
    7880
    "Many people have contributed to the Python language, the Python standard "
    7981
    "library, and the Python documentation. See :source:`Misc/ACKS` in the "
    @@ -83,7 +85,7 @@ msgstr ""
    8385
    "Python, και τα έγγραφα της Python. Δείτε :source:`Misc/ACKS` στις πηγές "
    8486
    "διανομής της Python για μια λίστα των συντελεστών."
    8587

    86-
    #: about.rst:37
    88+
    #: about.rst:38
    8789
    msgid ""
    8890
    "It is only with the input and contributions of the Python community that "
    8991
    "Python has such wonderful documentation -- Thank You!"

    0 commit comments

    Comments
     (0)
    0