Hacer la generación de la Documentación compatible con Windows #66
Comments
@raulcd esto creo que puediera ayudar AFPy/powrap#82, parece que el error esta en una dependencia de Aqui adjunto la imagen de la configuracion en Poedit. Saludos. P.D: Honestamente no he probado la parte de |
@raulcd Yo estoy trabajando de la siguiente forma sobre plataformas Windows, ¿Crees que le podría servir a alguien más?
Requisitos:
> cat Dockerfile
# Download docker image, It download a ubunto distro with Python 3.8
FROM python:3.8
# Install os dependences
RUN apt-get update && apt-get -y install \
gettext hunspell hunspell-es
# Download requirements
RUN curl -O https://raw.githubusercontent.com/python/python-docs-es/3.8/requirements.txt
# Install python packages
RUN pip3 install -r requirements.txt
# Setup Volume and work directory
VOLUME /user/home/python-docs-es
WORKDIR /user/home/python-docs-es
Procedimiento
> docker build --tag python-docs-es .
> docker images # Verify the image was builded
python-docs-es latest c4345e08cb800 48 seconds ago 1.03GB
> docker run -it -v C:\\Users\\your.user\\python-docs-es:/user/home/python-docs-es python-docs-es bash
> powrap library/sqlite3.po # Fix file
Fixing wrapping of po files: 100%|██████████████████████████████████████████████████████████████| 1/1 Y listo, el volumen de la máquina linux está sincronizado con la carpeta de Windows. Nota: este mismo contenedor se podría usar para más cosas que solamente corregir los archivos .po, pero por ahora solo lo he usado para eso. |
No me parece tan adecuado recomendar utilizar Docker, ya que si la gente tiene problema con instalar hunspell para Windows, va a ser un nivel de complejidad mucho más alto. Los pasos oficiales son bastante claros y sin software externo: https://docs.microsoft.com/en-us/windows/wsl/install-win10 Adicionalmente,los pasos para que funcione
Luego, pospell instalado en un entorno virtual va a poder usar |
Vale, deacuerdo, para instalar Docker sobre Windows hay que hacer varias cosas, tener las actualizaciones al día, habilitar virtualización en la BIOS, etc. Si extraoficialmente alguien ya paso por eso y quiere jugar con Docker para ahorrarse unos pasos, acá dejo la imagen publicada: docker run -it -v C:\\your.path\\python-docs-es:/user/home/python-docs-es gedarafi/python-docs-es bash
# Fix po file
powrap library/sqlite3.po Nota: experimetal, hacerlo solo si se siente con suerte :D |
Me hubiera gustado mucho la verdad, tener un contenedor listo para usar...pero participé en un workshop una vez, donde se fue más de la mitad en que todos tuvieran Docker instalado :( y luego con el tema de "pero en Windows...", "pero en macOS..." :'( |
En Telegram ha aparecido varias veces la pregunta de como hacer la generación de la documentación local en Windows. Deberíamos documentar cómo conseguirlo y añadirlo al Contribution guide.
The text was updated successfully, but these errors were encountered: