├── .gitignore ├── TRANSLATORS ├── README.md └── .github └── workflows ├── lint-and-build.yml └── transifex-pull.yml /.gitignore: -------------------------------------------------------------------------------- 1 | *.mo 2 | -------------------------------------------------------------------------------- /TRANSLATORS: -------------------------------------------------------------------------------- 1 | Horváth Árpád 2 | Nyírő Balázs 3 | Bajusz Tamás 4 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | Hungarian Translation of the Python Documentation 2 | ================================================= 3 | 4 | > [!IMPORTANT] 5 | > This translation is in need of a coordinator, if you are interested in doing 6 | > so please open an issue in this repository. 7 | 8 | Contributing to the Translation 9 | ------------------------------- 10 | 11 | Your help is welcome; you can start with easy tasks like reviewing 12 | fuzzy entries to help keep the documentation up to date. You can 13 | also proofread already translated entries and finally translate 14 | untranslated ones. 15 | 16 | How to Contribute 17 | ----------------- 18 | 19 | Contribution is carried out on 20 | [Transifex](https://explore.transifex.com/python-doc/python-newest/). 21 | The [Python Devguide](https://devguide.python.org/documentation/translations/translating/) 22 | contains all the necessary information to get started. If you have issues with 23 | getting set up, open an issue in this repository and someone will help you. 24 | 25 | Documentation Contribution Agreement 26 | ------------------------------------ 27 | 28 | NOTE REGARDING THE LICENSE FOR TRANSLATIONS: Python's documentation is 29 | maintained using a global network of volunteers. By posting this 30 | project on Transifex, GitHub, and other public places, and inviting 31 | you to participate, we are proposing an agreement that you will 32 | provide your improvements to Python's documentation or the translation 33 | of Python's documentation for the PSF's use under the CC0 license 34 | (available at https://creativecommons.org/publicdomain/zero/1.0/legalcode). In 35 | return, you may publicly claim credit for the portion of the 36 | translation you contributed and if your translation is accepted by the 37 | PSF, you may (but are not required to) submit a patch including an 38 | appropriate annotation in the Misc/ACKS or TRANSLATORS file. Although 39 | nothing in this Documentation Contribution Agreement obligates the PSF 40 | to incorporate your textual contribution, your participation in the 41 | Python community is welcomed and appreciated. 42 | 43 | You signify acceptance of this agreement by submitting your work to 44 | the PSF for inclusion in the documentation. -------------------------------------------------------------------------------- /.github/workflows/lint-and-build.yml: -------------------------------------------------------------------------------- 1 | name: Linting and test building workflow 2 | 3 | on: 4 | schedule: 5 | - cron: '0 0 * * *' 6 | push: 7 | branches: 8 | - '*' 9 | workflow_dispatch: 10 | 11 | jobs: 12 | lint: 13 | runs-on: ubuntu-latest 14 | strategy: 15 | fail-fast: false 16 | matrix: 17 | version: [ '3.14' ] 18 | continue-on-error: true 19 | steps: 20 | - uses: actions/setup-python@master 21 | with: 22 | python-version: 3 23 | - run: pip install sphinx-lint 24 | - uses: actions/checkout@master 25 | with: 26 | ref: ${{ matrix.version }} 27 | - uses: rffontenelle/sphinx-lint-problem-matcher@v1.0.0 28 | - run: sphinx-lint 29 | 30 | build-translation: 31 | runs-on: ubuntu-latest 32 | strategy: 33 | fail-fast: false 34 | matrix: 35 | version: [ '3.14' ] 36 | format: [ html, latex ] 37 | steps: 38 | - uses: actions/setup-python@master 39 | with: 40 | python-version: 3 41 | - uses: actions/checkout@master 42 | with: 43 | repository: python/cpython 44 | ref: ${{ matrix.version }} 45 | - run: make venv 46 | working-directory: ./Doc 47 | - uses: actions/checkout@master 48 | with: 49 | ref: ${{ matrix.version }} 50 | path: Doc/locales/hu/LC_MESSAGES 51 | - run: git pull 52 | working-directory: ./Doc/locales/hu/LC_MESSAGES 53 | - uses: sphinx-doc/github-problem-matcher@v1.1 54 | - run: make -e SPHINXOPTS="--color -D language='hu' -W --keep-going" ${{ matrix.format }} 55 | working-directory: ./Doc 56 | - uses: actions/upload-artifact@master 57 | if: success() || failure() 58 | with: 59 | name: build-${{ matrix.version }}-${{ matrix.format }} 60 | path: Doc/build/${{ matrix.format }} 61 | 62 | output-pdf: 63 | runs-on: ubuntu-latest 64 | strategy: 65 | matrix: 66 | version: [ '3.14' ] 67 | needs: [ 'build-translation' ] 68 | steps: 69 | - uses: actions/download-artifact@master 70 | with: 71 | name: build-${{ matrix.version }}-latex 72 | - run: sudo apt-get update 73 | - run: sudo apt-get install -y latexmk texlive-xetex fonts-freefont-otf xindy 74 | - run: make 75 | - uses: actions/upload-artifact@master 76 | with: 77 | name: build-${{ matrix.version }}-pdf 78 | path: . -------------------------------------------------------------------------------- /.github/workflows/transifex-pull.yml: -------------------------------------------------------------------------------- 1 | name: Pull Translations from Transifex 2 | on: 3 | schedule: 4 | - cron: '0 * * * *' 5 | workflow_dispatch: 6 | permissions: 7 | contents: write 8 | 9 | jobs: 10 | update-translation: 11 | runs-on: ubuntu-latest 12 | strategy: 13 | fail-fast: false 14 | matrix: 15 | version: [ '3.14' ] 16 | 17 | steps: 18 | - uses: styfle/cancel-workflow-action@main 19 | with: 20 | access_token: ${{ secrets.GITHUB_TOKEN }} 21 | 22 | - uses: actions/setup-python@master 23 | with: 24 | python-version: 3 25 | 26 | - name: Install Dependencies 27 | run: | 28 | sudo apt-get install -y gettext 29 | pip install requests cogapp polib transifex-python sphinx-intl blurb six 30 | curl -o- https://raw.githubusercontent.com/transifex/cli/master/install.sh | bash 31 | curl -O https://raw.githubusercontent.com/python-docs-translations/transifex-automations/master/sample-workflows/transifex-util.py 32 | chmod +x transifex-util.py 33 | working-directory: /usr/local/bin 34 | 35 | - uses: actions/checkout@master 36 | with: 37 | ref: ${{ matrix.version }} 38 | fetch-depth: 0 39 | 40 | - run: transifex-util.py recreate_tx_config --language hu --project-slug python-newest --version ${{ matrix.version }} 41 | env: 42 | TX_TOKEN: ${{ secrets.TX_TOKEN }} 43 | 44 | - run: transifex-util.py fetch --language hu --project-slug python-newest --version ${{ matrix.version }} 45 | env: 46 | TX_TOKEN: ${{ secrets.TX_TOKEN }} 47 | 48 | - run: transifex-util.py delete_obsolete_files --language hu --project-slug python-newest --version ${{ matrix.version }} 49 | 50 | - name: Set up Git 51 | run: | 52 | git config --local user.email github-actions@github.com 53 | git config --local user.name "GitHub Action's update-translation job" 54 | 55 | - name: Filter files 56 | run: | 57 | ! git diff -I'^"POT-Creation-Date: ' \ 58 | -I'^"Language-Team: ' \ 59 | -I'^# ' -I'^"Last-Translator: ' \ 60 | --exit-code \ 61 | && echo "SIGNIFICANT_CHANGES=1" >> $GITHUB_ENV || exit 0 62 | 63 | - run: git add . 64 | 65 | - run: git commit -m 'Update translation from Transifex' 66 | if: env.SIGNIFICANT_CHANGES 67 | 68 | - uses: ad-m/github-push-action@master 69 | if: env.SIGNIFICANT_CHANGES 70 | with: 71 | branch: ${{ matrix.version }} 72 | github_token: ${{ secrets.GITHUB_TOKEN }} --------------------------------------------------------------------------------