dallasgroot/Documentation
1
0
Fork 0
mirror of https://codeberg.org/Codeberg/Documentation.git synced 2026-06-16 05:13:54 -07:00
Code Issues Projects Releases Packages Wiki Activity Actions

Link examples on how to use a CI for publishing SSG pages (#628)

Browse source 
In #601, the suggestion was made to provide details on how to use a CI to get a website published to Codeberg Pages when using a static site generator.

We already provide a lot of details on that via the Woodpecker CI examples repo, so I've linked to that to help people find those details!

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/628
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Co-authored-by: Bastian Greshake Tzovaras <bgreshake@googlemail.com>
Co-committed-by: Bastian Greshake Tzovaras <bgreshake@googlemail.com>
This commit is contained in:
Bastian Greshake Tzovaras 2025-06-18 23:03:30 +02:00 committed by Bastian Greshake Tzovaras
parent 73f5bfef39
commit 94a88006df
1 changed files with 12 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

12
content/codeberg-pages/pushing-output.md
View file

@ -11,6 +11,8 @@ eleventyNavigation:
If you are using a static site generator (SSG) and are satisfied with the result of your project on your local development
environment, you can push the files to your Codeberg Pages repository.
## Manual pushing
To begin with, we will have two separate repositories, both locally and on Codeberg:
- A main repository for the source files, i.e. where the source files related to your main project will be located.
@ -89,3 +91,13 @@ request to merge it into the default branch. To learn more about pull requests,
You should now be able to access your content by visiting https://{username}.codeberg.page.
You can find more information in the [Codeberg Pages](/codeberg-pages/) section.
## Using a CI
Both the [Woodpecker CI](/ci/#using-codeberg's-instance-of-woodpecker-ci) and the [hosted Forgejo Actions](/ci/actions/) can be used to automate the build and deployment of your static website.
For the Woodpecker CI, you can see the [existing example workflows in the `Codeberg-CI/examples` repo](https://codeberg.org/Codeberg-CI/examples), which provides examples for Jekyll, Hugo, Zola and many other popular SSG.
Currently, we do not have any examples for the Forgejo Actions yet, but individual SSG tools might have details in their own documentation:
- [Hugo docs on using Forgejo Actions for Codeberg Pages](https://gohugo.io/host-and-deploy/host-on-codeberg-pages/#automated-deployment-using-forgejo-actions)