python · raulcd · May 6, 2020 · May 5, 2020 · May 5, 2020 · May 6, 2020
diff --git a/.gitignore b/.gitignore
@@ -1,3 +1,4 @@
+cpython/locale
 *.mo
 /_build/
 
@@ -48,3 +49,5 @@ coverage.xml
 # Ides
 .vscode/
 .idea/
+
+.pospell
diff --git a/.overrides/CONTRIBUTING.rst b/.overrides/CONTRIBUTING.rst
@@ -1,3 +1,5 @@
+:orphan:
+
 Guía para contribuir en la traducción
 =====================================
 

diff --git a/.overrides/translation-memory.rst b/.overrides/translation-memory.rst
@@ -1,3 +1,5 @@
+:orphan:
+
 =======================
  Memoria de traducción
 =======================

diff --git a/.overrides/upgrade-python-version.rst b/.overrides/upgrade-python-version.rst
@@ -1,3 +1,5 @@
+:orphan:
+
 =======================================
  How to update to a new Python version
 =======================================

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
@@ -9,4 +9,10 @@ repos:
     rev: pre-commit
     hooks:
     -   id: pospell
-        args: ['--personal-dict', 'dict', '--modified', '--language', 'es_ES']
+        args: ['--personal-dict', 'dict', '--modified', '--language', 'es_ES', '--language', 'es_AR']
+
+-   repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v2.5.0
+    hooks:
+    -   id: file-contents-sorter
+        files: dict
diff --git a/.readthedocs.yml b/.readthedocs.yml
@@ -9,9 +9,12 @@ version: 2
 sphinx:
   configuration: conf.py
 
+build:
+  image: latest
+
 # Optionally set the version of Python and requirements required to build your docs
 python:
-  version: 3.7
+  version: 3.8
   install:
     - requirements: requirements.txt
 

diff --git a/.travis.yml b/.travis.yml
@@ -1,14 +1,17 @@
 language: python
-dist: xenial
-python: 3.7
+dist: bionic
+python: 3.8
 before_install:
   - sudo apt-get update
   - sudo apt-get install -y hunspell hunspell-es
 install:
