Merge branch '3.12' into traduccion-compound_stmts.po

Author: cacrespo

.github/workflows/main.yml

@@ -52,7 +52,7 @@ jobs:
       - name: Obtiene la lista de archivos .po con cambios (sólo en PRs)
         if: github.event_name == 'pull_request'
         id: changed-po-files
-        uses: tj-actions/changed-files@v40
+        uses: tj-actions/changed-files@v45
         with:
           files: |
              **/*.po
@@ -77,7 +77,7 @@ jobs:
           diff -Naur TRANSLATORS <(LANG=es python scripts/sort.py < TRANSLATORS)
       - name: Powrap
         if: steps.po-files-to-check.outputs.any_po_files_to_check == 'true'
-        run: powrap --check --quiet ${{ steps.po-files-to-check.outputs.po_files_to_check }}
+        run: powrap --diff --check --quiet ${{ steps.po-files-to-check.outputs.po_files_to_check }}
       - name: Sphinx lint
         if: steps.po-files-to-check.outputs.any_po_files_to_check == 'true'
         run: sphinx-lint ${{ steps.po-files-to-check.outputs.po_files_to_check }}
@@ -88,13 +88,5 @@ jobs:
       # Construcción de la documentación
       - name: Construir documentación
         run: |
-          # FIXME: Relative paths for includes in 'cpython'
-          sed -i -e 's|.. include:: ../includes/wasm-notavail.rst|.. include:: ../../../../includes/wasm-notavail.rst|g' cpython/Doc/**/*.rst
-          sed -i -e 's|.. include:: ../distutils/_setuptools_disclaimer.rst|.. include:: ../../../../distutils/_setuptools_disclaimer.rst|g' cpython/Doc/**/*.rst
-          sed -i -e 's|.. include:: ./_setuptools_disclaimer.rst|.. include:: ../../../_setuptools_disclaimer.rst|g' cpython/Doc/**/*.rst
-          sed -i -e 's|.. include:: token-list.inc|.. include:: ../../../token-list.inc|g' cpython/Doc/**/*.rst
-          sed -i -e 's|.. include:: ../../using/venv-create.inc|.. include:: ../using/venv-create.inc|g' cpython/Doc/**/*.rst
-          sed -i -e 's|.. include:: ../../../using/venv-create.inc|.. include:: ../../using/venv-create.inc|g' cpython/Doc/**/*.rst
-          sed -i -e 's|.. include:: /using/venv-create.inc|.. include:: ../../../../using/venv-create.inc|g' cpython/Doc/**/*.rst
           # Normal build
           PYTHONWARNINGS=ignore::FutureWarning,ignore::RuntimeWarning sphinx-build -j auto -W --keep-going -b html -d cpython/Doc/_build/doctree -D language=es . cpython/Doc/_build/html

.github/workflows/pr-comment.yml

@@ -37,7 +37,7 @@ jobs:
           python -m pip install -r base-branch/requirements.txt
       - name: Obtiene lista de archivos con cambios
         id: changed-files
