Docs Site Deployment
The documentation site is deployed on Cloudflare Pages via Git integration from the global axelites/menzzo-docs repository.
Cloudflare Pages configuration
| Parameter | Value |
|---|---|
| Source directory | repository root |
| Build command | npm run build |
| Output directory | build |
| Production branch | main |
| URL | https://menzzo-docs.pages.dev |
Local development
cd docs
# Install dependencies
npm ci
# Start the development server (hot reload)
npm start
# Production build
npm run build
# Preview the build
npm run serve
Deployment process
- Push to
main— automatic production deployment - Push to a feature branch — preview deployment with a temporary URL
- Rollback — via the Cloudflare Pages dashboard, revert to a previous deployment
Manual deployment (fallback)
cd docs
npm run build
# The contents of build/ can be served by any static host
Configuration files
| File | Purpose |
|---|---|
static/_headers | Cloudflare cache policy |
static/_redirects | Legacy MkDocs URL redirects |
docusaurus.config.ts | Site configuration |
sidebars.ts | Sidebar navigation structure |
Migration from MkDocs
The old MkDocs site used Python/Material theme. The new Docusaurus site uses Node/React. Changes:
| Aspect | Old (MkDocs) | New (Docusaurus) |
|---|---|---|
| Language | Python | Node.js |
| Build | mkdocs build | npm run build |
| Config | mkdocs.yml | docusaurus.config.ts |
| Theme | Material | Docusaurus Classic |
| Search | Built-in | @easyops-cn/docusaurus-search-local |
| Diagrams | pymdownx.superfences | @docusaurus/theme-mermaid |
Legacy URLs
The following redirects are configured in static/_redirects to preserve MkDocs URLs:
| Old URL | New URL |
|---|---|
/operations/sales-import-workflow/ | /docs/projects/logidav/workflows/sales-import |
/cronjobs/ | /docs/projects/logidav/reference/cronjobs/ |
/integrations/ | /docs/projects/logidav/integrations/ |
/development/ | /docs/projects/logidav/getting-started/ |