Python Panamá: sitio web oficial

📄 Descripción

Sitio web oficial de la comunidad Python Panamá, desarrollado por y para la comunidad. Este proyecto tiene como objetivo proporcionar un punto central de información sobre eventos, recursos, tutoriales y noticias relacionadas con Python en Panamá.

✨ Características

• 🌐 Sitio web completamente responsivo
• 📅 Información de eventos e iniciativas de la comunidad
• 📚 Recursos educativos de Python
• 📰 Blog con noticias y tutoriales
• 🤝 Página de patrocinadores
• 🧭 Página de Python Route
• 🔄 Integración con redes sociales

🛠️ Tecnologías

• Frontend: React 18, TypeScript, Vite
• Routing: React Router DOM
• Estilos: Bootstrap 5, Font Awesome, CSS personalizado
• Build tooling: TypeScript, ESLint, Vite

📋 Prerrequisitos

• Git
• Node.js 18+
• npm

🚀 Instalación

1. Clonar el repositorio

git clone https://github.com/pythonpanama/python_panama_website.git
cd python_panama_website

2. Instalar dependencias

npm install

3. Ejecutar el servidor de desarrollo

npm run dev

El sitio estará disponible en la URL local que indique Vite, normalmente http://localhost:5173/.

📦 Comandos disponibles

Ejecutar el entorno de desarrollo:

npm run dev

Generar build de producción:

npm run build

Previsualizar el build localmente:

npm run preview

Ejecutar lint:

npm run lint

🔎 SEO y analítica

• Prerenderizado: npm run build genera un HTML por ruta (dist/blog.html, dist/python-route/agenda.html…) con título, descripción, canonical, Open Graph y datos estructurados propios, además de sitemap.xml, 404.html y _redirects.
• Agregar una página: crea la ruta en src/pages/App.tsx y su entrada en src/seo/siteSeo.ts. Sin esa entrada, la página no se prerenderiza ni aparece en el sitemap. npm test comprueba que cada página tenga título y descripción únicos y un solo <h1>.
• Google Analytics 4 (opcional): define VITE_GA_MEASUREMENT_ID (por ejemplo, G-XXXXXXXXXX) en las variables de entorno de Netlify. Sin esa variable no se carga ningún script de Google y la CSP no lo permite.
• Verificación en buscadores (opcional): GOOGLE_SITE_VERIFICATION y BING_SITE_VERIFICATION agregan las meta etiquetas de Search Console y Bing Webmaster Tools. La verificación por DNS no las necesita.

👥 Cómo contribuir

¡Nos encantaría que contribuyeras! Puedes abrir un issue o enviar un pull request con mejoras al sitio, contenido, estilos o documentación.

📝 Código de conducta

Este proyecto sigue el código de conducta publicado en la sección /codigo-de-conducta del sitio. Al participar, se espera que respetes este código.

🗺️ Mapa del sitio

• / — Página principal
• /codigo-de-conducta — Código de conducta de la comunidad
• /patrocinadores — Patrocinadores
• /blog — Noticias y tutoriales
• /historia — Trayectoria de la comunidad Python Panamá
• /lugares — Sedes y territorios documentados de actividades de la comunidad
• /empresas-colaboradoras — Empresas que han acogido o apoyado eventos, con su función documentada
• /formacion — Cursos y talleres de Python Panamá
• /python-route — Información de Python Route
• /patrocinadores — Opciones de patrocinio y sus páginas de comunidad, formación y conferencia
• /contacto — Redes sociales y canales oficiales

🔗 Enlaces útiles

• Sitio oficial de Python Panamá
• Twitter de Python Panamá
• Canal de Discord
• Grupo de Meetup

👏 Agradecimientos

• A todos los contribuidores que han ayudado a construir este proyecto
• A la Python Software Foundation por su apoyo
• A la comunidad global de Python por su inspiración