-        uses: tj-actions/changed-files@v40
+        uses: tj-actions/changed-files@v45
         with:
           files: |
             **/*.po
@@ -62,7 +62,7 @@ jobs:
       pull-requests: write
     steps:
       - name: Agregar comentario con entradas faltantes
-        uses: thollander/actions-comment-pull-request@v2
+        uses: thollander/actions-comment-pull-request@v3
         with:
           message: ${{ needs.define-comment.outputs.comment }}
-          comment_tag: missing-entries
+          comment-tag: missing-entries

.overrides/faq.rst

@@ -204,9 +204,9 @@ repositorio principal de la traducción). Se hace de la siguiente manera::
 
 Luego nos vamos a nuestra rama local, confirmamos e impactamos esos cambios::
 
-    git checkout 3.11
-    git merge upstream/3.11
-    git push origin 3.11
+    git checkout 3.12
+    git merge upstream/3.12
+    git push origin 3.12
 
 ¡Eso es todo!
 

.overrides/progress.rst

@@ -10,7 +10,7 @@ y otras estadísticas.
 
 .. note::
 
-   Estas listas se actualiza automáticamente cuando Pull Requests se *mergean* a la rama ``3.11``.
+   Estas listas se actualiza automáticamente cuando Pull Requests se *mergean* a la rama ``3.12``.
 
 
 En progreso

.overrides/translation-memory.rst

@@ -123,6 +123,10 @@ Dividimos esta sección en dos partes, los términos que se traducen y los que m
    docstring
      docstring. ``library/idle.po``
 
+   floor division
+     división entera a la baja
+     En este `issue`_ más información al respecto.
+
    key
      clave
 
@@ -318,3 +322,6 @@ Estas son las reglas de estilo que hemos convenido hasta el momento:
   extranjerismos.
 
   Referencia: https://www.fundeu.es/recomendacion/locuciones-latinas-latinismos-errores-frecuentes-621/
+
+
+.. _issue: https://github.com/python/python-docs-es/issues/2754

.overrides/upgrade-python-version.rst

@@ -39,6 +39,12 @@ We are currently in branch 3.11, and we want to update the strings from 3.12.
    .. note:: This is important, so the later ``make build`` step will not reset
              the cpython submodule to the previous hash on the old branch.
 
+#. Create a virtual environment and install the dependencies of the project::
+
+     python -m venv env
+     source env/bin/activate  # Windows: env\Scripts\activate.bat
+     pip install -r requirements.txt
+     
 #. Verify that the docs build with the new versions you changed from
    ``requirements.txt`` mainly the sphinx version::
 
@@ -53,21 +59,14 @@ We are currently in branch 3.11, and we want to update the strings from 3.12.
 
 #. Clean possible garbage (form previous builds)::
 
-     rm -rf _build ../python-docs-es-pot cpython/Doc/CONTRIBUTING.rst cpython/Doc/upgrade-python-version.rst
+     rm -rf _build ../python-docs-es-pot cpython/Doc/CONTRIBUTING.rst cpython/Doc/upgrade-python-version.rst reviewers-guide.rst
 
    .. note::
 
       The 'python-docs-es-pot' is a temporary directory that is created
       in the next step. It's included here because it might be a leftover
       from previous attempts on your machine.
 
-#. Create a virtual environment and install the dependencies of the project::
-
-     python -m venv env
-     source env/bin/activate  # Windows: env\Scripts\activate.bat
-     pip install -r requirements.txt
-
-
 #. Create the .po files from the new source code. This will generate all the .po files for version 3.11::
 
      SPHINX_GETTEXT=True sphinx-build -j auto -b gettext -d _build/doctrees . ../python-docs-es-pot
@@ -114,9 +113,16 @@ We are currently in branch 3.11, and we want to update the strings from 3.12.
    of the new branch is done. So prepare a cup of any hot beverage
    and fix them.
 
-Once the process is completely and you are happy with the results,
-there are a few extra steps to finish the process::
+**Once the process is completely and you are happy with the results,
+there are a few extra steps to finish the process**
+
+#. Upgrade GitHub Actions to use Python 3.12, by updating Python version to 3.12 in the ``.github/workflows/main.yml`` file.
 
-#. Upgrade GitHub Actions to use Python 3.12
+#. Update the *Read the Docs* project to use 3.12 in the build and also as default branch/version.
+	
+#. Commit all the newly created files locally.
+	
+#. Create branch 3.12 in the repository in order to merge changes there.
+	
+#. Inside the github project settings, set 3.12 branch as the default branch for the repository.
 
-#. Update Read the Docs project to use 3.12 in the build and also as default branch/version

.pre-commit-config.yaml

@@ -1,6 +1,6 @@
 repos:
--   repo: https://github.com/JulienPalard/powrap
-    rev: v0.4.0
+-   repo: https://git.afpy.org/AFPy/powrap
+    rev: v1.0.2
     hooks:
     -   id: powrap
 -   repo: local

Makefile

@@ -20,6 +20,7 @@ OUTPUT_DOCTREE      := $(CPYTHON_WORKDIR)/Doc/build/doctree
 OUTPUT_HTML         := $(CPYTHON_WORKDIR)/Doc/build/html
 LOCALE_DIR          := $(CPYTHON_WORKDIR)/locale
 POSPELL_TMP_DIR     := .pospell
+SPHINX_JOBS         := auto
 
 
 .PHONY: help
@@ -38,22 +39,15 @@ help:
 #        before this. If passing SPHINXERRORHANDLING='', warnings will not be
 #        treated as errors, which is good to skip simple Sphinx syntax mistakes.
 .PHONY: build
-build: setup
-	# FIXME: Relative paths for includes in 'cpython'
-	# See more about this at https://github.com/python/python-docs-es/issues/1844
-	sed -i -e 's|.. include:: ../includes/wasm-notavail.rst|.. include:: ../../../../includes/wasm-notavail.rst|g' cpython/Doc/**/*.rst
-	sed -i -e 's|.. include:: ../distutils/_setuptools_disclaimer.rst|.. include:: ../../../../distutils/_setuptools_disclaimer.rst|g' cpython/Doc/**/*.rst
-	sed -i -e 's|.. include:: ./_setuptools_disclaimer.rst|.. include:: ../../../_setuptools_disclaimer.rst|g' cpython/Doc/**/*.rst
-	sed -i -e 's|.. include:: token-list.inc|.. include:: ../../../token-list.inc|g' cpython/Doc/**/*.rst
-	sed -i -e 's|.. include:: ../../using/venv-create.inc|.. include:: ../using/venv-create.inc|g' cpython/Doc/**/*.rst
-	sed -i -e 's|.. include:: ../../../using/venv-create.inc|.. include:: ../../using/venv-create.inc|g' cpython/Doc/**/*.rst
-	sed -i -e 's|.. include:: /using/venv-create.inc|.. include:: ../../../../using/venv-create.inc|g' cpython/Doc/**/*.rst
+build: setup do_build
+
+.PHONY: do_build
+do_build:
 	# Normal build
