From e8369ddedaadba64e557947d8ed6e18651e37548 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 26 Sep 2025 22:43:56 +0000 Subject: [PATCH 1/3] Initial plan From 6d545ef641041482884d76a76251393b95463505 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 26 Sep 2025 22:48:36 +0000 Subject: [PATCH 2/3] Create complete Quarto project structure with content Co-authored-by: josechval <2932503+josechval@users.noreply.github.com> --- .gitignore | 6 +++ README.md | 80 +++++++++++++++++++++++++++++- _quarto.yml | 32 ++++++++++++ about.qmd | 33 ++++++++++++ blog/index.qmd | 16 ++++++ blog/posts/bienvenida.qmd | 35 +++++++++++++ blog/posts/introduccion-python.qmd | 67 +++++++++++++++++++++++++ index.qmd | 37 ++++++++++++++ styles.css | 40 +++++++++++++++ 9 files changed, 344 insertions(+), 2 deletions(-) create mode 100644 _quarto.yml create mode 100644 about.qmd create mode 100644 blog/index.qmd create mode 100644 blog/posts/bienvenida.qmd create mode 100644 blog/posts/introduccion-python.qmd create mode 100644 index.qmd create mode 100644 styles.css diff --git a/.gitignore b/.gitignore index b7faf40..f7b7dc9 100644 --- a/.gitignore +++ b/.gitignore @@ -205,3 +205,9 @@ cython_debug/ marimo/_static/ marimo/_lsp/ __marimo__/ + +# Quarto +/.quarto/ +/_site/ +/.vscode/ +.DS_Store diff --git a/README.md b/README.md index 919cd21..410d5b9 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,78 @@ -# sitio-quarto -Sitio de código estático usando Quarto +# Sitio PythonistaMX + +Sitio web oficial de la comunidad PythonistaMX, construido con [Quarto](https://quarto.org). + +## 🚀 Desarrollo Local + +### Prerrequisitos + +- [Quarto](https://quarto.org/docs/get-started/) instalado +- Python 3.7+ (opcional, para ejecutar código) + +### Instalación + +1. Clona el repositorio: +```bash +git clone https://github.com/PythonistaMX/sitio-quarto.git +cd sitio-quarto +``` + +2. Previsualiza el sitio localmente: +```bash +quarto preview +``` + +3. Construye el sitio para producción: +```bash +quarto render +``` + +## 📁 Estructura del Proyecto + +``` +sitio-quarto/ +├── _quarto.yml # Configuración del proyecto +├── index.qmd # Página principal +├── about.qmd # Página "Acerca de" +├── styles.css # Estilos personalizados +├── blog/ +│ ├── index.qmd # Índice del blog +│ └── posts/ # Artículos del blog +│ └── *.qmd +└── _site/ # Sitio generado (ignorado en git) +``` + +## ✍️ Contribuir + +¿Quieres contribuir con contenido? ¡Excelente! + +1. Haz fork del repositorio +2. Crea una rama para tu contribución +3. Agrega tu contenido en formato `.qmd` +4. Envía un Pull Request + +### Crear un nuevo artículo + +Para crear un nuevo artículo del blog: + +1. Crea un archivo `.qmd` en `blog/posts/` +2. Usa el siguiente formato de header: + +```yaml +--- +title: "Título del artículo" +author: "Tu nombre" +date: "YYYY-MM-DD" +categories: [python, tutorial] +description: "Breve descripción" +--- +``` + +## 📄 Licencia + +Este proyecto está bajo la Licencia MIT. Ver el archivo `LICENSE` para más detalles. + +## 🌐 Enlaces + +- [Comunidad en GitHub](https://github.com/PythonistaMX) +- [Quarto Documentation](https://quarto.org/docs/) diff --git a/_quarto.yml b/_quarto.yml new file mode 100644 index 0000000..a24b31d --- /dev/null +++ b/_quarto.yml @@ -0,0 +1,32 @@ +project: + type: website + +website: + title: "PythonistaMX" + description: "Sitio de la comunidad PythonistaMX" + + navbar: + left: + - href: index.qmd + text: Inicio + - href: about.qmd + text: Acerca de + - href: blog/index.qmd + text: Blog + + sidebar: + - title: "Navegación" + contents: + - href: index.qmd + text: Inicio + - href: about.qmd + text: Acerca de + +format: + html: + theme: cosmo + css: styles.css + toc: true + +execute: + freeze: auto \ No newline at end of file diff --git a/about.qmd b/about.qmd new file mode 100644 index 0000000..dfcf0f9 --- /dev/null +++ b/about.qmd @@ -0,0 +1,33 @@ +--- +title: "Acerca de PythonistaMX" +--- + +# Nuestra Historia + +PythonistaMX nació con el objetivo de reunir a desarrolladores mexicanos interesados en Python y crear un espacio de colaboración y aprendizaje. + +## Misión + +Promover el uso y desarrollo de Python en México, creando una comunidad sólida de desarrolladores que compartan conocimientos, experiencias y mejores prácticas. + +## Visión + +Ser la principal comunidad de Python en México, reconocida por la calidad de sus contenidos, eventos y el apoyo mutuo entre sus miembros. + +## Valores + +- **Colaboración**: Trabajamos juntos para crear mejores soluciones +- **Aprendizaje**: Fomentamos el crecimiento continuo +- **Inclusión**: Creamos un espacio para todos los niveles de experiencia +- **Calidad**: Nos esforzamos por compartir contenido de alta calidad + +## El Equipo + +Somos un grupo de desarrolladores apasionados por Python que dedicamos nuestro tiempo libre a hacer crecer la comunidad. + +## Contacto + +¿Tienes preguntas o quieres colaborar? Nos encantaría saber de ti: + +- **Email**: contacto@pythonistamx.org +- **GitHub**: [github.com/PythonistaMX](https://github.com/PythonistaMX) \ No newline at end of file diff --git a/blog/index.qmd b/blog/index.qmd new file mode 100644 index 0000000..a5fb6ff --- /dev/null +++ b/blog/index.qmd @@ -0,0 +1,16 @@ +--- +title: "Blog PythonistaMX" +listing: + contents: posts + sort: "date desc" + type: default + categories: true + sort-ui: false + filter-ui: false +page-layout: full +title-block-banner: true +--- + +# Blog de la Comunidad + +Aquí encontrarás artículos, tutoriales y noticias relacionadas con Python y la comunidad PythonistaMX. \ No newline at end of file diff --git a/blog/posts/bienvenida.qmd b/blog/posts/bienvenida.qmd new file mode 100644 index 0000000..d77e94e --- /dev/null +++ b/blog/posts/bienvenida.qmd @@ -0,0 +1,35 @@ +--- +title: "Bienvenidos al nuevo sitio de PythonistaMX" +author: "Equipo PythonistaMX" +date: "2024-01-15" +categories: [anuncios, comunidad] +description: "Presentamos el nuevo sitio web de la comunidad PythonistaMX, construido con Quarto" +--- + +# ¡Nuevo sitio web! + +Estamos emocionados de presentar el nuevo sitio web de PythonistaMX, construido con [Quarto](https://quarto.org). + +## ¿Por qué Quarto? + +Quarto nos permite: + +- Crear contenido fácilmente usando Markdown +- Integrar código Python de manera nativa +- Generar sitios web estáticos rápidos y seguros +- Mantener el sitio con control de versiones + +## ¿Qué viene después? + +Estaremos publicando regularmente: + +- Tutoriales de Python +- Noticias de la comunidad +- Anuncios de eventos +- Proyectos destacados + +¡Mantente al pendiente! + +```python +print("¡Bienvenidos a PythonistaMX!") +``` \ No newline at end of file diff --git a/blog/posts/introduccion-python.qmd b/blog/posts/introduccion-python.qmd new file mode 100644 index 0000000..7932b07 --- /dev/null +++ b/blog/posts/introduccion-python.qmd @@ -0,0 +1,67 @@ +--- +title: "Introducción a Python para Principiantes" +author: "PythonistaMX" +date: "2024-01-20" +categories: [python, tutorial, principiantes] +description: "Una guía básica para comenzar con Python desde cero" +--- + +# ¿Qué es Python? + +Python es un lenguaje de programación de alto nivel, interpretado y de propósito general. Es conocido por su sintaxis clara y legible, lo que lo convierte en una excelente opción para principiantes. + +## ¿Por qué elegir Python? + +- **Fácil de aprender**: Sintaxis simple y clara +- **Versátil**: Útil para web, análisis de datos, IA, automatización, etc. +- **Gran comunidad**: Amplio ecosistema de bibliotecas y frameworks +- **Multiplataforma**: Funciona en Windows, macOS y Linux + +## Tu primer programa en Python + +```python +# Este es un comentario +print("¡Hola, mundo!") + +# Variables +nombre = "PythonistaMX" +año = 2024 + +# Usando las variables +print(f"Bienvenido a {nombre} en el año {año}") +``` + +## Tipos de datos básicos + +Python maneja varios tipos de datos: + +```python +# Números +entero = 42 +flotante = 3.14 + +# Texto +texto = "¡Hola, Python!" + +# Listas +frutas = ["manzana", "banana", "naranja"] + +# Diccionarios +persona = { + "nombre": "Ana", + "edad": 25, + "ciudad": "Ciudad de México" +} + +# Booleanos +es_python_genial = True +``` + +## Próximos pasos + +1. Instala Python desde [python.org](https://python.org) +2. Prueba un editor como VS Code o PyCharm +3. Experimenta con los ejemplos de código +4. Únete a nuestra comunidad para hacer preguntas + +¡Bienvenido al mundo de Python! 🐍 \ No newline at end of file diff --git a/index.qmd b/index.qmd new file mode 100644 index 0000000..784bce4 --- /dev/null +++ b/index.qmd @@ -0,0 +1,37 @@ +--- +title: "Bienvenidos a PythonistaMX" +--- + +# Comunidad PythonistaMX + +¡Bienvenidos al sitio oficial de la comunidad PythonistaMX! + +## Acerca de nosotros + +PythonistaMX es una comunidad mexicana dedicada al desarrollo y promoción del lenguaje de programación Python. Nos enfocamos en: + +- Compartir conocimientos sobre Python +- Organizar eventos y talleres +- Fomentar el networking entre desarrolladores +- Promover las mejores prácticas de programación + +## ¿Qué encontrarás aquí? + +En este sitio podrás encontrar: + +- Artículos y tutoriales sobre Python +- Información sobre nuestros eventos +- Recursos de aprendizaje +- Enlaces a proyectos de la comunidad + +## Únete a la comunidad + +¿Te interesa formar parte de nuestra comunidad? ¡Perfecto! Puedes encontrarnos en: + +- **GitHub**: [github.com/PythonistaMX](https://github.com/PythonistaMX) +- **Twitter**: [@PythonistaMX](https://twitter.com/PythonistaMX) +- **Telegram**: Grupo de Telegram PythonistaMX + +--- + +*Sitio creado con [Quarto](https://quarto.org) - Un sistema de publicación científica y técnica de código abierto* \ No newline at end of file diff --git a/styles.css b/styles.css new file mode 100644 index 0000000..dd0336f --- /dev/null +++ b/styles.css @@ -0,0 +1,40 @@ +/* Custom styles for PythonistaMX site */ + +:root { + --primary-color: #306998; + --secondary-color: #ffd43b; +} + +.navbar-brand { + font-weight: bold; +} + +.title-block-banner { + background: linear-gradient(135deg, var(--primary-color), var(--secondary-color)); + color: white; +} + +.quarto-title-banner { + background: linear-gradient(135deg, var(--primary-color), var(--secondary-color)); +} + +/* Code blocks styling */ +pre { + border-radius: 8px; +} + +/* Links styling */ +a { + color: var(--primary-color); +} + +a:hover { + color: var(--secondary-color); +} + +/* Footer styling */ +.footer { + margin-top: 2rem; + padding-top: 1rem; + border-top: 1px solid #dee2e6; +} \ No newline at end of file From 5781e2e497cdc1a6e8ba50358bb75deff4ae39b2 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 26 Sep 2025 22:49:57 +0000 Subject: [PATCH 3/3] Add GitHub Actions workflow and final project enhancements Co-authored-by: josechval <2932503+josechval@users.noreply.github.com> --- .github/workflows/publish.yml | 55 +++++++++++++++++++++++++++++++++++ LICENSE | 21 +++++++++++++ _quarto.yml | 16 ++++++++++ 3 files changed, 92 insertions(+) create mode 100644 .github/workflows/publish.yml create mode 100644 LICENSE diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml new file mode 100644 index 0000000..1f8cf1e --- /dev/null +++ b/.github/workflows/publish.yml @@ -0,0 +1,55 @@ +name: Build and Deploy Quarto Site + +on: + push: + branches: [ main ] + pull_request: + branches: [ main ] + workflow_dispatch: + +jobs: + build-deploy: + runs-on: ubuntu-latest + permissions: + contents: read + pages: write + id-token: write + + steps: + - name: Check out repository + uses: actions/checkout@v4 + + - name: Set up Quarto + uses: quarto-dev/quarto-actions/setup@v2 + + - name: Install Python dependencies (if any) + run: | + if [ -f requirements.txt ]; then + python -m pip install --upgrade pip + pip install -r requirements.txt + fi + + - name: Render Quarto Project + uses: quarto-dev/quarto-actions/render@v2 + + - name: Setup Pages + if: github.ref == 'refs/heads/main' + uses: actions/configure-pages@v4 + + - name: Upload to GitHub Pages + if: github.ref == 'refs/heads/main' + uses: actions/upload-pages-artifact@v3 + with: + path: ./_site + + deploy: + if: github.ref == 'refs/heads/main' + needs: build-deploy + runs-on: ubuntu-latest + environment: + name: github-pages + url: ${{ steps.deployment.outputs.page_url }} + steps: + - name: Deploy to GitHub Pages + id: deployment + uses: actions/deploy-pages@v4 \ No newline at end of file diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..612b0f8 --- /dev/null +++ b/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2024 PythonistaMX + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. \ No newline at end of file diff --git a/_quarto.yml b/_quarto.yml index a24b31d..ddf48ae 100644 --- a/_quarto.yml +++ b/_quarto.yml @@ -4,8 +4,11 @@ project: website: title: "PythonistaMX" description: "Sitio de la comunidad PythonistaMX" + site-url: "https://pythonistamx.github.io/sitio-quarto" + repo-url: "https://github.com/PythonistaMX/sitio-quarto" navbar: + title: "PythonistaMX" left: - href: index.qmd text: Inicio @@ -13,6 +16,10 @@ website: text: Acerca de - href: blog/index.qmd text: Blog + right: + - icon: github + href: https://github.com/PythonistaMX + aria-label: GitHub sidebar: - title: "Navegación" @@ -22,11 +29,20 @@ website: - href: about.qmd text: Acerca de + page-footer: + left: "© 2024 PythonistaMX. Contenido bajo licencia MIT." + right: + - icon: github + href: https://github.com/PythonistaMX + aria-label: GitHub + format: html: theme: cosmo css: styles.css toc: true + date-format: "DD MMMM YYYY" + lang: es execute: freeze: auto \ No newline at end of file