May 6, 2020 · May 5, 2020 · May 5, 2020 · May 6, 2020 · May 6, 2020 · May 6, 2020
diff --git a/.gitignore b/.gitignore
 cpython/locale
 *.mo
 /_build/

 # Ides
 .vscode/
 .idea/

 .pospell
diff --git a/.overrides/CONTRIBUTING.rst b/.overrides/CONTRIBUTING.rst
 :orphan:

 Guía para contribuir en la traducción
 =====================================

diff --git a/.overrides/translation-memory.rst b/.overrides/translation-memory.rst
 :orphan:

 =======================
 Memoria de traducción
 =======================
diff --git a/.overrides/upgrade-python-version.rst b/.overrides/upgrade-python-version.rst
 :orphan:

 =======================================
 How to update to a new Python version
 =======================================
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
    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
 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
 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 -les_AR -les_ES **/*.po
  - make build
 branches:
  only:
  - /3\.\d/
diff --git a/Makefile b/Makefile
 # 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 ""


 #        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
 #        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
 $(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
 .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
 "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
 "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
 "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
 "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
 "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
 "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
 "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
 "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
 "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
 "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"
Original file line number	Diff line number	Diff line change
		@@ -1,3 +1,4 @@
		cpython/locale
		*.mo
		/_build/

Expand DownExpand Up		@@ -48,3 +49,5 @@ coverage.xml
		# Ides
		.vscode/
		.idea/

		.pospell
Original file line number	Diff line number	Diff line change
		@@ -1,3 +1,5 @@
		:orphan:

		Guía para contribuir en la traducción
		=====================================

Expand Down
Original file line number	Diff line number	Diff line change
		@@ -1,3 +1,5 @@
		:orphan:

		=======================
		Memoria de traducción
		=======================
Expand Down
Original file line number	Diff line number	Diff line change
		@@ -1,3 +1,5 @@
		:orphan:

		=======================================
		How to update to a new Python version
		=======================================
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -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
Original file line number	Diff line number	Diff line change
Expand Up		@@ -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

Expand Down
Original file line number	Diff line number	Diff line change
		@@ -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 -les_AR -les_ES */.po
		- make build
		branches:
		only:
		- /3\.\d/
Original file line number	Diff line number	Diff line change
Expand Up		@@ -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 ""


Expand All		@@ -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
Expand All		@@ -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
Expand All		@@ -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
Expand All		@@ -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
Original file line number	Diff line number	Diff line change
Expand Up		@@ -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"
Expand Down