Documentation Deployment¶
This guide covers how to build and deploy the ToolUniverse documentation.
Local Development¶
Build documentation locally:
cd docs/
./quick_doc_build.sh
Start local server:
make serve
# or
make livehtml
Access documentation at: http://localhost:8000
GitHub Pages (Automatic)¶
The documentation is automatically deployed to GitHub Pages when you push to the main branch.
Setup: 1. Enable GitHub Pages in repository settings (Settings > Pages > Source: GitHub Actions) 2. Push changes to main branch 3. Documentation builds automatically
Available Make Commands¶
make clean # Clean build files
make html # Build HTML documentation
make serve # Start local server
make livehtml # Auto-rebuild on changes
make clean-html # Clean only HTML files