-	PYTHONWARNINGS=ignore::FutureWarning,ignore::RuntimeWarning $(VENV)/bin/sphinx-build -j auto -W --keep-going -b html -d $(OUTPUT_DOCTREE) -D language=$(LANGUAGE) . $(OUTPUT_HTML) && \
+	PYTHONWARNINGS=ignore::FutureWarning,ignore::RuntimeWarning $(VENV)/bin/sphinx-build -j $(SPHINX_JOBS) -W --keep-going -b html -d $(OUTPUT_DOCTREE) -D language=$(LANGUAGE) . $(OUTPUT_HTML) && \
 		echo "Success! Open file://`pwd`/$(OUTPUT_HTML)/index.html, " \
 			"or run 'make serve' to see them in http://localhost:8000";
 
-
 # setup: After running "venv" target, prepare that virtual environment with
 #        a local clone of cpython repository and the translation files.
 #        If the directories exists, only update the cpython repository and

README.md

@@ -1,6 +1,6 @@
 # Traducción al Español de la Documentación de Python
-![Build Status](https://github.com/python/python-docs-es/actions/workflows/main.yml/badge.svg?branch=3.11 "Build Status")
-![Documentation Status](https://readthedocs.org/projects/python-docs-es/badge/?version=3.11 "Documentation Status")
+![Build Status](https://github.com/python/python-docs-es/actions/workflows/main.yml/badge.svg?branch=3.12 "Build Status")
+![Documentation Status](https://readthedocs.org/projects/python-docs-es/badge/?version=3.12 "Documentation Status")
 ## ¿Cómo contribuir?
 
 Tenemos una guía que te ayudará a contribuir. Por favor

TRANSLATORS

@@ -43,6 +43,7 @@ Carlos Bernad (@carlos-bernad)
 Carlos Enrique Carrasco Varas (@KrlitosForever)
 Carlos Joel Delgado Pizarro (@c0x6a)
 Carlos Martel Lamas (@Letram)
+Carlos Mena Pérez (@carlosm00)
 Catalina Arrey Amunátegui (@CatalinaArrey)
 Claudia Millán Nebot (@clacri @cheshireminima)
 Constanza Areal (@geekcoty)
@@ -124,8 +125,8 @@ José Carlos Álvarez González (@jcaalzago)
 José Daniel Gonzalez (@jdgc14)
 Jose Ignacio Riaño Chico
 José Luis Cantilo (@jcantilo)
-José Luis Salgado Banda (@josephLSalgado)
 José Miguel Hernández Cabrera (@miguelheca)
+Joseph Salgado (@xooseph)
 Juan Alegría (@zejiran)
 Juan Antonio Lagos (@alochimpasplum)
 Juan Biondi (@yeyeto2788)
@@ -158,6 +159,7 @@ Lis
 Lucas Miranda
 Luciano Bovio (@lbovio)
 Luis A. Gonzalez (@sublian)
+Luis Enriquez Torres (@lenriquezt)
 Luis Llave (@llaveluis)
 Luis Sánchez (@LuisAISanchez)
 Maia
@@ -178,6 +180,7 @@ María José Molina Contreras (@mjmolina)
 María Saiz Muñoz (@mariasm87)
 Martín Gaitán (@mgaitan)
 Martín Ramírez (@tinchoram)
+Mateo Cámara (@MateoCamara)
 Matias Bordese (@matiasb)
 Melissa Escobar Gutiérrez (@MelissaEscobar)
 Miguel Ángel
@@ -216,6 +219,7 @@ Samantha Valdez A. (@samvaldez)
 Santiago E Fraire Willemoes (@Woile)
 Santiago Piccinini (@spiccinini)
 Screpnik Claudia Raquel
+Sebastian Melo (@CarpioWeen1)
 Sergio Delgado Quintero (@sdelquin)
 Sergio Infante (@neosergio)
 Silvina Tamburini (@silvinabt87)
@@ -226,7 +230,7 @@ Sumit Kashyap
 Summerok
 Tatiana Delgadillo (@Tai543)
 Tony-Rome
-Ulises Alexander Argüelles Monjaraz (@UlisesAlexanderAM)
+Ulises Alexander Arguelles Monjaraz (@UlisesAlexanderAM)
 Victor Carlos (@tuxtitlan)
 Víctor Yelicich
 Victoria Perez Mola (@victoriapm)
@@ -238,4 +242,5 @@ Xavi Francisco (@srxavi)
 Xavi Rambla Centellas (@xavirambla)
 Yennifer Paola Herrera Ariza (@Yenniferh)
 Yohanna Padrino (@Yo-hanaPR)
-zejiran
+zejiran
+Zodac (@zodacdev)