docs: add deployment guide

Create deployment.md how-to page covering local preview,
GitHub Pages, Netlify, Cloudflare Pages, and generic static
hosts. Add cross-links from homepage and getting-started
Next Steps. Reference security.md for CSP headers.

docs/content/_index.md

@@ -22,6 +22,7 @@ Ready to try it? Start with the [Getting Started](getting-started.html) guide.
 ## Learn More
 
 - [Getting Started](getting-started.html) — install sukr and build your first site
+- [Deployment](deployment.html) — deploy your site to GitHub Pages, Netlify, or any static host
 - [Configuration](configuration.html) — `site.toml` reference and CLI options
 - [Content Organization](content-organization.html) — how directories map to site structure
 - [Architecture](architecture.html) — how sukr works under the hood

docs/content/deployment.md

@@ -0,0 +1,75 @@
+---
+title: Deployment
+description: Deploy your sukr site to any static hosting platform
+weight: 1
+---
+
+sukr builds your site to `public/`. This directory contains self-contained static HTML, CSS, and assets — no server-side runtime needed. Upload it anywhere that serves static files.
+
+## Local Preview
+
+Preview your site locally before deploying:
+
+```bash
+cd public
+python3 -m http.server 8000
+```
+
+Open `http://localhost:8000` in your browser.
+
+## GitHub Pages
+
+1. Push your repository to GitHub
+2. Build your site: `sukr`
+3. Deploy the `public/` directory using one of:
+   - **GitHub Actions** — add a workflow that runs `sukr` and deploys `public/` to Pages
+   - **Manual** — push the `public/` contents to a `gh-pages` branch
+
+Example workflow (`.github/workflows/deploy.yml`):
+
+```yaml
+name: Deploy
+on:
+  push:
+    branches: [main]
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - run: cargo install --path .
+      - run: sukr
+      - uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./public
+```
+
+## Netlify
+
+1. Connect your repository in the Netlify dashboard
+2. Set build command: `cargo install --path . && sukr`
+3. Set publish directory: `public`
+
+Netlify detects changes and rebuilds automatically on push.
+
+## Cloudflare Pages
+
+1. Connect your repository in the Cloudflare Pages dashboard
+2. Set build command: `cargo install --path . && sukr`
+3. Set build output directory: `public`
+
+## Any Static Host
+
+For any host that serves static files (S3, DigitalOcean Spaces, a VPS):
+
+```bash
+sukr
+rsync -avz public/ user@server:/var/www/mysite/
+```
+
+Or use `scp`, `aws s3 sync`, or your host's CLI tool.
+
+## Security Headers
+
+sukr outputs zero JavaScript, which means you can set a strict Content Security Policy that blocks all script execution. See [Security](security.html) for recommended CSP headers and platform-specific configuration.

docs/content/getting-started.md

@@ -120,6 +120,7 @@ Open `public/index.html` in your browser. You should see your "Hello, World!" pa
 
 ## Next Steps
 
+- [Deployment](deployment.html) — put your site on the web
 - [Configuration](configuration.html) — customize `site.toml` options (paths, navigation, base URL)
 - [Content Organization](content-organization.html) — learn how directories map to site sections
 - [Features](features/index.html) — syntax highlighting, math, diagrams, and more