-  - pip install pospell "powrap>=0.3.0"
+  - make setup
   - pospell --version
   - powrap --version
 script:
   - powrap --check --quiet **/*.po
-  - pospell -p dict -l es_ES **/*.po
+  - pospell -p dict -l es_AR -l es_ES **/*.po
   - make build
+branches:
+  only:
+  - /3\.\d/
diff --git a/Makefile b/Makefile
@@ -8,33 +8,29 @@
 # Configuration
 
 CPYTHON_PATH        := cpython   #Current commit for this upstream repo is setted by the submodule
-BRANCH              := 3.7
+BRANCH              := 3.8
 LANGUAGE_TEAM       := python-docs-es
 LANGUAGE            := es
 
 # Internal variables
 VENV                := $(shell realpath ./venv)
 PYTHON              := $(shell which python3)
-WORKDIRS            := $(VENV)/workdirs
-CPYTHON_WORKDIR     := $(WORKDIRS)/cpython
-LOCALE_DIR          := $(WORKDIRS)/locale
-JOBS                := auto
-SPHINXERRORHANDLING := "-W"
-TRANSIFEX_PROJECT   := python-newest
+CPYTHON_WORKDIR     := cpython
+OUTPUT_DOCTREE      := $(CPYTHON_WORKDIR)/Doc/_build/doctree
+OUTPUT_HTML      := $(CPYTHON_WORKDIR)/Doc/_build/html
+LOCALE_DIR          := $(CPYTHON_WORKDIR)/locale
+TRANSIFEX_PROJECT   := python-docs-es
 POSPELL_TMP_DIR     := .pospell
 
 
 .PHONY: help
 help:
 	@echo "Please use 'make <target>' where <target> is one of:"
 	@echo " build        Build an local version in html, with warnings as errors"
-	@echo " push         Update translations and Transifex config in the repository"
-	@echo " pull         Download translations from Transifex; calls 'venv'"
-	@echo " tx-config    Recreate an up-to-date project .tx/config; calls 'pot'"
-	@echo " pot          Create/Update POT files from source files"
 	@echo " serve        Serve a built documentation on http://localhost:8000"
-	@echo " spell        Check spelling, storing output in $(POSPELL_TMP_DIR)"
-	@echo " progress     To compute current progression on the tutorial" 
+	@echo " spell        Check spelling"
+	@echo " wrap         Wrap all the PO files to a fixed column width"
+	@echo " progress     To compute current progression on the tutorial"
 	@echo ""
 
 
@@ -44,86 +40,9 @@ help:
 #        treated as errors, which is good to skip simple Sphinx syntax mistakes.
 .PHONY: build
 build: setup
-	$(MAKE) -C $(CPYTHON_WORKDIR)/Doc/              \
-		VENVDIR=$(CPYTHON_WORKDIR)/Doc/venv         \
-		PYTHON=$(PYTHON)                            \
-		SPHINXERRORHANDLING=$(SPHINXERRORHANDLING)  \
-		SPHINXOPTS='-q --keep-going -j$(JOBS)       \
-			-D locale_dirs=$(LOCALE_DIR)            \
-			-D language=$(LANGUAGE)                 \
-			-D gettext_compact=0                    \
-			-D latex_engine=xelatex                 \
-			-D latex_elements.inputenc=             \
-			-D latex_elements.fontenc='             \
-		html;
-
-		@echo "Success! Open file://$(CPYTHON_WORKDIR)/Doc/build/html/index.html, " \
-		      "or run 'make serve' to see them in http://localhost:8000";
-
-
-# push: push new translation files and Transifex config files to repository,
-#       if any. Do nothing if there is no file changes. If GITHUB_TOKEN is set,
-#       then assumes we are in GitHub Actions, requiring different push args
-.PHONY: push
-push:
-	if ! git status -s | egrep '\.po|\.tx/config'; then                     \
-		echo "Nothing to commit";                                           \
-		exit 0;                                                             \
-	else                                                                    \
-		git add *.po **/*.po .tx/config;                                    \
-		git commit -m 'Update translations from Transifex';                 \
-		if [ $(GITHUB_TOKEN) != "" ]; then                                  \
-			header="$(echo -n token:"$(GITHUB_TOKEN)" | base64)";           \
-			git -c http.extraheader="AUTHORIZATION: basic $(header)" push;  \
-		else                                                                \
-			git push;                                                       \
-		fi;                                                                 \
-	fi
-
-
-# pull: Download translations files from Transifex, and apply line wrapping.
-#       For downloading new translation files, first run "tx-config" target
-#       to update the translation file mapping.
-.PHONY: pull
-pull: venv
-	$(VENV)/bin/tx pull --force --language=$(LANGUAGE) --parallel
-	$(VENV)/bin/powrap --quiet *.po **/*.po
-
-
-# tx-config: After running "pot", create a new Transifex config file by
-#            reading pot files generated, then tweak this config file to
-#            LANGUAGE.
-.PHONY: tx-config
-tx-config: pot
-	cd $(CPYTHON_WORKDIR)/Doc/locales;                  \
-	rm -rf .tx;                                         \
-	$(VENV)/bin/sphinx-intl create-txconfig;            \
-	$(VENV)/bin/sphinx-intl update-txconfig-resources   \
-	    --transifex-project-name=$(TRANSIFEX_PROJECT)   \
-	    --locale-dir .                                  \
-	    --pot-dir pot;
-
-	cd $(OLDPWD)
-	mv $(CPYTHON_WORKDIR)/Doc/locales/.tx/config .tx/config
-
-	sed -i .tx/config                                 \
-	    -e '/^source_file/d'                          \
-	    -e 's|<lang>/LC_MESSAGES/||'                  \
-	    -e "s|^file_filter|trans.$(LANGUAGE)|"
-
-
-# pot: After running "setup" target, run a cpython Makefile's target
-#      to generate .pot files under $(CPYTHON_WORKDIR)/Doc/locales/pot
-.PHONY: pot
-pot: setup
-	$(MAKE) -C $(CPYTHON_WORKDIR)/Doc/          \
-		VENVDIR=$(CPYTHON_WORKDIR)/Doc/venv     \
-		PYTHON=$(PYTHON)                        \
-		ALLSPHINXOPTS='-E -b gettext            \
-			-D gettext_compact=0                \
-			-d build/.doctrees .                \
-			locales/pot'                        \
-		build
+		sphinx-build -j auto -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
@@ -132,39 +51,19 @@ pot: setup
 #        the translation files copy which could have new/updated files.
 .PHONY: setup
 setup: venv
-	# Setup the main clone
 	git submodule sync
 	git submodule update --init --force $(CPYTHON_PATH)
-	# Setup the current work directory
-	if ! [ -d $(CPYTHON_WORKDIR) ]; then                                    \
-		rm -fr $(WORKDIRS);                                                 \
-		mkdir -p $(WORKDIRS);                                               \
-		git clone $(CPYTHON_PATH) $(CPYTHON_WORKDIR);                       \
-		$(MAKE) -C $(CPYTHON_WORKDIR)/Doc                                   \
-			VENVDIR=$(CPYTHON_WORKDIR)/Doc/venv                             \
-			PYTHON=$(PYTHON) venv;                                          \
-	fi
-
-	# Setup translation files
-	if ! [ -d $(LOCALE_DIR)/$(LANGUAGE)/LC_MESSAGES/ ]; then                \
-		mkdir -p $(LOCALE_DIR)/$(LANGUAGE)/LC_MESSAGES/;                    \
-	fi;                                                                     \
-	cp --parents *.po **/*.po $(LOCALE_DIR)/$(LANGUAGE)/LC_MESSAGES/        \
 
 
 # venv: create a virtual environment which will be used by almost every
 #       other target of this script
 .PHONY: venv
 venv:
