Skip to content

Commit 1bce5e7

Browse files
committed
docs: migrate Git Pages from Jekyll to Nextra
- Replace Jekyll custom theme with Nextra (Next.js docs framework) - Add Tailwind CSS with WebRTC brand colors (Go Blue, Success Green) - Create React components: Hero, FeatureCard, LanguageToggle - Migrate all documentation to MDX format - Support bilingual docs via file-based routing (pages/en/, pages/zh/) - Update GitHub Actions workflow for Node.js/Nextra build - Remove old Jekyll files (_layouts/, _includes/, _config.yml, etc.)
1 parent 53b3ff4 commit 1bce5e7

49 files changed

Lines changed: 7826 additions & 3106 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.github/workflows/pages.yml

Lines changed: 20 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -4,19 +4,8 @@ on:
44
push:
55
branches: [main, master]
66
paths:
7-
- '404.md'
8-
- 'CHANGELOG.md'
9-
- 'CONTRIBUTING.md'
10-
- 'ROADMAP.md'
11-
- 'index.md'
12-
- 'index.zh-CN.md'
13-
- 'assets/**'
14-
- '_config.yml'
15-
- '_layouts/**'
16-
- '_includes/**'
17-
- 'docs/**'
18-
- 'openspec/specs/**'
19-
- 'changelog/**'
7+
- 'docs/website/**'
8+
- '.github/workflows/pages.yml'
209
workflow_dispatch:
2110

2211
permissions:
@@ -31,33 +20,38 @@ concurrency:
3120
jobs:
3221
build:
3322
runs-on: ubuntu-latest
23+
defaults:
24+
run:
25+
working-directory: docs/website
3426
steps:
3527
- name: Checkout
3628
uses: actions/checkout@v6
3729
with:
3830
fetch-depth: 1
3931

40-
- name: Setup Pages
41-
uses: actions/configure-pages@v6
32+
- name: Setup Node.js
33+
uses: actions/setup-node@v4
4234
with:
43-
enablement: true
35+
node-version: '20'
36+
cache: 'npm'
37+
cache-dependency-path: docs/website/package-lock.json
4438

45-
- name: Build with Jekyll
46-
uses: actions/jekyll-build-pages@v1
47-
with:
48-
source: ./
49-
destination: ./_site
50-
future: false
51-
unpublished: false
39+
- name: Install dependencies
40+
run: npm ci
41+
42+
- name: Build with Nextra
43+
run: npm run build
5244

5345
- name: Verify build
5446
run: |
55-
test -f ./_site/index.html
56-
test -f ./_site/docs/index.html
57-
test -f ./_site/assets/css/style.css
47+
test -f ../.site/index.html
48+
test -f ../.site/en/index.html
49+
test -f ../.site/zh/index.html
5850
5951
- name: Upload artifact
6052
uses: actions/upload-pages-artifact@v5
53+
with:
54+
path: docs/.site
6155

6256
deploy:
6357
environment:

.gitignore

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,12 @@ _site/
4949
.jekyll-cache/
5050
.jekyll-metadata
5151

52+
# Nextra / Next.js
53+
docs/website/.next/
54+
docs/website/node_modules/
55+
docs/.site/
56+
.next/
57+
5258
# Environment & secrets
5359
.env
5460
.env.*

404.md

Lines changed: 0 additions & 43 deletions
This file was deleted.

_config.yml

Lines changed: 0 additions & 90 deletions
This file was deleted.

_includes/head-custom.html

Lines changed: 0 additions & 80 deletions
This file was deleted.

0 commit comments

Comments
 (0)