PyCon Panamá — sitio web oficial

Este repositorio contiene el sitio público de PyCon Panamá, la conferencia de la comunidad Python Panamá. Es un sitio estático: cada edición se conserva en su propia carpeta y Netlify publica la raíz del repositorio.

Producción: pycon.pa · Edición activa: 2026 · Contacto: pyconpanama@gmail.com

Índice

• Inicio rápido
• Estructura y alcance
• Cambiar el sitio
• Validar antes de proponer cambios
• Despliegue
• Contribuir
• Documentación y contacto

Inicio rápido

La edición activa no requiere Node.js, dependencias ni proceso de compilación; basta con Python 3 para servir los archivos localmente.

git clone https://github.com/pythonpanama/pycon_panama_web.git
cd pycon_panama_web
python3 -m http.server 8000

Abre http://localhost:8000/2026/.

Sirve desde la raíz del repositorio, no desde 2026/: así las rutas absolutas, el favicon y las URLs de cada edición se comportan como en producción. Para detener el servidor, usa Ctrl+C.

Estructura y alcance

Ruta	Uso	¿Se edita normalmente?
2026/	Edición pública activa: HTML, CSS y JavaScript sin framework.	Sí
2025/ y 2024/	Ediciones archivadas.	No, excepto correcciones puntuales
local_server/	Proxy opcional, limitado a 127.0.0.1, para pruebas locales con Supabase. Usa una clave privilegiada.	Solo para desarrollo local; jamás se publica
netlify.toml	Publicación, redirección de / a /2026/ y cabeceras HTTP.	Con revisión cuidadosa

Otros archivos de la raíz cumplen funciones de publicación: 404.html, robots.txt, sitemap.xml y favicon.ico.

Important

El esquema de la base de datos no se versiona aquí. Los formularios de 2026/ escriben en Supabase, pero los scripts que crean las tablas y fijan sus privilegios viven en el repositorio privado pycon_panama_docs, en docs-internas/referencia/supabase/. Estuvieron en 2026/ hasta el 6 de septiembre de 2026 y, al publicarse la raíz, eran descargables desde pycon.pa: un .sql público entrega el mapa de tablas y columnas y, sobre todo, el inventario de las defensas aplicadas. No los traigas de vuelta.

Este repositorio contiene solo el sitio. Todo lo que se versiona aquí se publica: netlify.toml despliega la raíz completa, así que no añadas al control de versiones archivos que no deban ser públicos ni los enlaces desde las páginas. La información pública se mantiene en las páginas de la edición correspondiente.

El repositorio no contiene submódulos: trabaja siempre en esta raíz. Así se evita editar una copia anidada y desactualizada del sitio.

Cambiar el sitio

1. Crea una rama desde main y delimita el cambio a una edición o propósito claro.
2. Para contenido de 2026, modifica los archivos de 2026/. Conserva la estructura semántica y los estilos compartidos en 2026/css/.
3. Si cambias navegación, aplícala en todas las páginas públicas de 2026/: index.html, about.html, agenda.html, sedes.html, codigo_conducta.html, privacidad.html, patrocinadores.html, faq.html, registro.html y ponentes.html.
4. Si agregas una página pública, parte de una existente para mantener lang, viewport, favicon, hojas de estilo, canonical, metadatos Open Graph y el enlace al Código de Conducta. Añade además la URL a sitemap.xml y a SITEMAP_REQUIRED en scripts/validate_site.py: el validador compara ambas listas y falla si difieren. Enlázala desde la navegación o el pie según corresponda.
5. Mantén las fechas, sede, precios, CFP y beneficios como “por anunciar” hasta contar con confirmación pública. No publiques notas operativas, datos personales ni decisiones pendientes.

Patrocinadores

La lista vive en 2026/patrocinadores.html como HTML plano, sin fuente de datos aparte: el orden de los niveles y de las marcas dentro de cada nivel es el que aprueba el Comité Organizador, y se lee tal cual en el archivo. El procedimiento completo —dónde va el logo, qué formato, cómo se escribe el alt, cómo se marca una marca acordada pero aún sin anuncio y cómo se retira una— está en un comentario al inicio de la sección, junto a la plantilla que se copia.

Warning

Aquí solo entra lo que el Comité Organizador confirmó por escrito. Una negociación avanzada no es una confirmación, y publicar una marca sin autorización es un problema legal, no un detalle de diseño. Para lo acordado sin anuncio público está la variante .sponsor-card--pending, que reserva el espacio sin mostrar logo ni nombre.

Los logos van en 2026/img/patrocinadores/, en SVG cuando exista y en PNG con fondo transparente cuando no. Al retirar un patrocinador, borra también su archivo.

Validar antes de proponer cambios

La edición estática no requiere compilación. El validador incluido comprueba enlaces locales, fragmentos, metadatos sociales, URLs canónicas, el sitemap, marcadores de conflicto y las URLs HTTP(S) únicas de terceros. Antes de abrir un Pull Request, ejecuta:

# 1. Comprueba la integridad del sitio público, incluidos enlaces externos.
python3 scripts/validate_site.py

# 2. Evita errores de espacios y líneas finales.
git diff --check

# 3. Confirma que el servidor responde para la edición publicada.
python3 -m http.server 8000
# En otra terminal:
curl -I http://localhost:8000/2026/

Si el validador reporta un enlace externo caído:

1. Ábrelo en el navegador. Si no carga, corrige o retira el href/src.
2. Las URLs de pycon.pa se resuelven contra archivos del repositorio, no contra producción, para no romper PRs de páginas nuevas.
3. Instagram, Facebook, LinkedIn, Meetup y pylatam.org están excluidos a propósito: bloquean rastreadores de CI o no responden a tiempo desde GitHub Actions. Si otro host se comporta igual, añádelo a SKIP_EXTERNAL_HOSTS en scripts/validate_site.py con un comentario que justifique la exclusión.
4. Sin red: python3 scripts/validate_site.py --skip-external.

