Sobre o projeto

Este repositório contém o código-fonte do site oficial do Apache Doris, hospedado em doris.apache.org. Ele é construído usando o Docusaurus 3, um gerador de site estático moderno. ## O Que Contém - **Documentação**: docs em inglês e chinês (zh-CN) em várias versões (current/dev, 4.x, 3.x, 2.1) - **Blog**: Notícias e anúncios do projeto - **Community**: Diretrizes de contribuição e recursos da comunidade - **Componentes React**: Páginas personalizadas e elementos de UI no diretório `src/` ## Pilha de Tecnologia - Docusaurus 3 (gerador de site estático) - Node.js >= 18 - Gerenciador de pacotes Yarn - Componentes baseados em React ## Desenvolvimento Local Um script auxiliar (`local_dev.sh`) simplifica a execução do site localmente: # Start English dev server ./local_dev.sh # Start Chinese dev server ./local_dev.sh start-zh # Custom port ./local_dev.sh start --port 8080 # Production build (English + Chinese) ./local_dev.sh build-all A memória pode ser aumentada via `NODE_OPTIONS=--max-old-space-size=8192` para builds grandes. ## Versionamento A documentação é versionada com diretórios separados para cada linha de lançamento sob `docs/` (atual) e `versioned_docs/` (versões arquivadas). Os sidebars são gerenciados separadamente por versão em `sidebars.ts` e `versioned_sidebars/`. ## Suporte Multilíngue O site suporta inglês e chinês simplificado. As traduções chinesas ficam em `i18n/zh-CN/`. Ao editar, normalmente ambas as versões de idioma precisam ser atualizadas. ## Estrutura de Diretórios - `docs/` — docs em inglês atuais - `versioned_docs/` — docs em inglês arquivados por versão - `i18n/zh-CN/` — traduções chinesas que correspondem à estrutura acima - `blog/` — posts de blog em Markdown - `community/` — documentação da comunidade - `src/` — componentes React e páginas personalizadas - `static/` — assets estáticos (imagens, CSS, JS) ## CI / Implantação O GitHub Actions lida com builds automatizados: - Implantação diária via cron sincronizando a partir da branch master do Doris - Fluxo de implantação manual para branches específicas - Validação de build em pull requests ## Contribuindo As diretrizes de contribuição estão disponíveis no site do Doris, abrangendo especificações de formato de documentação e processos gerais de contribuição.