프로젝트 소개
이 저장소에는 doris.apache.org에서 호스팅되는 Apache Doris 공식 웹사이트의 소스 코드가 포함되어 있습니다. 이는 최신 정적 사이트 생성기인 Docusaurus 3로 구축되었습니다.
포함 내용
- 문서: 여러 버전(current/dev, 4.x, 3.x, 2.1)의 영어 및 중국어(zh-CN) 문서
- 블로그: 프로젝트 뉴스 및 공지
- 커뮤니티: 기여 가이드 및 커뮤니티 리소스
- React 컴포넌트: src/ 디렉터리의 맞춤 페이지 및 UI 요소
기술 스택
- Docusaurus 3 (정적 사이트 생성기)
- Node.js 18 이상
- Yarn 패키지 관리자
- React 기반 컴포넌트
로컬 개발
`local_dev.sh` 헬퍼 스크립트가 로컬에서 사이트 실행을 간소화합니다:
# 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
대규모 빌드의 경우 `NODE_OPTIONS=--max-old-space-size=8192` 로 메모리를 늘릴 수 있습니다.
버전 관리
문서는 `docs/`(현재)와 `versioned_docs/`(아카이브 버전)에 각 릴리즈 라인별로 별도 디렉터리를 두어 버전 관리됩니다. 사이드바는 `sidebars.ts`와 `versioned_sidebars/`에 버전별로 별도로 관리됩니다.
다국어 지원
사이트는 영어와 간체 중국어를 지원합니다. 중국어 번역은 `i18n/zh-CN/`에 위치합니다. 편집 시 일반적으로 두 언어 버전 모두 업데이트가 필요합니다.
디렉터리 구조
- `docs/` — 현재 영어 문서
- `versioned_docs/` — 버전별 아카이브 영어 문서
- `i18n/zh-CN/` — 위의 구조와 일치하는 중국어 번역
- `blog/` — 마크다운 블로그 글
- `community/` — 커뮤니티 문서
- `src/` — React 컴포넌트 및 맞춤 페이지
- `static/` — 정적 자산(이미지, CSS, JS)
CI / 배포
GitHub Actions가 자동 빌드를 처리합니다:
- Doris master 브랜치와 동기화되는 일일 크론 배포
- 특정 브랜치를 위한 수동 배포 워크플로
- 풀 리퀘스트에서의 빌드 검증
기여
Doris 웹사이트에서 기여 가이드를 확인할 수 있으며, 문서 형식 사양 및 일반적인 기여 프로세스를 다룹니다.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.