PetroGlyphScout/MD/Usage.md

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:

# 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.