Descargar el manual
El manual se lee en el navegador, pero también se descarga entero. El paquete no es un respaldo: es el mismo material, ordenado para trabajar sin conexión.
Qué te llevas
Sección titulada «Qué te llevas»manual-python.zip — 3,5 MB, 567 archivos.
dist— 327 archivos. El sitio ya construido: 139 páginas, las fuentes, el buscador. Se abre con doble clic endist/index.html.ejercicios— 183 archivos. Los 91 ejercicios ejecutables en.py, con sus 90 salidas de referencia y el índice.mediciones— 34 archivos. Los 33 scripts que producen cada número publicado, mássalida-3.13.md.ingenieria— 9 archivos. Los cuatro ejemplos de las disciplinas, con la hoja de ruta de cada una.herramientas— 10 archivos. Los verificadores: ejecutan ejercicios, ejemplos y mediciones y avisan si una cifra no coincide.- En la raíz — 4 archivos.
README.md,LICENSE.md,requirements.txtyVERSION.txtcon la fecha del paquete.
Cómo se usa
Sección titulada «Cómo se usa»Para leer, no hace falta nada:
# descomprime y abre dist/index.html, o sirve la carpeta:python -m http.server 4322 --directory distPara ejecutar los ejercicios, Python 3.11 o superior y nada más:
python ejercicios/12-hidrologia/05-caso-completo.pySolo la Parte V (NumPy y SciPy) y la estadística de hidrología necesitan dependencias:
pip install -r requirements.txtPara comprobar que todo da lo publicado, desde la carpeta descomprimida:
python herramientas/verificar-ejercicios.py # cada ejercicio contra su salida de referenciapython herramientas/verificar-ingenieria.py # los cuatro ejemplos, cifra a cifrapython herramientas/verificar-mediciones.py # los 33 scripts de mediciónPor qué el ZIP y no solo la web
Sección titulada «Por qué el ZIP y no solo la web»- Sin conexión: el sitio construido funciona en local, con su buscador y sus estilos.
- Reproducible: cada cifra que publica un capítulo tiene aquí el script que la produce.
- Verificable: los 90 ejercicios deterministas traen su salida de referencia; si un número no coincide, el verificador lo dice.
- Sin dependencias para leer: no hay que compilar ni instalar Node.
Si cambia algo
Sección titulada «Si cambia algo»El paquete se regenera desde el repositorio:
npm run buildpython herramientas/empaquetar.py # escribe public/descargas/manual-python.zipnpm run build # el ZIP entra en dist/El script imprime el tamaño, el número de archivos y el SHA-256 del paquete, para que puedas comprobar que la descarga llegó entera.
Licencia
Sección titulada «Licencia»El texto y los diagramas van con CC BY 4.0; el código, con MIT. El logo y el nombre Mammoth Systems no están cubiertos por ninguna de las dos. El detalle está en LICENSE.md, dentro del paquete.