feat(i18n): add blog translations for 7 new locales

Add translated blog content for Spanish (es-ES), French (fr-FR), Japanese (ja-JP), Korean (ko-KR), Portuguese Brazil (pt-BR), Russian (ru-RU), and Traditional Chinese (zh-Hant) locales covering all existing blog posts. This expands the documentation's international reach to support these seven new language variants.

Co-Authored-By: Hagicode <noreply@hagicode.com>
Signed-off-by: newbe36524 <newbe36524@qq.com>

Author: newbe36524

src/content/docs/es-ES/blog/2026-01-22-github-issues-集成.mdx

@@ -0,0 +1,206 @@
+---
+title: "Práctica de HagiCode: Cómo usar GitHub Actions para implementar el despliegue automático de Docusaurus"
+date: 2026-01-26
+truncate: true
+englishSlug: "docusaurus-auto-deployment-with-github-actions"
+tags: [Docusaurus, GitHub Actions, GitHub Pages, Despliegue automático, CI/CD]
+description: "Este proyecto tenía el nombre en clave PCode, ahora se ha renombrado oficialmente a HagiCode. Este artículo registra cómo introducir la capacidad de despliegue automatizado de sitios estáticos para el proyecto, haciendo que la publicación de contenido sea tan simple como beber agua."
+---
+
+## Añadir soporte de despliegue automático a GitHub Pages para HagiCode
+
+> Este proyecto tenía el nombre en clave PCode, ahora se ha renombrado oficialmente a HagiCode. Este artículo registra cómo introducir la capacidad de despliegue automatizado de sitios estáticos para el proyecto, haciendo que la publicación de contenido sea tan simple como beber agua.
+
+## Antecedentes/Introducción
+
+Durante el desarrollo de HagiCode, nos encontramos con un problema muy real: a medida que los documentos y propuestas aumentaban, cómo gestionar y mostrar estos contenidos de manera eficiente se convirtió en una tarea urgente. Decidimos introducir GitHub Pages para alojar nuestro sitio estático, pero la construcción y el despliegue manual eran demasiado problemáticos: cada cambio requería construir y empaquetar localmente, y luego enviar manualmente a la rama `gh-pages`. Esto no solo era ineficiente, sino que también propenso a errores.
+
+Para resolver este problema (principalmente por pereza), necesitábamos un flujo de despliegue automatizado. Este artículo registrará en detalle cómo añadir soporte de despliegue automático con GitHub Actions para el proyecto HagiCode, permitiéndonos centrarnos solo en la creación de contenido y dejar el resto al proceso automatizado.
+
+## Sobre HagiCode
+
+> Oye, permíteme presentarte lo que estamos construyendo
+
+Estamos desarrollando **HagiCode**——un asistente de código inteligente impulsado por IA que hace que la experiencia de desarrollo sea más inteligente, más conveniente y más divertida.
+
+**Inteligente**——asistencia de IA durante todo el proceso, desde la idea hasta el código, multiplicando la eficiencia de codificación varias veces. **Conveniente**——operaciones concurrentes multiproceso, aprovechando al máximo los recursos, haciendo que el flujo de desarrollo sea fluido sin obstáculos. **Divertido**——mecanismo de gamificación y sistema de logros, haciendo que la codificación ya no sea aburrida y llena de sentido de logro.
+
+El proyecto está iterando rápidamente. Si te interesa la redacción técnica, la gestión del conocimiento o el desarrollo asistido por IA, bienvenido a visitar [GitHub](https://github.com/HagiCode-org/site) para echar un vistazo～
+
+## Análisis de objetivos
+
+Antes de empezar a trabajar, primero debemos aclarar qué tiene que hacer esta tarea. Después de todo, afilar el hacha no le quita tiempo al leñador.
+
+### Requisitos centrales
+
+1.  **Construcción automatizada**：Cuando el código se envía a la rama `main`, se activa automáticamente el proceso de construcción.
+2.  **Despliegue automático**：Después de que la construcción sea exitosa, los archivos estáticos generados se despliegan automáticamente en GitHub Pages.
+3.  **Consistencia del entorno**：Asegurar que el entorno de CI y el entorno de construcción local sean consistentes, evitando la vergüenza de "funciona localmente, pero falla en línea".
+
+### Selección técnica
+
+Considerando que HagiCode está construido con Docusaurus (un generador de sitios estáticos de React muy popular), podemos usar GitHub Actions para lograr este objetivo.
+
+## Configurar el flujo de trabajo de GitHub Actions
+
+GitHub Actions es el servicio CI/CD proporcionado por GitHub. Al definir archivos de flujo de trabajo en formato YAML en el repositorio de código, podemos personalizar varias tareas automatizadas.
+
+### Crear archivo de flujo de trabajo
+
+Necesitamos crear un nuevo archivo de configuración en la carpeta `.github/workflows` en el directorio raíz del proyecto, por ejemplo llamado `deploy.yml`. Si la carpeta no existe, recuerda crearla manualmente primero.
+
+La lógica central de este archivo de configuración es la siguiente:
+
+1.  **Condición de activación**：escuchar eventos `push` de la rama `main`.
+2.  **Entorno de ejecución**：la última versión de Ubuntu.
+3.  **Pasos de construcción**：
+    -   Obtener el código
+    -   Instalar Node.js
+    -   Instalar dependencias (`npm install`)
+    -   Construir archivos estáticos (`npm run build`)
+4.  **Pasos de despliegue**：usar `action-gh-pages` oficial para enviar los productos de construcción a la rama `gh-pages`.
+
+### Código de configuración clave
+
+A continuación se muestra la plantilla de configuración que finalmente adoptamos:
+
+```yaml
+name: Deploy to GitHub Pages
+
+# Condición de activación: cuando se envía a la rama main
+on:
+  push:
+    branches:
+      - main
+    # Se pueden agregar filtros de ruta según sea necesario, por ejemplo, construir solo cuando cambien los documentos
+    # paths:
+    #   - 'docs/**'
+    #   - 'package.json'
+
+# Configurar permisos, esto es importante para desplegar en GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Control de concurrencia: cancelar construcciones antiguas de la misma rama
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        # Nota: se debe configurar fetch-depth: 0, de lo contrario puede causar que el número de versión de construcción sea inexacto
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20 # Se recomienda mantenerlo consistente con el entorno de desarrollo local
+          cache: 'npm'     # Habilitar el caché puede acelerar el proceso de construcción
+
+      - name: Install dependencies
+        run: npm ci
+        # Usar npm ci en lugar de npm install, porque es más rápido y más estricto, adecuado para entornos CI
+
+      - name: Build website
+        run: npm run build
+        env:
+          # Si la construcción de tu sitio requiere variables de entorno, configúralas aquí
+          # NODE_ENV: production
+          # PUBLIC_URL: /your-repo-name
+          
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./build # Directorio de salida predeterminado de Docusaurus
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
+```
+
+## Problemas encontrados durante la implementación
+
+En la práctica real, nos encontramos con algunos problemas. Aquí los compartimos con la esperanza de que puedan evitarlos (o prepararse con anticipación para las soluciones).
+
+### 1. Problema de permisos de GitHub Token
+
+Al principio de la configuración, el despliegue siempre reportaba error 403 (Forbidden). Después de buscar mucho, descubrimos que el `GITHUB_TOKEN` predeterminado de GitHub no tenía permiso de escritura en Pages.
+
+**Solución**：en `Settings` -> `Actions` -> `General` -> `Workflow permissions` del repositorio, asegúrate de elegir **"Read and write permissions"**.
+
+### 2. Ruta incorrecta del directorio de construcción
+
+Docusaurus coloca los archivos estáticos construidos en el directorio `build` de manera predeterminada. Pero algunos proyectos (por ejemplo, Create React App predeterminado es `build`, Vite predeterminado es `dist`) pueden tener configuraciones diferentes. Si se reporta un error en Actions de que no se encuentran los archivos, recuerda verificar la configuración de la ruta de salida en `docusaurus.config.js`.
+
+### 3. Problema de subruta
+
+Si tu repositorio no es una página de usuario (es decir, no es `username.github.io`), sino una página de proyecto (por ejemplo, `username.github.io/project-name`), necesitas configurar `baseUrl`.
+
+En `docusaurus.config.js`:
+
+```javascript
+module.exports = {
+  // ...
+  url: 'https://hagicode.com', // Tu URL de Hagicode
+  baseUrl: '/', // Despliegue en ruta raíz
+  // ...
+};
+```
+Este punto es fácil de ignorar, una configuración incorrecta hará que la página se abra en blanco, porque las rutas de los recursos no se pueden cargar.
+
+## Verificar los resultados
+
+Después de configurar todo y enviar el código, podemos ir a la pestaña **Actions** del repositorio de GitHub para ver el espectáculo.
+
+Verás círculos amarillos (el flujo de trabajo está ejecutándose), cuando se vuelva verde representa éxito. Si se vuelve rojo, haz clic para ver los registros, generalmente se puede identificar el problema (la mayoría de las veces es un error ortográfico o una configuración de ruta incorrecta).
+
+Después de una construcción exitosa, visita `https://<tu-usuario>.github.io/<nombre-repositorio>/` para ver el sitio nuevo.
+
+## Resumen
+
+Al introducir GitHub Actions, logramos con éxito el despliegue automatizado del sitio de documentación de HagiCode. Esto no solo ahorra tiempo de operación manual, sino lo más importante, garantiza la estandarización del proceso de publicación. Ahora, sin importar qué compañero actualice el documento, siempre que se fusione a la rama `main`, en unos pocos minutos se puede ver el último contenido en línea.
+
+**Beneficios clave**：
+- **Mejora de eficiencia**：de "empaquetado manual, carga manual" a "código es publicación".
+- **Reducción de errores**：elimina la posibilidad de errores de operación humana.
+- **Optimización de experiencia**：permite que los desarrolladores se concentren más en la calidad del contenido, en lugar de ser molestados por tediosos procesos de despliegue.
+
+Aunque configurar CI/CD puede ser un poco problemático al principio (especialmente varios problemas de permisos y rutas), es una inversión única con un retorno enorme a largo plazo. Se recomienda encarecidamente que todos los proyectos de sitios estáticos se integren en flujos automatizados similares.
+
+## Materiales de referencia
+
+- [Documentación oficial de GitHub Actions](https://docs.github.com/en/actions)
+- [Guía de despliegue de Docusaurus](https://docusaurus.io/docs/deployment)
+- [Instrucciones de uso de actions-gh-pages Action](https://github.com peaceiris/actions-gh-pages)
+
+
+
+---
+
+## Guía de interacción
+
+Gracias por leer. Si considera útil este artículo, haga clic en el botón de Me gusta a continuación 👍 para que más personas puedan ver este artículo.
+
+## Declaración de asistencia con IA
+
+Este contenido fue elaborado con asistencia de inteligencia artificial, revisado por mí, y se ajusta a mis puntos de vista y posición.
+
+## Metainformación
+
+- **Autor del artículo:** [newbe36524](https://www.newbe.pro)
+- **Enlace del artículo:** [https://hagicode.com/blog/2026/01/25/docusaurus-auto-deployment-with-github-actions](https://hagicode.com/blog/2026/01/25/docusaurus-auto-deployment-with-github-actions)
+- **Aviso de derechos de autor:** Todos los artículos de este blog, excepto los declarados específicamente, están bajo la licencia BY-NC-SA. Por favor, cite la fuente al reimpresión!