Después, revisa en el navegador la página afectada en escritorio y móvil: navegación, enlaces, imágenes, contraste, foco de teclado y diseño con zoom. Si cambias contenido o rutas, verifica también sitemap.xml, el canonical y las tarjetas sociales (og:*).

Antes de enviar cambios, revisa el alcance exacto:

git status --short
git diff --check
git diff -- 2026/ netlify.toml sitemap.xml robots.txt

Despliegue

Netlify publica la raíz del repositorio (publish = ".") según netlify.toml. La configuración redirige / a /2026/ y define cabeceras de seguridad para el sitio.

El flujo esperado es:

1. Abrir un Pull Request con una descripción breve, la página o edición afectada y cómo se validó.
2. Revisar el preview de Netlify si está disponible para el repositorio.
3. Integrar en main tras la revisión correspondiente; Netlify realiza la publicación configurada.
4. Confirmar en producción la ruta modificada y, si aplica, la redirección raíz.

No modifiques netlify.toml para cambiar la edición activa ni para publicar rutas adicionales sin una decisión explícita del equipo organizador.

Contribuir

Las contribuciones son bienvenidas, especialmente correcciones de contenido, accesibilidad, enlaces y mantenimiento del sitio.

• Usa una rama con un nombre descriptivo y commits pequeños que expliquen el cambio.
• No mezcles una mejora de la edición activa con cambios generados, archivos locales o correcciones de una edición archivada.
• Escribe la documentación en Markdown con formato completo: encabezados jerárquicos, tablas para lo que tenga fecha o responsable, avisos > [!NOTE] y > [!WARNING], bloques de código con el lenguaje declarado y enlaces relativos con texto descriptivo. Sella la fecha de última actualización en cada documento que edites.
• Respeta el Código de Conducta en toda interacción del proyecto.
• No hay una licencia general declarada en la raíz del repositorio. Consulta al equipo antes de reutilizar contenido o recursos fuera de este proyecto.

Documentación y contacto

• Edición 2026: sitio actualmente publicado.
• Python Panamá · Instagram · Facebook · LinkedIn · Meetup

Para consultas sobre PyCon Panamá, escribe a pyconpanama@gmail.com.

Publicación de la agenda 2026 — issue #118

Última actualización: 8 de septiembre de 2026.

La agenda permanece en espera hasta el lunes 28 de septiembre de 2026. No hay hora definida ni publicación automática: organización debe confirmar el contenido aprobado y el momento de publicación.

La versión preliminar se conserva exclusivamente en el historial de Git, en el commit bbaf5d9abb6594f3aec972b083f36445123fca68. No guardar copias, parches ni exportaciones de esa versión dentro del directorio publicado (publish = "."). El historial permite recuperar también la ubicación de los enlaces retirados.

Para preparar la restitución:

1. Crear una rama desde main actualizado y consultar la versión histórica con git show bbaf5d9abb6594f3aec972b083f36445123fca68:2026/agenda.html. Usarla solamente como referencia estructural; sustituir las sesiones, horarios y ponentes por la programación aprobada por organización.
2. Editar la página actual conservando su navegación y metadatos vigentes. Actualizar la descripción y el contenido principal con la agenda aprobada.
3. Restituir el enlace Agenda en los menús de todas las páginas de 2026/, incluido voluntariado/index.html (ruta ../agenda.html); la tarjeta de inicio; y los botones de about.html y sedes.html. Consultar el diff del cambio #118 para las ubicaciones, sin revertir páginas completas que puedan haber recibido otras mejoras.
4. Restituir la URL de agenda en sitemap.xml y SITEMAP_REQUIRED de scripts/validate_site.py. Revisar la descripción de inicio.
5. Ejecutar python3 scripts/validate_site.py, node --test tests/*.cjs y git diff --check. Revisar el preview en móvil y escritorio, el menú, los enlaces restituidos y el acceso directo a /2026/agenda.html.
6. Integrar el PR revisado cuando organización autorice la publicación el 28 de septiembre. Verificar el despliegue de Netlify y repetir la navegación y el acceso directo en producción antes de dar la restitución por terminada.

El aviso se mantiene si falta la aprobación; no se elimina automáticamente por el cambio de fecha. La cuenta regresiva corresponde al issue #119.

Publicación de las sedes 2026

Última actualización: 8 de septiembre de 2026.

Por indicación de organización, las sedes siguen el mismo procedimiento de publicación manual del 28 de septiembre de 2026 que la agenda, sin hora ni activación automática. La versión anterior se conserva en Git en el commit 76e034601ee9ddb44fa103872aaba274e4efb4bf, sin añadir copias al sitio publicado.

Para restituirlas, crear una rama desde main actualizado y consultar git show 76e034601ee9ddb44fa103872aaba274e4efb4bf:2026/sedes.html como referencia. Actualizar la página actual con ubicaciones, direcciones, contactos y mapas aprobados; revisar sus metadatos. Restituir los enlaces de los once menús, la tarjeta y enlace de inicio, las referencias de Acerca de, FAQ y formularios, y la entrada del sitemap y de SITEMAP_REQUIRED. Revisar también las referencias de ubicaciones en voluntariado y Código de Conducta, manteniendo las reglas de conducta y los valores persistidos de los formularios.

Consultar el diff de la retirada para localizar cada cambio, sin revertir páginas completas. Ejecutar las mismas validaciones indicadas para la agenda, revisar móvil/escritorio y publicar con autorización de organización. Verificar el acceso directo a /2026/sedes.html, los enlaces y los mapas en producción.