diff --git a/.markdownlint.json b/.markdownlint.json new file mode 100644 index 0000000..f7067f2 --- /dev/null +++ b/.markdownlint.json @@ -0,0 +1,7 @@ +{ + "MD033": false, + "MD041": false, + "MD013": false, + "MD025": false, + "MD026": false +} diff --git a/CHANGELOG.md b/CHANGELOG.md index 0d27961..f3a7f20 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,6 +8,71 @@ El formato sigue [Keep a Changelog](https://keepachangelog.com/es-ES/1.0.0/) y [ ## [Unreleased] +### Añadido +- **Sistema de Estilos para Alianzas**: Implementación completa de estilos CSS para la sección de comunidades aliadas + - `.communities-grid`: Grid responsivo con auto-fit y minmax(280px, 1fr) + - `.community-card`: Tarjetas con efectos hover avanzados y animación de brillo deslizante + - Imágenes circulares con escala en hover y transiciones suaves + - Diseño completamente responsivo optimizado para móvil +- **Galería de Imágenes Completa**: 6 fotos profesionales de ponentes destacados + imagen de voluntario +- **Sistema de Automatización**: Scripts para detección y corrección automática de enlaces rotos +- **Estándares de Calidad**: Configuración MarkdownLint para validación automática de documentación + +### Cambiado +- **Documentación Reorganizada**: Reestructuración completa entre README.md y CONTRIBUTING.md + - README.md: Simplificado con información esencial y referencias a documentación detallada + - CONTRIBUTING.md: Expandido con proceso completo de fork, setup, workflow detallado y guidelines específicas + - Separación clara entre información de usuario y documentación de contribución +- **CSS Completamente Optimizado**: Depuración final del archivo custom.css + - **Eliminación total de `!important`**: 7 instancias removidas de botones y navegación para mejor mantenibilidad + - **Reorganización estructural**: Orden lógico desde elementos básicos hasta responsive design + - **Consolidación avanzada**: Enlaces de redes sociales y componentes mejor organizados + - **Mejora de legibilidad**: Indentación consistente y comentarios descriptivos mejorados + - **Estructura CSS profesional**: 13 secciones claramente definidas desde variables hasta media queries +- **Secciones de Comunidad Rediseñadas**: Ponentes y voluntarios con sistema de pestañas funcional e imágenes personales integradas +- **Enlaces Corregidos**: Eliminación sistemática de enlaces rotos en toda la documentación +- **Navegación Simplificada**: Páginas de índice de meetups optimizadas sin contenido duplicado + +### Eliminado +- **Dependencias CSS problemáticas**: Eliminación completa de `!important` para arquitectura más limpia +- **Redundancias CSS**: Código duplicado y selectores no utilizados removidos +- **Contenido Obsoleto**: Archivo tags.md y elementos duplicados removidos para mejorar mantenimiento + +### Arquitectura y Sistema +- **CSS Sin `!important`**: Migración completa a selectores específicos y arquitectura CSS limpia +- **Estructura CSS Optimizada**: 13 secciones organizadas lógicamente + 1. Variables CSS personalizadas + 2. Sección Hero + 3. Sistema de botones + 4. Tarjetas y grillas + 5. Tarjetas de voluntarios + 6. Tarjetas de comunidades aliadas (NUEVO) + 7. Enlaces de comunidad + 8. Lema de la comunidad + 9. Navegación y secciones especiales + 10. Iconografía + 11. Animaciones + 12. Media queries responsivas + 13. Utilidades y helpers +- **Documentación Profesional**: Separación clara entre información de usuario y guías de contribución +- **Eliminación Completa de Estilos Inline**: Migración total a CSS centralizado para separación de presentación y contenido +- **Sistema Unificado de Tarjetas**: Ponentes y voluntarios ahora usan la misma estructura base (`.volunteer-card`) con contenido diferenciado +- **Arquitectura Mantenible**: Implementación de `.volunteer-header` elimina selectores hardcodeados y facilita escalabilidad +- **Optimización CSS Avanzada**: Reducción significativa en complejidad de código mediante eliminación de `!important` y reorganización +- **Sistema de Badges Comprehensivo**: 8 tipos de roles predefinidos con colores específicos para identificación visual +- **Reorganización Alfabética**: Todos los ponentes organizados alfabéticamente para mejor navegación y mantenimiento + +### Impacto +- **Arquitectura CSS Moderna**: Eliminación de `!important` mejora la mantenibilidad y especificidad natural +- **Mantenimiento Simplificado**: Separación clara de responsabilidades entre archivos de documentación +- **CSS Escalable**: Nueva organización permite agregar estilos sin conflictos de especificidad +- **Presentación Profesional**: Sistema unificado con efectos visuales modernos para alianzas y comunidades +- **Documentación Clara**: Proceso de contribución bien definido para nuevos colaboradores +- **Arquitectura Moderna**: CSS centralizado mejora dramáticamente la mantenibilidad y consistencia visual +- **Escalabilidad Mejorada**: Nueva arquitectura permite agregar contenido sin modificar estilos + +## [0.1.0] + ### Añadido - **Nueva Sección Participa**: Creada sección modular con tabs para mejor organización - **Nuevo Voluntario**: Agregada Mónica Ortega a la lista de voluntarios destacados @@ -73,7 +138,7 @@ El formato sigue [Keep a Changelog](https://keepachangelog.com/es-ES/1.0.0/) y [ --- -## [1.0.0] - 2024-06-24 +## [0.0.2] - 2024-06-24 ### Añadido - Lanzamiento inicial del sitio web Python CDMX Charlas @@ -94,7 +159,7 @@ El formato sigue [Keep a Changelog](https://keepachangelog.com/es-ES/1.0.0/) y [ --- -## [0.1.0] - 2024-01-31 +## [0.0.1] - 2024-01-31 ### Añadido - Primer README.md y documentación básica del proyecto. diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..ca8cff5 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,631 @@ +# Python CDMX Project Memory + +> **For New Developers**: This file contains all the essential information needed to continue developing this project using Claude AI. Read this completely before making any changes. + +## Project Overview +This is the Python CDMX community website built with MkDocs Material. The site showcases meetups, community participation, and Python-related content for Mexico City's Python community with a modern Material Design approach. + +**Community Motto**: *"Vine por el código, me quedé por la comunidad"* - This phrase is central to the community and prominently displayed on the homepage. + +## Architecture & Technology Stack +- **Framework**: MkDocs Material +- **Styling**: Optimized custom CSS with Material Design principles +- **Content**: Markdown files with reusable HTML components +- **Deployment**: Static site generation +- **Content Management**: Manual markdown editing + automated scripts +- **Icons**: FontAwesome 6.4.0 via CDN + +## File Structure & Organization +- `docs/` - All content and assets +- `docs/css/custom.css` - Main styling file (~450 lines, heavily optimized) +- `docs/index.md` - Homepage with hero section, motto, and participation cards +- `docs/components/` - Reusable markdown components + - `community-links.md` - Social media links with brand colors + - `quick-navigation.md` - Page navigation cards system +- `docs/meetups/` - Event documentation organized by year +- `docs/comunidad/` - Community pages (volunteers, speakers, etc.) + - `ponentes.md` - **UPDATED**: Unified card system, alphabetical order, no tabs + - `voluntarios.md` - Modern volunteer cards with TOC navigation +- `scripts/` - Python automation scripts for content generation + +## Design System & CSS Guidelines + +### Color Palette +```css +/* Primary Colors */ +--python-green: #4CAF50 +--python-green-dark: #45a049 +--python-white: #ffffff + +/* Social Media Brand Colors */ +--telegram-color: #0088cc +--meetup-color: #ed1c40 +--youtube-color: #ff0000 +--github-color: #333333 +--instagram-color: #e4405f +--linkedin-color: #0077b5 +``` + +### CSS Architecture +- **Variables-first approach**: All colors, transitions, and spacing use CSS custom properties +- **MkDocs Material integration**: Leverages native variables (`var(--md-primary-fg-color)`) +- **Responsive design**: Single breakpoint at 768px for mobile +- **Component-based**: Clear separation of concerns with dedicated sections +- **Maintainable selectors**: Uses semantic classes instead of hardcoded identifiers +- **Optimized structure**: Consolidated media queries, unified transitions +- **Heavily optimized**: Eliminated duplications, consistent variable usage + +### Component Classes + +#### Core Layout +- `.hero-section` - Main landing area with logo and buttons +- `.community-motto` - Highlighted community slogan with decorative quotes +- `.participation-grid` - 2-column grid (1 on mobile) with centered 3rd card + +#### Cards & Content +- `.participation-card` - Large centered icons with call-to-action buttons +- `.year-card` - Annual summaries with specialized styling and hover effects +- `.stat-card` - Statistics display cards +- `.volunteer-card` - **UNIFIED SYSTEM**: Used for both volunteers AND speakers with identical structure + - Volunteers: Focus on community contributions and organizational roles + - Speakers: Focus on technical specialties and recent talks +- `.community-highlight` - Special highlighted sections +- `.upcoming-events` - Event highlight sections + +#### Navigation & Buttons +- `.action-buttons` - Hero button containers +- `.btn`, `.btn-primary` - Standard action buttons (green) +- `.btn-nav` - Discrete navigation buttons (minimal style) +- `.btn-action` - Volunteer card action buttons (outline style) +- `.quick-navigation` - End-of-page navigation grid +- `.quick-navigation-title` - Navigation section titles + +#### Community Links +- `.community-links` - Social media grid with brand colors +- `.community-link` - Individual social platform buttons with hover effects +- Specific classes: `.telegram`, `.meetup`, `.youtube`, `.github`, `.instagram`, `.linkedin` + +#### Communities & Partnerships +- `.communities-grid` - **NEW**: Auto-fit responsive grid for partner communities with minmax(280px, 1fr) +- `.community-card` - **NEW**: Partner community cards with advanced hover effects + - Sliding shine animation on hover + - Circular images with scale transformation + - Smooth transitions using existing CSS variables + - Mobile-optimized responsive design +- `.community-card img` - Circular community logos (100px) with hover scale effect +- `.community-card h3` - Community names with centered alignment +- `.community-card p` - Community descriptions with proper spacing + +#### Volunteer System (Optimized & Maintainable) +- `.volunteer-card` - Main volunteer profile container with grid layout +- `.volunteer-header` - **NEW**: Maintainable class for hiding TOC headers +- `.card-header` - Two-column grid: info on left, avatar/social on right +- `.card-info` - Left column with name, subtitle, and badges +- `.card-title` - Volunteer names (h3 elements within cards) +- `.card-subtitle` - Role descriptions with proper hierarchy +- `.badges-container` - Flex container for role badges +- `.badge` - Discrete role badges with semi-transparent backgrounds + - `.badge.ambassador` - Green theme for ambassadors + - `.badge.organizer` - Blue theme for organizers + - `.badge.production` - Orange theme for production roles + - `.badge.host` - Purple theme for event hosts + - `.badge.technical` - Gray theme for technical support + - `.badge.support` - Brown theme for general support + - `.badge.global` - Pink theme for global representation + - `.badge.strategic` - Indigo theme for strategic roles +- `.avatar-section` - Right column with circular avatar and social icons +- `.volunteer-avatar` - 100px circular images with hover scale effect +- `.social-icons` - Flex container for social media links +- `.social-icon` - Individual social platform buttons +- `.card-content` - Main content area with role details +- `.card-role` - Container for role title, description, and contributions +- `.role-title` - Uppercase, prominent role titles +- `.role-description` - Italic, lighter role descriptions + +## Development Workflow + +### CSS Modifications +1. **NEVER use inline styles** - Always use classes in custom.css +2. **NEVER use `!important`** - Use specific selectors and proper CSS architecture instead +3. Use existing CSS variables for consistency +4. Follow the established sections in custom.css (13 organized sections): + - Variables CSS personalizadas + - Sección Hero + - Sistema de botones + - Tarjetas y grillas + - Tarjetas de voluntarios + - **Tarjetas de comunidades aliadas** (NEW) + - Enlaces de comunidad + - Lema de la comunidad + - Navegación y secciones especiales + - Iconografía + - Animaciones + - Media queries responsivas + - Utilidades y helpers +5. Test in both light and dark modes +6. Ensure mobile responsiveness at 768px breakpoint +7. **Always prefer specific selectors over `!important`** for maintainable CSS architecture + +### Content Updates +- Event pages: Follow existing year/month structure in `docs/meetups/` +- Images: Store in appropriate `docs/images/` subdirectories + - `voluntarios/` - Volunteer profile images + - `ponentes/` - Speaker profile images (organized alphabetically) + - `meetup/` - Event promotional images + - `comunidades/` - Partner community logos +- Community content: Update respective pages in `docs/comunidad/` +- Components: Use `--8<-- "components/component-name.md"` for includes + +### Theme Configuration +```yaml +# mkdocs.yml +palette: + - scheme: default + primary: green + accent: green + - scheme: slate + primary: green + accent: green +``` + +## Key Components & Usage + +### Community Motto +```html +
Brief description of the partner community
+Role/Company description
+Descripción breve de la comunidad aliada
+Rol/Empresa descripción
+- Después de la charla habrá un tiempo de networking donde podrás platicar con programadores de diferentes niveles e intereses. -
-- *Última actualización: {{ git_revision_date_localized }}* -
-- Después de la charla habrá un tiempo de networking donde podrás platicar con programadores de diferentes niveles e intereses. - ¡Es la oportunidad perfecta para hacer conexiones profesionales y aprender de otros desarrolladores! -
-Nuevo Leon
+ +Nuevo Leon
Jalisco
+ +Jalisco
Puebla
+ +Puebla
Morelos
+ +Morelos
CDMX
+ +CDMX
UNAM, Facultad ingeniería
CDMX
UNAM, Facultad ingeniería
CDMX
UNAM, Facultad Ciencias
CDMX
UNAM, Facultad Ciencias
CDMX
México
+ +México
México
+ +México
México
+ +México
Latinoamérica
+ +Latinoamérica
Sede principal de nuestros meetups
+ +Sede principal de nuestros meetups
SRE Engineer en Wizeline
- DevOps +Python Developer
+Python Developer
- Desarrollo +Services Content Architect en Red Hat
+DevOps Engineer
- DevOps +Ingeniero en Ciencias Informáticas
+Python Developer
- Desarrollo +DevOps Engineer
+Python Developer
- Seguridad +Ingeniero en Computación
- Algoritmos +Desarrollador Web
+Líder Técnico en WordBox
- IA/ML +SRE Engineer en Wizeline
+AI Engineer
- IA +MLOps Engineer en Mercado Libre
+Ingeniero en Sistemas Computacionales
- FinTech +AI Engineer
+Ingeniero en Ciencias Informáticas
- Cloud +Open Source Contributor
+Services Content Architect en Red Hat
- OpenSource +Data Scientist
+Desarrollador Web
- Web +Python Developer
+MLOps Engineer en Mercado Libre
- MLOps +Data Engineer
+Desarrollador LibreOffice
- LibreOffice +Ingeniero en Sistemas Computacionales
+Open Source Contributor
- OpenSource +Líder Técnico en WordBox | Google Developer Expert
+Data Scientist
- Data Science +Python Core Developer
+Data Engineer
- Data Engineering +Ingeniero en Computación
+Python Core Developer
- Core Python +Desarrollador LibreOffice
+Security Engineer
- Seguridad +Conexión entre comunidades y eventos
- Embajador - Organizador +Embajador y moderador de comunidad
- Embajador - Organizador +El ninja que siempre aparece cuando más lo necesitamos
- Embajador - Organizador +Coordinación de contenido y ponentes
- Organizador +El lente, la voz y la chispa detrás de los meetups
- Producción +Presentador y anfitrión de eventos
- Host +Presentador y anfitrión de eventos
- Host +Infraestructura y soporte técnico
- Técnico +Apoyo especial
- Apoyo +No es un bot, pero ya quisieran los bots
- Soporte +Nuestro embajador sin fronteras
- Embajador - Global +NUESTRA ALIADA SILENCIOSA
- Aliada estratégica +Nuestra aliada silenciosa
+#PythonCDMX es un grupo de personas interesadas en aprender y compartir su conocimiento sobre el lenguaje de programación Python. El objetivo es estar en contacto con más gente interesada en innovación y tecnología. +
+Charlas técnicas, networking y aprendizaje colaborativo
- Ver Todos los Meetups +Charlas técnicas, networking y aprendizaje colaborativo
+ Ver MeetupsComparte tu conocimiento con la comunidad. Charlas técnicas, casos de uso, mejores prácticas y más.
- Conoce Más -Ayuda a organizar eventos, gestionar redes sociales, o contribuir con el desarrollo del sitio web.
- Únete -Participa en nuestros meetups, aprende de expertos y conecta con otros desarrolladores Python.
- Ver Eventos -Comparte tu conocimiento con la comunidad. Charlas técnicas, casos de uso, mejores prácticas y más.
+ Conoce Más +Ayuda a organizar eventos, gestionar redes sociales, o contribuir con el desarrollo del sitio web.
+ Únete +Participa en nuestros meetups, aprende de expertos y conecta con otros desarrolladores Python.
+ Ver Eventos +Dos charlas sobre IA en la nube y metaprogramación
- *Última actualización: Generado automáticamente* -
-Fundamentos matemáticos de la regresión lineal
¿Tienes esa gran idea, pero no sabes cómo organizar tu ambiente virtual, tu código y todas las herramientas de desarrollo?
En esta charla exploraremos las mejores prácticas para configurar un entorno de desarrollo Python profesional:
-+
La regresión lineal es la base fundamental para entender algoritmos de machine learning más complejos.
- *Última actualización: Generado automáticamente* -
-Dos charlas sobre el futuro de Python y ETL