doris-website

Ce dépôt contient le code source du site officiel d'Apache Doris, hébergé à doris.apache.org. Il est construit avec Docusaurus 3, un générateur de site statique moderne. ## Ce qu'il contient - **Documentation** : documentation en anglais et chinois (zh-CN) pour plusieurs versions (current/dev, 4.x, 3.x, 2.1) - **Blog** : actualités et annonces du projet - **Communauté** : directives de contribution et ressources communautaires - **Composants React** : pages personnalisées et éléments d'interface dans le répertoire `src/` ## Pile technologique - Docusaurus 3 (générateur de site statique) - Node.js >= 18 - Gestionnaire de paquets Yarn - Composants basés sur React ## Développement local Un script d'assistance (`local_dev.sh`) simplifie l'exécution du site en local : # Démarrer le serveur de développement anglais ./local_dev.sh # Démarrer le serveur de développement chinois ./local_dev.sh start-zh # Port personnalisé ./local_dev.sh start --port 8080 # Build de production (anglais + chinois) ./local_dev.sh build-all La mémoire peut être augmentée via `NODE_OPTIONS=--max-old-space-size=8192` pour les gros builds. ## Gestion des versions La documentation est versionnée avec des répertoires distincts pour chaque ligne de version sous `docs/` (actuel) et `versioned_docs/` (versions archivées). Les sidebars sont gérés séparément par version dans `sidebars.ts` et `versioned_sidebars/`. ## Support multilingue Le site prend en charge l'anglais et le chinois simplifié. Les traductions chinoises se trouvent sous `i18n/zh-CN/`. Lors de l'édition, les deux versions linguistiques nécessitent généralement une mise à jour. ## Structure des répertoires - `docs/` — documentation anglaise actuelle - `versioned_docs/` — documentation anglaise archivée par version - `i18n/zh-CN/` — traductions chinoises correspondant à la structure ci-dessus - `blog/` — articles de blog au format Markdown - `community/` — documentation communautaire - `src/` — composants React et pages personnalisées - `static/` — ressources statiques (images, CSS, JS) ## CI / Déploiement GitHub Actions gère les builds automatisés : - Déploiement quotidien via cron synchronisé depuis la branche master de Doris - Workflow de déploiement manuel pour des branches spécifiques - Validation des builds sur les demandes de tirage ## Contribution Les directives de contribution sont disponibles sur le site web de Doris, couvrant les spécifications de format de documentation et le processus général de contribution.