5. Herramientas del proyecto

Esta es la lista de herramientas que se necesita para compilar la página web y obtener los archivos html.

No es necesario instalar todas estas herramientas para aportar contenidos, pero si es recomendable para que puedas compilar el proyecto en tu propio ordenador y comprobar que todo lo escrito funciona correctamente antes de enviarlo al repositorio principal, ahorrando trabajo a los administradores.

Herramientas en Linux

A continuación aparece la lista de herramientas necesarias para la distribución Debian y sus distribuciones derivadas (Ubuntu, MAX, etc).

  • Python: lenguaje de programación que utiliza el proyecto.

    sudo apt install python3

  • Sphinx: generador de documentación que compila los ficheros fuente para convertirlos en html estático, epub o pdf.

    sudo apt install python3-sphinx

  • Furo: es el tema de Sphinx. Sirve para definir el estilo de la página web (tipos de letra, tamaños, separaciones entre elementos, etc.)

    apt install python3-furo

  • TeX Live: paquete del lenguaje LaTeX para generación de fórmulas con Sphinx.

    sudo apt install texlive-full

  • Git: gestor de versiones. Es la herramienta de control de revisiones de Linux y la que trabaja por debajo del servicio GitHub.

    sudo apt install git –y

  • ImageMagick: paquete de manejo de imágenes por línea de comandos. No es necesario para compilar la web, solo para modificar las imágenes del proyecto a mano cuando sea necesario.

    sudo apt install imagemagick

Herramientas en Windows

  • Python: lenguaje de programación que utiliza el proyecto.

    https://www.python.org/ftp/python/3.14.6/python-3.14.6-amd64.exe

    Instalar para todos los usuarios en el directorio c:/Archivos de programa/Python314

  • Entorno virtual de Python: Es el entorno local de herramientas de Python.

    A continuación ejecutamos las siguientes instrucciones desde la consola de comandos (ejecutando _bash.bat en el directorio del repositorio tecnoproyectos) para borrar el directorio venv actual y crear uno nuevo:

    rmdir /s /q venv

set PATH="c:/Archivos de programa/Python314/";%PATH%

python.exe -m venv venv

  • Sphinx: generador de documentación que compila los ficheros fuente para convertirlos en html estático, epub o pdf.

    Abrimos la linea de comandos ejecutando _bash.bat y escribimos:

    python.exe -m pip install sphinx

  • Furo: es el tema de Sphinx. Sirve para definir el estilo de la página web (tipos de letra, tamaños, separaciones entre elementos, etc.)

    Abrimos la linea de comandos ejecutando _bash.bat y escribimos:

    python.exe -m pip install furo

  • MikTeX: paquete del lenguaje LaTeX para generación de fórmulas con Sphinx.

    Descarga el archivo de instalación para Windows: miktex.org/download

    Renombra el archivo de instalación a miktex-portable.exe

    Instala MikTeX en el directorio c:/bin/miktex

Compilando el proyecto

Para compilar el proyecto y obtener los archivos html estáticos que forman la página web es necesario ir al directorio del proyecto abrir la linea de comandos (ejecutando _bash.bat en Windows) y escribir:

make html