# Uso rápido — PetroGlyphScout

PetroGlyphScout es una OnePage/OneFile ligera: puedes abrir `Public/index.html` directamente en un navegador usando el esquema `file://` o bien servirlo por HTTP; no es obligatorio ejecutar un servidor web para uso local.

Abrir la app

- Opción A — Abrir directamente (file://):
  - En muchos navegadores basta con abrir el archivo `Public/index.html` desde el gestor de archivos o con `Archivo → Abrir`.
  - Ejemplo de ruta local: `file:///ruta/al/proyecto/PetroGlyphScout/Public/index.html`.

- Opción B — Servir por HTTP (opcional):
  - Si prefieres servir por HTTP (útil para pruebas de CORS en entornos específicos), desde la raíz del repo puedes usar un servidor estático pequeño:

```bash
# desde la raíz del proyecto (opcional)
python3 -m http.server 8000
# abrir http://localhost:8000/PetroGlyphScout/Public/
```

Cómo funciona
- La UI carga `Public/json/PetroGlyphScout.glyphs.json` (dataset). En la mayoría de navegadores modernos la carga local funciona sin problemas cuando abres el HTML con `file://`.
- Al hacer clic en un glifo se copia el carácter al portapapeles; la búsqueda filtra por emoji o palabra clave.

Problemas raros y soluciones
- Algunos navegadores o configuraciones pueden restringir la lectura de ficheros locales mediante fetch cuando se abre la página con `file://`. Si encuentras ese comportamiento en tu navegador, las soluciones son:
  - Abrir el HTML por HTTP usando el comando anterior.
  - Usar un navegador/instalación que permita acceso a ficheros locales (o lanzar el navegador con la bandera que permita acceso local, sólo para pruebas).

Archivos relevantes
- `Public/index.html` — Interfaz principal.
- `Public/json/PetroGlyphScout.glyphs.json` — dataset principal de glifos.
- `Public/json/PetroGlyphScout.flags.json` — dataset de banderas.
- `Public/images/` — SVGs auxiliares.

Consejos
- Si planeas modificar masivamente el dataset, valida el JSON con `python3 -m json.tool` antes de subir cambios.