-	if [ ! -d $(VENV) ]; then                                            \
+	if [ ! -d $(VENV) ]; then                                          \
 		$(PYTHON) -m venv --prompt $(LANGUAGE_TEAM) $(VENV);             \
 	fi
-
-	$(VENV)/bin/python -m pip install -q -r requirements.txt 2> $(VENV)/pip-install.log
-
-	if grep -q 'pip install --upgrade pip' $(VENV)/pip-install.log; then \
-		$(VENV)/bin/pip install -q --upgrade pip;                        \
-	fi
+
+	$(VENV)/bin/python -m pip install -q -r requirements.txt
 
 
 # serve: serve the documentation in a simple local web server, using cpython
@@ -174,28 +73,6 @@ serve:
 	$(MAKE) -C $(CPYTHON_WORKDIR)/Doc serve
 
 
-# list files for spellchecking
-SRCS := $(wildcard *.po **/*.po)
-DESTS = $(addprefix $(POSPELL_TMP_DIR)/out/,$(patsubst %.po,%.txt,$(SRCS)))
-
-
-# spell: run spell checking tool in all po files listed in SRCS variable,
-#        storing the output in text files DESTS for proofreading.  The
-#        DESTS target run the spellchecking, while the typos.txt target
-#        gather all reported issues in one file, sorted without redundancy
-.PHONY: spell
-spell: venv $(DESTS) $(POSPELL_TMP_DIR)/typos.txt
-
-$(POSPELL_TMP_DIR)/out/%.txt: %.po dict
-	@echo "Checking $< ..."
-	@mkdir -p $(@D)
-	@$(VENV)/bin/pospell -l $(LANGUAGE) -p dict $< > $@ || true
-
-$(POSPELL_TMP_DIR)/typos.txt:
-	@echo "Gathering all typos in $(POSPELL_TMP_DIR)/typos.txt ..."
-	@cut -d: -f3- $(DESTS) | sort -u > $@
-
-
 # clean: remove all .mo files and the venv directory that may exist and
 #        could have been created by the actions in other targets of this script
 .PHONY: clean
@@ -207,3 +84,13 @@ clean:
 .PHONY: progress
 progress: venv
 	$(VENV)/bin/potodo --offline --path tutorial/
+
+
+.PHONY: spell
+spell: venv
+	$(VENV)/bin/pospell -p dict -l es_ES **/*.po
+
+
+.PHONY: wrap
+wrap: venv
+	$(VENV)/bin/powrap **/*.po
diff --git a/c-api/abstract.po b/c-api/abstract.po
@@ -12,7 +12,8 @@ msgstr ""
 "POT-Creation-Date: 2019-05-06 11:59-0400\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
-"Language-Team: python-doc-es (https://mail.python.org/mailman3/lists/docs-es.python.org)\n"
+"Language-Team: python-doc-es (https://mail.python.org/mailman3/lists/docs-es."
+"python.org)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"

diff --git a/c-api/allocation.po b/c-api/allocation.po
@@ -12,7 +12,8 @@ msgstr ""
 "POT-Creation-Date: 2019-05-06 11:59-0400\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
-"Language-Team: python-doc-es (https://mail.python.org/mailman3/lists/docs-es.python.org)\n"
+"Language-Team: python-doc-es (https://mail.python.org/mailman3/lists/docs-es."
+"python.org)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"

diff --git a/c-api/apiabiversion.po b/c-api/apiabiversion.po
@@ -12,7 +12,8 @@ msgstr ""
 "POT-Creation-Date: 2019-05-06 11:59-0400\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
-"Language-Team: python-doc-es (https://mail.python.org/mailman3/lists/docs-es.python.org)\n"
+"Language-Team: python-doc-es (https://mail.python.org/mailman3/lists/docs-es."
+"python.org)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"

diff --git a/c-api/bool.po b/c-api/bool.po
@@ -12,7 +12,8 @@ msgstr ""
 "POT-Creation-Date: 2019-05-06 11:59-0400\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
-"Language-Team: python-doc-es (https://mail.python.org/mailman3/lists/docs-es.python.org)\n"
+"Language-Team: python-doc-es (https://mail.python.org/mailman3/lists/docs-es."
+"python.org)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"

diff --git a/c-api/descriptor.po b/c-api/descriptor.po
@@ -12,7 +12,8 @@ msgstr ""
 "POT-Creation-Date: 2019-05-06 11:59-0400\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
-"Language-Team: python-doc-es (https://mail.python.org/mailman3/lists/docs-es.python.org)\n"
+"Language-Team: python-doc-es (https://mail.python.org/mailman3/lists/docs-es."
+"python.org)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"

diff --git a/c-api/index.po b/c-api/index.po
@@ -12,7 +12,8 @@ msgstr ""
 "POT-Creation-Date: 2019-05-06 11:59-0400\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
-"Language-Team: python-doc-es (https://mail.python.org/mailman3/lists/docs-es.python.org)\n"
+"Language-Team: python-doc-es (https://mail.python.org/mailman3/lists/docs-es."
+"python.org)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"

diff --git a/c-api/iterator.po b/c-api/iterator.po
@@ -12,7 +12,8 @@ msgstr ""
 "POT-Creation-Date: 2019-05-06 11:59-0400\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
-"Language-Team: python-doc-es (https://mail.python.org/mailman3/lists/docs-es.python.org)\n"
+"Language-Team: python-doc-es (https://mail.python.org/mailman3/lists/docs-es."
+"python.org)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"

diff --git a/c-api/none.po b/c-api/none.po
@@ -12,7 +12,8 @@ msgstr ""
 "POT-Creation-Date: 2019-05-06 11:59-0400\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
-"Language-Team: python-doc-es (https://mail.python.org/mailman3/lists/docs-es.python.org)\n"
+"Language-Team: python-doc-es (https://mail.python.org/mailman3/lists/docs-es."
+"python.org)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"

diff --git a/c-api/objbuffer.po b/c-api/objbuffer.po
@@ -12,7 +12,8 @@ msgstr ""
 "POT-Creation-Date: 2019-05-06 11:59-0400\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
-"Language-Team: python-doc-es (https://mail.python.org/mailman3/lists/docs-es.python.org)\n"
+"Language-Team: python-doc-es (https://mail.python.org/mailman3/lists/docs-es."
+"python.org)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"

diff --git a/c-api/objimpl.po b/c-api/objimpl.po
@@ -12,7 +12,8 @@ msgstr ""
 "POT-Creation-Date: 2019-05-06 11:59-0400\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
-"Language-Team: python-doc-es (https://mail.python.org/mailman3/lists/docs-es.python.org)\n"
+"Language-Team: python-doc-es (https://mail.python.org/mailman3/lists/docs-es."
+"python.org)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"