Create complete Quarto project structure for PythonistaMX community website

.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

.gitignore

@@ -205,3 +205,9 @@ cython_debug/
 marimo/_static/
 marimo/_lsp/
 __marimo__/
+
+# Quarto
+/.quarto/
+/_site/
+/.vscode/
+.DS_Store

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.

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/)

_quarto.yml

@@ -0,0 +1,48 @@
+project:
+  type: website
+
+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
+      - href: about.qmd
+        text: Acerca de
+      - href: blog/index.qmd
+        text: Blog
+    right:
+      - icon: github
+        href: https://github.com/PythonistaMX
+        aria-label: GitHub
+
+  sidebar:
+    - title: "Navegación"
+      contents:
+        - href: index.qmd
+          text: Inicio
+        - 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

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)

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.

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!")
+```

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! 🐍