Sobre el proyecto

Este repositorio contiene el código fuente del sitio web oficial de Apache Doris, alojado en doris.apache.org. Está construido con Docusaurus 3, un generador de sitios estáticos moderno. Qué contiene - Documentación: documentos en inglés y chino simplificado (zh-CN) para varias versiones (current/dev, 4.x, 3.x, 2.1). - Blog: noticias del proyecto y anuncios. - Comunidad: guías de contribución y recursos comunitarios. - Componentes React: páginas personalizadas y elementos UI en el directorio src/. Pila tecnológica - Docusaurus 3 (generador de sitios estáticos) - Node.js >= 18 - Yarn como gestor de paquetes - Componentes basados en React Desarrollo local Un script de ayuda (local_dev.sh) simplifica la ejecución del sitio localmente: # Iniciar servidor de desarrollo en inglés ./local_dev.sh # Iniciar servidor de desarrollo en chino ./local_dev.sh start-zh # Puerto personalizado ./local_dev.sh start --port 8080 # Compilación de producción (inglés + chino) ./local_dev.sh build-all La memoria puede aumentarse mediante NODE_OPTIONS=--max-old-space-size=8192 para compilaciones grandes. Versionado Los documentos están versionados con directorios separados para cada línea de lanzamiento bajo docs/ (actual) y versioned_docs/ (versiones archivadas). Las barras laterales se gestionan por separado por versión en sidebars.ts y versioned_sidebars/. Soporte multilingüe El sitio soporta inglés y chino simplificado. Las traducciones al chino se encuentran en i18n/zh-CN/. Al editar, normalmente es necesario actualizar ambas versiones de idioma. Estructura de directorios - docs/ — documentos actuales en inglés - versioned_docs/ — documentos archivados en inglés por versión - i18n/zh-CN/ — traducciones al chino que coinciden con la estructura anterior - blog/ — publicaciones del blog en Markdown - community/ — documentación de la comunidad - src/ — componentes React y páginas personalizadas - static/ — recursos estáticos (imágenes, CSS, JS) CI / Despliegue GitHub Actions maneja compilaciones automáticas: - Despliegue cron diario que sincroniza desde la rama master de Doris - Flujo de trabajo de despliegue manual para ramas específicas - Validación de compilación en pull requests Contribuciones Las guías de contribución están disponibles en el sitio web de Doris, cubriendo especificaciones de formato de documentación y procesos generales de contribución.