Skip to content

Commit f3ab6f2

Browse files
pixelead0pixelead0
pixelead0
and
pixelead0
authored
feat: Sistema completo de sedes y corrección de botones críticos (#16)
* Meetup Agosto 2025 "Escalando tus aplicaciones Python con Ray" Juan Guillermo Gomez * Add new "Sedes" section and update community links in documentation * Enhance button styles in custom.css with !important declarations for better visibility and consistency across various button types. * Update CHANGELOG.md to include comprehensive documentation for the new "Sedes" * Enhance CI/CD workflow by adding steps for repository checkout, Python setup, dependency installation, MkDocs site build, and GitHub Pages deployment. * Fix link formatting in Sedes FAQ to ensure proper navigation to the "Ser Ponente" section. * Fix regex pattern for updating broken links in fix_broken_links.py to ensure correct content replacement. * Update CI workflow to use MkDocs for link checking instead of Python HTTP server, improving reliability and readiness time. * Update link formatting in documentation to ensure proper navigation and consistency across various sections, including community contributions and meetups. * Update CI workflows to include the --use-directory-urls option for MkDocs build and serve commands, enhancing link resolution and site navigation. --------- Co-authored-by: pixelead0 <[email protected]>
1 parent f01ee32 commit f3ab6f2

File tree

17 files changed

+758
-53
lines changed

17 files changed

+758
-53
lines changed

‎.github/workflows/build.yml‎

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -30,31 +30,30 @@ jobs:
3030
uses: pre-commit/[email protected]
3131

3232
- name: Build with MkDocs
33-
run: mkdocs build
33+
run: mkdocs build --use-directory-urls
3434
env:
3535
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
3636

3737
- name: Check for broken links
3838
run: |
39-
# Iniciar servidor HTTP en background
40-
cd site && python -m http.server 8000 &
41-
sleep 10
39+
# Iniciar mkdocs serve en background (mejor que python -m http.server)
40+
mkdocs serve -a 127.0.0.1:8000 --use-directory-urls &
41+
sleep 15 # Dar más tiempo para que mkdocs serve esté listo
4242
43-
# Ejecutar check de links desde el directorio raíz
44-
cd ${{ github.workspace }}
43+
# Ejecutar check de links
4544
python scripts/check_links.py
4645
4746
# Verificar resultado
4847
broken_count=$(jq '.summary.broken_links' broken_links.json)
4948
5049
if [ "$broken_count" -gt 0 ]; then
5150
echo "❌ Found $broken_count broken links - failing!"
52-
pkill -f "python -m http.server" || true
51+
pkill -f "mkdocs serve" || true
5352
exit 1
5453
fi
5554
5655
echo "✅ All links working!"
57-
pkill -f "python -m http.server" || true
56+
pkill -f "mkdocs serve" || true
5857
5958
# Solo para main: guardar el sitio construido
6059
- name: Upload build artifact

‎.github/workflows/ci-cd.yml‎

Lines changed: 23 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,26 @@ jobs:
1616
name: Build and Validate
1717
runs-on: ubuntu-latest
1818
steps:
19-
# ... todos los pasos de validación y build ...
19+
- name: Checkout repository
20+
uses: actions/checkout@v4
21+
22+
- name: Set up Python
23+
uses: actions/setup-python@v4
24+
with:
25+
python-version: '3.x'
26+
27+
- name: Install dependencies
28+
run: |
29+
python -m pip install --upgrade pip
30+
pip install -r requirements.txt
31+
32+
- name: Build MkDocs site
33+
run: mkdocs build --strict --use-directory-urls
34+
35+
- name: Upload Pages artifact
36+
uses: actions/upload-pages-artifact@v3
37+
with:
38+
path: site/
2039

2140
deploy:
2241
name: Deploy to GitHub Pages
@@ -27,4 +46,6 @@ jobs:
2746
name: github-pages
2847
url: ${{ steps.deployment.outputs.page_url }}
2948
steps:
30-
# ... pasos de deploy ...
49+
- name: Deploy to GitHub Pages
50+
id: deployment
51+
uses: actions/deploy-pages@v4

‎CHANGELOG.md‎

Lines changed: 61 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,66 @@ El formato sigue [Keep a Changelog](https://keepachangelog.com/es-ES/1.0.0/) y [
66

77
---
88

9+
## [Unreleased]
10+
11+
### Añadido
12+
- **Sistema Completo de Sedes**: Implementación integral de documentación para empresas que quieren ser sede
13+
- `sedes.md`: Página principal con formato estándar de comunidad, incluyendo header con logo,
14+
iconos FontAwesome y componentes de navegación
15+
- `sedes_faq.md`: FAQ comprehensivo organizado en 7 secciones temáticas con información
16+
práctica basada en experiencia real
17+
- Integración de imagen personalizada `pythoncdmx_buscamos_sede.jpg` para branding específico
18+
- Timeline detallado desde 3-4 semanas antes hasta después del evento
19+
- Recomendaciones técnicas específicas (HDMI, WiFi, proyección, streaming)
20+
- **Documentación Práctica de Eventos**: Integración completa de lecciones aprendidas del evento en Clara
21+
- Proceso de acceso a edificios con seguridad (formularios, listas, identificación oficial)
22+
- Manejo de asistentes: 60-70% de asistencia real vs registrados
23+
- Mejores prácticas para organización del espacio y áreas restringidas
24+
- Requerimientos específicos de A/V y conectividad
25+
- Checklist de preparación y coordinación
26+
27+
### Cambiado
28+
- **Formato Unificado de Páginas de Comunidad**: `sedes.md` ahora sigue el estándar establecido
29+
- Header centrado con logo de Python CDMX
30+
- Iconos FontAwesome en lugar de emojis para consistencia visual
31+
- Estructura de secciones con iconografía coherente
32+
- Componentes de navegación estándar (`community-links.md` y `quick-navigation.md`)
33+
- **FAQ de Sedes Completamente Reestructurado**: Organización profesional en secciones temáticas
34+
- **Logística del Evento**: Duración, asistencia, formato, agenda
35+
- **Requerimientos Técnicos**: A/V, proyección, internet, streaming
36+
- **Gestión de Asistentes**: Registro, listas, acceso a edificios
37+
- **Participación de la Empresa**: Branding, charlas, snacks, bienvenida
38+
- **Preparación del Espacio**: Layout, distribución, áreas restringidas
39+
- **Timeline y Coordinación**: Cronograma completo de 3-4 semanas
40+
- **Preguntas Comunes**: Horarios, problemas técnicos, beneficios
41+
42+
### Corregido
43+
- **Visibilidad de Texto en Botones**: Solución definitiva para botones invisibles en `index.md`
44+
- Agregado `!important` estratégico en CSS para `.btn`, `.btn-primary`, `.upcoming-btn`
45+
- Reglas específicas para clases utilizadas en la página principal
46+
- Estados hover consistentes con colores verde Python
47+
- Texto blanco claramente visible en todos los botones del sitio
48+
- **Formato de Listas en Markdown**: Corrección de renderizado de viñetas en `sedes_faq.md`
49+
- Agregadas líneas en blanco antes de listas para renderizado correcto
50+
- Mejora en la legibilidad de información estructurada
51+
52+
### Arquitectura y Sistema
53+
- **Documentación Escalable para Sedes**: Sistema modular que facilita agregar nueva información
54+
- **CSS Específico para Botones**: Arquitectura robusta que previene problemas de visibilidad
55+
- **Integración de Experiencia Real**: Documentación basada en eventos reales (Clara)
56+
para mayor utilidad práctica
57+
- **Estandarización Visual**: Todas las páginas de comunidad ahora siguen el mismo
58+
formato y estructura
59+
60+
### Impacto
61+
- **Herramienta Completa para Sedes**: Las empresas ahora tienen toda la información
62+
necesaria para ser sede exitosa
63+
- **Reducción de Preguntas Repetitivas**: FAQ comprehensive reduce la carga de soporte
64+
- **Mejora en UX**: Botones ahora completamente funcionales y visibles
65+
- **Professionalización**: Documentación de nivel empresarial para partnerships
66+
67+
---
68+
969
## [0.1.0]
1070

1171
### Añadido
@@ -71,7 +131,7 @@ El formato sigue [Keep a Changelog](https://keepachangelog.com/es-ES/1.0.0/) y [
71131
- **Arquitectura Moderna**: CSS centralizado mejora dramáticamente la mantenibilidad y consistencia visual
72132
- **Escalabilidad Mejorada**: Nueva arquitectura permite agregar contenido sin modificar estilos
73133

74-
## [0.1.0]
134+
## [0.1.0] - Inicial
75135

76136
### Añadido
77137
- **Nueva Sección Participa**: Creada sección modular con tabs para mejor organización

‎docs/comunidad/como-contribuir.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ Ayuda a establecer y mantener relaciones con otras comunidades y empresas.
6060

6161
### 1. <i class="fas fa-search"></i> Identifica tu Área
6262

63-
- Revisa las [formas de contribuir](#formas-de-contribuir)
63+
- Revisa las [formas de contribuir](#formas-de-contribuir/)
6464
- Considera tus habilidades e intereses
6565
- Evalúa tu disponibilidad de tiempo
6666

‎docs/comunidad/comunidades.md‎

Lines changed: 168 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,168 @@
1+
<div align="center">
2+
<img src="/images/logo.png" alt="Python CDMX Logo">
3+
</div>
4+
5+
---
6+
7+
## <i class="fas fa-users"></i> Comunidades Amigas
8+
9+
### <i class="fas fa-star"></i> Comunidades Python en México
10+
11+
<div class="communities-grid">
12+
13+
<!-- PyMTY-->
14+
<a href="https://social.org.mx/@pymty" target="_blank" rel="noopener noreferrer">
15+
<div class="community-card">
16+
<img src="/images/comunidades/pymty.png" alt="Logo PyMTY">
17+
<h4><i class="fab fa-python"></i>PyMTY</h4>
18+
<p>Nuevo Leon</p>
19+
</div>
20+
</a>
21+
22+
<!-- Pythonistas GDL -->
23+
<a href="https://pythonistas-gdl.org/" target="_blank" rel="noopener noreferrer">
24+
<div class="community-card">
25+
<img src="/images/comunidades/pythonistas-GDL.jpg" alt="Logo PythonistasGDL">
26+
<h4><i class="fab fa-python"></i>Pythonistas GDL</h4>
27+
<p>Jalisco</p>
28+
</div>
29+
</a>
30+
31+
<!-- PyTalavera -->
32+
<a href="https://www.facebook.com/profile.php?id=61559788469426" target="_blank" rel="noopener noreferrer">
33+
<div class="community-card">
34+
<img src="/images/comunidades/pyTalavera.jpg" alt="Logo PyTalavera">
35+
<h4><i class="fab fa-python"></i>PyTalavera</h4>
36+
<p>Puebla</p>
37+
</div>
38+
</a>
39+
40+
<!-- Pyladies Cuernavaca -->
41+
<a href="https://pyladies-cuernavaca.quarto.pub/web/" target="_blank" rel="noopener noreferrer">
42+
<div class="community-card">
43+
<img src="/images/comunidades/pyladies-cuernavaca.png" alt="Logo pyladies-cuernavaca">
44+
<h4><i class="fab fa-python"></i>pyladies Cuernavaca</h4>
45+
<p>Morelos</p>
46+
</div>
47+
</a>
48+
49+
</div>
50+
51+
### <i class="fas fa-code"></i> Otras Comunidades
52+
53+
<div class="communities-grid">
54+
55+
<!-- Ajolotes en la nube -->
56+
<a href="https://www.meetup.com/es/ajolotesenlanube/" target="_blank" rel="noopener noreferrer">
57+
<div class="community-card">
58+
<img src="/images/comunidades/ajolotes-nube.png" alt="Logo Ajolotes en la Nube">
59+
<h4><i class="fab fa-aws"></i> Ajolotes en la Nube</h4>
60+
<p>CDMX</p>
61+
</div>
62+
</a>
63+
64+
<!-- LIDSOL -->
65+
<a href="https://www.meetup.com/es/ajolotesenlanube/" target="_blank" rel="noopener noreferrer">
66+
<div class="community-card">
67+
<img src="/images/comunidades/lidsol.png" alt="Logo Ajolotes en la Nube">
68+
<h4><i class="fas fa-code"></i> LIDSOL</h4>
69+
<p>UNAM, Facultad ingeniería<br>CDMX</p>
70+
</div>
71+
</a>
72+
73+
<!-- sudofCiencias -->
74+
<a href="https://linktr.ee/sudo_fciencias" target="_blank" rel="noopener noreferrer">
75+
<div class="community-card">
76+
<img src="/images/comunidades/sudofciencias.jpeg" alt="Logo sudoFCiencias">
77+
<h4><i class="fas fa-code"></i> sudoFCiencias</h4>
78+
<p>UNAM, Facultad Ciencias<br>CDMX</p>
79+
</div>
80+
</a>
81+
82+
<!-- Fedora México-->
83+
<a href="https://fedoramx.fedorapeople.org/" target="_blank" rel="noopener noreferrer">
84+
<div class="community-card">
85+
<img src="/images/comunidades/fedoramexico.png" alt="Logo sudoFCiencias">
86+
<h4><i class="fab fa-linux"></i> Fedora México</h4>
87+
<p>México</p>
88+
</div>
89+
90+
</a>
91+
92+
<!-- RustMX-->
93+
<a href="https://rustmx.github.io/" target="_blank" rel="noopener noreferrer">
94+
<div class="community-card">
95+
<img src="/images/comunidades/rustmx.png" alt="Logo RustMX">
96+
<h4><i class="fab fa-rust"></i> RustMX</h4>
97+
<p>México</p>
98+
</div>
99+
</a>
100+
<!-- Enchiladas Devops-->
101+
<a href="https://enchiladasdevops.com/" target="_blank" rel="noopener noreferrer">
102+
<div class="community-card">
103+
<img src="/images/comunidades/enchiladas-devops.png" alt="Logo enchiladas devops">
104+
<h4><i class="fas fa-server"></i> Enchiladas Devops</h4>
105+
<p>México</p>
106+
</div>
107+
</a>
108+
109+
<!-- Linux en español -->
110+
<a href="https://t.me/linuxito" target="_blank" rel="noopener noreferrer">
111+
<div class="community-card">
112+
<img src="/images/comunidades/LinuxEnEspanol.jpg" alt="Logo Linux en español">
113+
<h4><i class="fab fa-linux"></i> Linux en español</h4>
114+
<p>Latinoamérica</p>
115+
</div>
116+
</a>
117+
118+
<!-- Salamandra DEVS-->
119+
<a href="https://t.me/salamandradevs" target="_blank" rel="noopener noreferrer">
120+
<div class="community-card">
121+
<img src="/images/comunidades/salamandra-devs.jpg" alt="Logo Salamandra Devs">
122+
<h4><i class="fas fa-code"></i> Salamandra Devs</h4>
123+
<p>México</p>
124+
</div>
125+
</a>
126+
</div>
127+
128+
---
129+
130+
## <i class="fas fa-building"></i> Empresas anfitrionas
131+
132+
<div align="center">
133+
<b>Estas empresas han abierto sus puertas para que la comunidad Python CDMX crezca</b>
134+
</div>
135+
136+
### <i class="fas fa-star"></i> Gracias por ser sede
137+
138+
<div class="communities-grid">
139+
140+
<!-- Wizeline Mexico -->
141+
<a href="https://www.wizeline.com/" target="_blank" rel="noopener noreferrer">
142+
<div class="community-card">
143+
<img src="/images/comunidades/wizeline.png" alt="Logo Wizeline">
144+
<h4><i class="fas fa-building"></i> Wizeline México</h4>
145+
<p>Sede histórica y principal de 2023 a 2025</p>
146+
</div>
147+
</a>
148+
149+
<!-- Clara -->
150+
<a href="https://www.clara.com/" target="_blank" rel="noopener noreferrer">
151+
<div class="community-card">
152+
<img src="/images/comunidades/clara.png" alt="Logo Clara">
153+
<h4><i class="fas fa-building"></i> CLARA</h4>
154+
<p>Anfitriones en múltiples ediciones recientes</p>
155+
</div>
156+
</a>
157+
158+
</div>
159+
160+
---
161+
162+
--8<-- "components/community-links.md"
163+
164+
---
165+
166+
--8<-- "components/quick-navigation.md"
167+
168+
---

0 commit comments

Comments
 (0)