Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Actualizar la documentación para indicar que el clon debe ser recursivo #3353

Open
wants to merge 8 commits into
base: 3.13
Choose a base branch
from
15 changes: 14 additions & 1 deletion .overrides/CONTRIBUTING.rst
Original file line number Diff line number Diff line change
Expand Up @@ -60,14 +60,27 @@ podrás realizar todas las contribuciones que quieras.

#. (Opcional) Instala los requerimientos del proyecto::

pip install -r requirements.txt
pip install -r requirements-own.txt

.. note::

Al tener instalado los requerimientos, podrás utilizas las herramientas
``powrap`` y ``pospell`` para poder verificar tus archivos traducidos,
y también construir la documentación localmente.

.. note::

Si vas a querer construir la documentación de una manera local, debes inicializar
los submódulos para poder hacer la construcción. (nota: esta inicialización puede llevar tiempo)
```
git submodule update --init
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Este paso no es necesario, porque make build va a llamar a setup y do_build.
Dentro de setup tienes:

setup: venv
    git submodule sync
    git submodule update --init --force --depth 1 $(CPYTHON_PATH)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

hmm en un nuevo clon no puedo construir la documentación:

(venv) ➜  temp git:(3.13) make build 
if [ ! -d /home/krbiggers/temp/venv ]; then                                          \
        /home/krbiggers/temp/venv/bin/python3 -m venv --prompt python-docs-es /home/krbiggers/temp/venv;             \
fi
/home/krbiggers/temp/venv/bin/python -m pip install -q -r requirements.txt
ERROR: Could not open requirements file: [Errno 2] No such file or directory: 'cpython/Doc/requirements.txt'
make: *** [Makefile:66: venv] Error 1
(venv) ➜  temp git:(3.13)  

Creo que es pq dentro de la configuración de venv intentamos pip install el archivo requirements.txt antes de actualizar el submodule de cpython.

Tal vez debemos actualizar el paso venv para solo intentar instalar las dependencias de requirements-own.txt ?

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tal vez debemos actualizar el paso venv para solo intentar instalar las dependencias de requirements-own.txt ?

Tiene sentido, sí. Y después actualizar además el paso build para que instale requirements.txt, y así se instalen las dependencias para realizar el build.

Ojo también que tus cambios aún están basados sobre tu branch con cambios de lexical_analysis.po, cuando debieran estar basados en la rama 3.13.

pip install -r requirements.txt
```
y después para hacer la construcción
```
make build
```

.. _que-archivo-traducir:

Paso 1: ¿Qué archivo traducir?
Expand Down
22 changes: 21 additions & 1 deletion dictionaries/reference_lexical_analysis.txt
Original file line number Diff line number Diff line change
@@ -1,2 +1,22 @@
Moolenaar
tokeniza
tokeniza
Januari
Februari
Maart
April
Mei
Juni
Juli
Augustus
September
Oktober
November
December
month
year
day
mill
his
said
hour
second
Loading