feat: add cf

Signed-off-by: Ashing Zheng <axingfly@gmail.com>

Author: ronething

.github/workflows/deploy-cloudflare.yml

@@ -0,0 +1,62 @@
+name: Deploy to Cloudflare Pages
+
+on:
+  push:
+    branches:
+      - main
+      - master
+  pull_request:
+    branches:
+      - main
+      - master
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    name: Deploy to Cloudflare Pages
+
+    permissions:
+      contents: read
+      deployments: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: 'stable'
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+
+      - name: Cache Go modules
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cache/go-build
+            ~/go/pkg/mod
+          key: ${{ runner.os }}-go-${{ hashFiles('**/go.sum') }}
+          restore-keys: |
+            ${{ runner.os }}-go-
+
+      - name: Install Wrangler
+        run: npm install -g wrangler
+
+      - name: Build project
+        run: |
+          chmod +x ./book/install-and-build.sh
+          ./book/install-and-build.sh build
+
+      - name: Deploy to Cloudflare Pages
+        uses: cloudflare/pages-action@v1
+        with:
+          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+          projectName: kubebuilder-zh-docs
+          directory: book/book
+          # Optional: Use a custom domain
+          # wranglerVersion: '3'

.gitignore

@@ -28,6 +28,8 @@ src/docs
 /testdata/**/go.sum
 book/src/simple-external-plugin-tutorial/testdata/sampleexternalplugin/v1/bin
 /testdata/**legacy**
+book/functions/litgo
+book/functions/markerdocs
 
 ## Skip testdata files that generate by tests using TestContext
 **/e2e-*/**

CLAUDE.md

@@ -0,0 +1,86 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is the Chinese translation repository for the Kubebuilder documentation. It's built using mdBook and contains comprehensive documentation for the Kubebuilder project, including tutorials, reference materials, and migration guides.
+
+## Architecture
+
+- **mdBook Documentation**: Built using Rust's mdBook with custom preprocessors
+- **Custom Go Utilities**: Located in `book/utils/` for processing documentation
+- **Preprocessors**:
+  - `litgo.sh` - Processes Go code examples using literate-go utility
+  - `markerdocs.sh` - Generates marker documentation
+- **Content Structure**: Main content in `book/src/` with Chinese documentation
+- **Build Artifacts**: Generated site outputs to `book/` directory
+
+## Essential Commands
+
+### Building and Serving
+
+```bash
+# Build the documentation (includes downloading dependencies)
+./book/install-and-build.sh build
+
+# Serve locally for development (after mdBook is installed)
+cd book && mdbook serve
+# Then visit http://localhost:3000
+
+# Deploy to Cloudflare (requires environment variables)
+./deploy-cloudflare.sh
+```
+
+### Development
+
+```bash
+# Build Go utilities (preprocessors)
+cd book/utils
+go build -o ../../bin/literate-go ./litgo
+go build -o ../../bin/marker-docs ./markerdocs
+
+# Manual mdBook operations (after install-and-build.sh)
+cd book
+mdbook build  # Build only
+mdbook clean  # Clean build artifacts
+```
+
+## Key Dependencies
+
+- **Go 1.23+**: Required for building utilities and examples
+- **mdBook v0.4.40**: Rust-based documentation generator
+- **controller-gen v0.19.0**: Kubernetes code generation tool
+- **Node.js 18+**: For Cloudflare deployment via Wrangler
+
+## Build Process
+
+1. Downloads and installs mdBook binary for current platform
+2. Builds Go utilities in `book/utils/`
+3. Installs controller-gen tool
+4. Runs mdBook with custom preprocessors
+5. Outputs static site to `book/` directory
+
+## Deployment
+
+- **Cloudflare Pages**: Automated via GitHub Actions on push to main/master
+- **Environment Variables Required**:
+  - `CLOUDFLARE_API_TOKEN`
+  - `CLOUDFLARE_ACCOUNT_ID`
+- **Local Deploy**: Use `./deploy-cloudflare.sh` script
+
+## File Structure
+
+- `book/src/SUMMARY.md` - Table of contents for Chinese documentation
+- `book/book.toml` - mdBook configuration
+- `book/utils/` - Go utilities for documentation processing
+- `book/install-and-build.sh` - Main build script
+- `deploy-cloudflare.sh` - Cloudflare deployment script
+- `.github/workflows/` - CI/CD automation
+
+## Important Notes
+
+- This is a translation project - content follows the original Kubebuilder documentation structure
+- Custom preprocessors handle Go code examples and marker documentation
+- Build script handles cross-platform mdBook installation automatically
+- All scripts include proper error handling and platform detection

book/install-and-build.sh

@@ -28,7 +28,7 @@ if [[ -n "$(command -v gimme)" ]]; then
     eval "$(gimme $GO_VERSION)"
 fi
 echo go version
-GOBIN=$THIS_DIR/functions go install ./...
+(cd "$THIS_DIR/utils" && GOBIN=$THIS_DIR/functions go install ./...)
 
 os=$(go env GOOS)
 arch=$(go env GOARCH)
@@ -67,15 +67,15 @@ esac
 
 # grab mdbook
 # we hardcode linux/amd64 since rust uses a different naming scheme and it's a pain to tran
-# MDBOOK_VERSION="v0.4.40"
-# MDBOOK_BASENAME="mdBook-${MDBOOK_VERSION}-${arch}-${target}"
-# MDBOOK_URL="https://github.com/rust-lang/mdBook/releases/download/${MDBOOK_VERSION}/${MDBOOK_BASENAME}.${ext}"
+MDBOOK_VERSION="v0.4.40"
+MDBOOK_BASENAME="mdBook-${MDBOOK_VERSION}-${arch}-${target}"
+MDBOOK_URL="https://github.com/rust-lang/mdBook/releases/download/${MDBOOK_VERSION}/${MDBOOK_BASENAME}.${ext}"
 
-# echo "downloading ${MDBOOK_BASENAME}.${ext} from ${MDBOOK_URL}"
-# set -x
-# curl -fL -o /tmp/mdbook.${ext} "${MDBOOK_URL}"
-# ${cmd} /tmp/mdbook.${ext}
-# chmod +x /tmp/mdbook
+echo "downloading ${MDBOOK_BASENAME}.${ext} from ${MDBOOK_URL}"
+set -x
+curl -fL -o /tmp/mdbook.${ext} "${MDBOOK_URL}"
+${cmd} /tmp/mdbook.${ext}
+chmod +x /tmp/mdbook
 
 CONTROLLER_GEN_VERSION="v0.19.0"