Manual de Supervivencia: Página Web de Paulistas

1. Estrategia del Proyecto

El sitio actual es un Generador de Sitios Estáticos (SSG). El objetivo: carga inmediata, seguridad total y SEO optimizado para dominar los resultados de búsqueda de Google.

2. El Ecosistema Tecnológico

Jekyll

El Arquitecto

Toma archivos de texto y los convierte en la web final usando plantillas.

Node.js / npm

Los Obreros

Se encargan de comprimir (minificar) el CSS y JS para que la web "vuele".

3. Estructura de Carpetas

_includes/ - Bloques (Menú, Footer)

_layouts/ - Plantillas Maestras

_cajas/ - Datos de productos

assets/ - Imágenes, CSS y JS

⚠️ Alerta Crítica: .htaccess

Nunca toques el bloque # php -- BEGIN cPanel. Es el corazón de la conexión con el servidor. Si se altera, la página quedará inaccesible (Error 500).

4. Lógica de JavaScript (Interactividad)

El JS aquí funciona por "eventos". No es magia negra, es causa y efecto:

// 1. Escuchar el Clic
boton.addEventListener('click', () => {
    // 2. Ejecutar la acción
    document.getElementById('menu').show();
});

                    Archivos clave en assets/js:
                    search.js: Motor de búsqueda instantánea de productos.
navbar.js: Control de menús y scroll suave.
gtm.js: Seguimiento de estadísticas de Google.
modern_catalog.js: Filtros y categorías dinámicas.

                

5. Gestión de Métricas (GTM)

El archivo gtm.js es sagrado. Si vas a actualizarlo, asegúrate de copiar el código completo. Un paréntesis olvidado puede "romper" no solo las métricas, sino la visualización completa de la web en ciertos navegadores.

Resumen de Mantenimiento

Contenido: Edita los archivos .md. Es texto plano, fácil y seguro.

Desarrollo: Corre bundle exec jekyll serve para ver cambios antes de subir.

Producción: Siempre ejecuta npm run build para optimizar los archivos finales.