🕮 Visor de TXT¶

Un visor web en HTML, CSS y JavaScript para explorar y leer archivos de texto plano (.txt) desde el navegador.\ Incluye un sidebar interactivo, agrupación alfabética, búsqueda integrada y un enlace directo a un editor externo (editor.php).

🚀 Características¶

✅ Visualiza archivos .txt en el navegador sin necesidad de recargar la página.
✅ Sidebar plegable con:
- Agrupación alfabética.
- Soporte para carpetas y subcarpetas.
- Botones de Expandir todo y Contraer todo.
✅ Buscador instantáneo por título.
✅ Apertura automática de un archivo por defecto (readme.txt).
✅ Compatible con móviles (interfaz responsive).
✅ Integración opcional con un editor externo (editor.php).
✅ Seguridad: uso de token para consultar el listado de archivos.

📂 Estructura de Archivos¶

index.html → interfaz principal del visor.
listar.php → script PHP que devuelve en formato JSON la lista de archivos .txt.
editor.php → (opcional) editor para crear o modificar archivos.
*.txt → archivos de texto que se desean visualizar.

⚙️ Requisitos¶

Servidor web con soporte PHP (Apache, Nginx, etc.).
Acceso a un directorio con archivos .txt.
Navegador moderno con soporte ES6.

🛠️ Instalación¶

Copiar los archivos en un directorio accesible desde tu servidor web:
```
/var/www/html/visor/
```
Asegurarse de que listar.php y editor.php estén en el mismo directorio que index.html.
Colocar dentro de esa carpeta los archivos .txt que quieras visualizar.

▶️ Uso¶

Abrir en el navegador:
```
http://localhost/visor/index.html
```

Usar el botón ☰ Menú para desplegar el sidebar.

3. Navegar por las carpetas y archivos:

-   Click en un **grupo alfabético** → expande/colapsa esa letra.
-   Click en una **carpeta** → expande/colapsa su contenido.
-   Click en un **archivo** → carga el contenido en el área
    principal.

Usar el buscador para filtrar títulos de archivos.
Hacer click en el enlace 🕮 Editor (arriba de la barra lateral) para abrir el editor en una nueva pestaña.

🔒 Seguridad¶

El visor solicita la lista de archivos a listar.php incluyendo un token de seguridad:

fetch('listar.php?token=visor_2024_secure_token')

Debe coincidir con la clave configurada en listar.php.
Si el token no coincide, no se devolverá la lista de archivos.
⚠️ el contenido de listar.php es inaccesible en el navegador

📌 Personalización¶

Archivo por defecto:\ Se define en la variable ARCHIVO_POR_DEFECTO del script:

js const ARCHIVO_POR_DEFECTO = 'readme.txt';

Cambiar el valor para seleccionar otro archivo inicial.
Estilo visual:\ Editar la sección <style> en index.html.
Integración con editor:\ Si no se desea mostrar el enlace al editor, basta con eliminar o comentar esta línea en el HTML:

html <a href="editor.php" ... >🕮 Editor</a>

📖 Ejemplo de uso¶

index.html abre el visor.\
El visor pide a listar.php la lista de archivos .txt.\
Los organiza alfabéticamente y en carpetas.\
Al hacer clic en un archivo, su contenido aparece en el panel derecho.

📄 Licencia¶

Este visor puede ser usado, modificado y distribuido libremente para proyectos personales o educativos.