This will tell you how to use codeberg.page for hosting a static site, than is generated when you push to your git repo at codeberg.org. We will be using Zensical a replacemnet for MkDocs
Make a new repo called pages on codeberg (as pr: https://docs.codeberg.org/codeberg-pages/)
( No need for the pages branch, when using the actions/git-pages@v2 )
Activate Forgejo Action under your repos Settings: Units > Overview > Actions (Remember to click Save Settings)
Clone your repo to your computer
Make YAML file: .forgejo/workflows/demo.yaml with this content:
yaml
name: Test Codeberg.pages via Forgejo Actions
on:
push:
branches:
- main
jobs:
test:
runs-on: codeberg-tiny
steps:
- name: "Checkout repository"
uses: actions/checkout@v7
- name: "Install uv"
uses: https://github.com/astral-sh/setup-uv@v7
- name: "Convert README.md to index.html"
run: uv run md2html README.md >> index.html
- name: "Deploy site"
uses: actions/git-pages@v2
with:
site: https://${{ forge.repository_owner }}.codeberg.page/
token: ${{ forgejo.token }}
source: .