# Overview

Alpine based image to build zensical - https://zensical.org -  based documentation

Build manually:
```bash
docker run -it --rm -v $(pwd):/data --workdir /data gitea.psi.ch/images/alpine-zensical

/opt/python-env/bin/zensical build
```

Use Gitea/Github action to build the documentation:

```yaml
name: Build and Publish Site

on:
  push:
    branches:
      - main
  workflow_dispatch:

jobs:
  docker:
    runs-on: ubuntu-latest-intranet
    container:
      image: gitea.psi.ch/images/alpine-zensical
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Run mkdocs
        run: /opt/python-env/bin/zensical build

      - name: Configure Git
        run: |
          git config --global user.name "Gitea Actions"
          git config --global user.email "actions@gitea.local"

      - name: Push to gitea-pages branch
        run: |
          git checkout --orphan gitea-pages
          git reset --hard
          mv site/* .
          git add .
          git commit -m "Update site - $(date)"
          git push -f https://${{secrets.GITHUB_TOKEN}}@gitea.psi.ch/${{ github.repository }}.git gitea-pages
```


```bash
docker build --platform linux/x86_64 -t gitea.psi.ch/images/alpine-zensical:latest .
```