ebner
03e5fef78f
All checks were successful
Build and Publish Docker Image / docker (push) Successful in 29s
54 lines
1.2 KiB
Markdown
54 lines
1.2 KiB
Markdown
# 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 .
|
|
```
|