Recuperar configuración de workflows y herramientas de desarrollo

- Agregar build.yml y ci-cd.yml workflows
- Actualizar deploy.yml workflow
- Configurar pre-commit hooks
- Agregar requirements-dev.txt
- Mejorar scripts de check_links y generate_meetups
- Actualizar configuración markdownlint

Author: pixelead0

.github/workflows/build.yml

@@ -0,0 +1,62 @@
+name: Build and Validate
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  build-and-validate:
+    name: Build and Validate Documentation
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.10'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+
+      - name: Run pre-commit checks
+        uses: pre-commit/[email protected]
+
+      - name: Build with MkDocs
+        run: mkdocs build
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Check for broken links
+        run: |
+          cd site && python -m http.server 8000 &
+          sleep 10
+
+          cd .. && python scripts/check_links.py
+
+          broken_count=$(jq '.summary.broken_links' broken_links.json)
+
+          if [ "$broken_count" -gt 0 ]; then
+            echo "❌ Found $broken_count broken links - failing!"
+            pkill -f "python -m http.server" || true
+            exit 1
+          fi
+
+          echo "✅ All links working!"
+          pkill -f "python -m http.server" || true
+
+      # Solo para main: guardar el sitio construido
+      - name: Upload build artifact
+        if: github.ref == 'refs/heads/main'
+        uses: actions/upload-artifact@v3
+        with:
+          name: site
+          path: site/
+          retention-days: 1

.github/workflows/ci-cd.yml

@@ -0,0 +1,30 @@
+name: CI/CD Pipeline
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  build-and-validate:
+    name: Build and Validate
+    runs-on: ubuntu-latest
+    steps:
+      # ... todos los pasos de validación y build ...
+
+  deploy:
+    name: Deploy to GitHub Pages
+    if: github.ref == 'refs/heads/main'
+    needs: build-and-validate
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      # ... pasos de deploy ...

.github/workflows/deploy.yml

@@ -1,9 +1,10 @@
 name: Deploy to GitHub Pages
 
 on:
-  push:
-    branches: [ main ]
-  pull_request:
+  workflow_run:
+    workflows: ["Build and Validate"]
+    types:
+      - completed
     branches: [ main ]
 
 permissions:
@@ -16,45 +17,30 @@ concurrency:
   cancel-in-progress: false
 
 jobs:
-  build:
+  deploy:
+    name: Deploy to GitHub Pages
+    if: github.event.workflow_run.conclusion == 'success'
     runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
     steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Set up Python
-        uses: actions/setup-python@v4
+      - name: Download build artifact
+        uses: actions/download-artifact@v3
         with:
-          python-version: '3.10'
-
-      - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install -r requirements.txt
-
-      - name: Build with MkDocs
-        run: mkdocs build
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          name: site
+          path: site/
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          run-id: ${{ github.event.workflow_run.id }}
 
       - name: Setup Pages
         uses: actions/configure-pages@v4
 
-      - name: Upload artifact
+      - name: Upload to GitHub Pages
         uses: actions/upload-pages-artifact@v3
         with:
-          path: './site'
+          path: site/
 
-  deploy:
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    runs-on: ubuntu-latest
-    needs: build
-    if: github.ref == 'refs/heads/main'
-    steps:
       - name: Deploy to GitHub Pages
         id: deployment
         uses: actions/deploy-pages@v4

.markdownlint.json

@@ -1,7 +1,21 @@
 {
+  "MD001": true,
+  "MD003": { "style": "atx" },
+  "MD004": { "style": "dash" },
+  "MD007": { "indent": 2 },
+  "MD010": { "spaces_per_tab": 2 },
+  "MD012": false,
+  "MD013": { "line_length": 120 },
+  "MD022": false,
+  "MD025": true,
+  "MD026": { "punctuation": ".,;:!?" },
+  "MD029": { "style": "ordered" },
+  "MD030": { "ul_single": 1, "ul_multi": 1, "ol_single": 1, "ol_multi": 1 },
+  "MD031": false,
+  "MD032": false,
   "MD033": false,
+  "MD034": false,
+  "MD036": false,
   "MD041": false,
-  "MD013": false,
-  "MD025": false,
-  "MD026": false
+  "MD051": false
 }

.pre-commit-config.yaml

@@ -0,0 +1,28 @@
+repos:
+  # Hooks básicos
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+        exclude: ^mkdocs\.yml$  # Excluir mkdocs.yml
+      - id: check-json
+      - id: check-added-large-files
+      - id: check-merge-conflict
+      # - id: requirements-txt-fixer  # Comentado si no lo quieres
+
+  # Validación de Markdown - MENOS ESTRICTO para empezar
+  - repo: https://github.com/igorshubovych/markdownlint-cli
+    rev: v0.39.0
+    hooks:
+      - id: markdownlint
+        args: ['--config', '.markdownlint.json', '--disable', 'MD012', 'MD022', 'MD032']
+        files: ^docs/.*\.md$
+
+  # Formateo de Python (opcional, pero útil para scripts)
+  - repo: https://github.com/psf/black
+    rev: 23.12.1
+    hooks:
+      - id: black
+        files: ^scripts/.*\.py$

requirements-dev.txt

@@ -0,0 +1,12 @@
+
+# Herramientas de desarrollo (opcional)
+black>=23.0.0
+
+# Herramientas opcionales de desarrollo
+flake8>=6.0.0
+# Pre-commit para validaciones locales
+pre-commit>=3.6.0
+pytest>=7.0.0
+
+# Dependencias para validación de links
+requests>=2.25.0

scripts/check_links.py

@@ -5,6 +5,7 @@
 
 import json
 import re
+import sys
 from pathlib import Path
 from urllib.parse import urljoin
 
@@ -191,6 +192,17 @@ def main():
             print(f"   Status: {link['status']}")
             print()
 
+    # Return number of broken links
+    return len(broken_links)
+
 
 if __name__ == "__main__":
-    main()
+    broken_count = main()
+
+    # Exit with error if there are broken links
+    if broken_count > 0:
+        print(f"\n💥 Script failing due to {broken_count} broken links!")
+        sys.exit(1)
+    else:
+        print("\n✅ Script completed successfully - all links working!")
+        sys.exit(0)

scripts/generate_meetups.py

@@ -40,14 +40,11 @@ def create_meetup_file(json_file):
         "event_location": data["event_location"],
         "event_rsvp_link": data.get("event_rsvp_link", "#"),
         "event_banner_image": data.get(
-            "event_banner_image",
-            "/assets/images/default-banner.jpg"
+            "event_banner_image", "/assets/images/default-banner.jpg"
         ),
         "event_month_year": data.get("event_month_year", ""),
         "tags": data["tags"],
-        "last_update": data.get(
-            "last_update", "Generado automáticamente"
-        ),
+        "last_update": data.get("last_update", "Generado automáticamente"),
     }
 
     # Agregar datos específicos según el tipo de template