37 lines
2.0 KiB
Markdown
37 lines
2.0 KiB
Markdown
# 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.
|