:date: 2026-06-24 :modified: 2026-06-24 :author: Carlos Félix Pardo Martín :license: Creative Commons Attribution-ShareAlike 4.0 International :license_url: https://creativecommons.org/licenses/by-sa/4.0/ 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``