RAVE-SCOUT/docs/Instalacion.md
hacklab f890dd9448 Multi-país, idiomas, seguridad, instaladores y documentación
Seguridad
- Escapado de todo lo que viene de datos de terceros antes de ir al HTML,
  incluidos los tooltips de Leaflet. Los nombres de municipio salen de
  OpenStreetMap, que cualquiera puede editar: sin escapar, era una vía de
  inyección de código en el navegador de quien abriera el visor.

Multi-país
- El país pasa a ser un parámetro (REGION). Catálogo de 27 regiones entre
  Europa y el norte de África, declarando por país qué datos existen de verdad.
- Una malla por país y no una continental: Europa entera a 100 m son mil
  millones de celdas y unos 73 GB solo en capas ráster.
- Proyección equiárea propia para las regiones de fuera de Europa, donde
  EPSG:3035 deforma.

Interfaz
- Idiomas: castellano, inglés, francés y portugués, con selector persistente.
- Modo Mapa: el país entero sobre satélite, topográfico u OSM.
- Enlaces a mapas externos en la barra inferior, siempre visibles.
- Botón de ver de cerca también en la cabecera de la ficha.
- Fuera la distancia desde Madrid, que centralizaba algo de uso general.

Portabilidad
- install.sh e install.ps1 para Linux/macOS y Windows; requirements.txt.
- Sin rutas absolutas en el código.

Documentación
- Ocho páginas en docs/ para la wiki: instalación, uso, añadir un país,
  metodología, seguridad, fuentes y publicación.
2026-08-08 22:24:17 +02:00

60 lines
1.7 KiB
Markdown

# Instalación
## Para solo mirar los resultados: nada
El visor es un HTML. Clona el repositorio y ábrelo:
| Sistema | Orden |
|---|---|
| Linux | `xdg-open out/visor.html` o `./abrir.sh` |
| Windows | doble clic en `out\visor.html`, o `.\abrir.ps1` |
| macOS | `open out/visor.html` |
| Android / iPhone | ver [Publicar](Publicar) |
No hace falta servidor, ni Python, ni conexión.
**Ojo:** `visor.html` necesita la carpeta `out/ortho/` a su lado, que es donde
están las fotos aéreas. Si mueves el HTML solo, se quedan sin cargar.
### Si al abrirlo se abre un editor de texto
Le pasa a quien tiene los `.html` asociados a un editor, algo habitual si
programas. `xdg-open` respeta esa asociación, no el navegador por defecto.
Usa `./abrir.sh`, que llama al navegador directamente, o arrástralo a una
ventana del navegador.
## Para reconstruir los datos
Hacen falta Python 3.9+, unos 25 GB de disco por país y un par de horas.
### Linux / macOS
```bash
./install.sh
```
Si falta el módulo `venv`: `sudo apt install python3-venv` en Debian/Ubuntu.
### Windows
```powershell
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\install.ps1
```
Si no tienes Python: `winget install Python.Python.3.12`, marcando
*Add Python to PATH*.
### Qué instala
Solo paquetes de Python, dentro de `.venv/`, sin tocar el sistema:
`numpy`, `scipy`, `rasterio`, `osmium`, `shapely`, `pyproj`, `requests`,
`pillow`. Todos traen binarios precompilados para Linux, Windows y macOS, así
que **no hace falta compilar GDAL ni nada parecido**.
## Comprobar que funciona
```bash
./.venv/bin/python src/regions.py # lista los países disponibles
./.venv/bin/python src/revisar.py # comprueba la coherencia del resultado
```