From e35d1a3c3d4a572d6d0f98931d02b747d69752ef Mon Sep 17 00:00:00 2001 From: swiftdoc Date: Fri, 29 May 2026 15:45:20 -0400 Subject: [PATCH] Codeberg Pages: note the public-repository requirement The `pages` repository must be public for git-pages to serve it, but this was only stated on the "pushing output" page. Newcomers following the quickstart or hitting an unpublished site had no signal. Add a warning admonition to the Pages getting-started page and a troubleshooting entry covering the "my site won't publish" case. Closes #748 Co-Authored-By: Claude Opus 4.8 --- content/codeberg-pages/index.md | 8 ++++++++ content/codeberg-pages/troubleshooting.md | 6 ++++++ 2 files changed, 14 insertions(+) diff --git a/content/codeberg-pages/index.md b/content/codeberg-pages/index.md index 6e4c938..3383a4b 100644 --- a/content/codeberg-pages/index.md +++ b/content/codeberg-pages/index.md @@ -45,6 +45,14 @@ There are two ways to get started with Codeberg Pages on git-pages: This page documents the first method. See the [separate page on using Forgejo Actions](/codeberg-pages/forgejo-actions/) for information on the second method. +{% admonition "warning" %} + +The `pages` repository **must** be public, as Codeberg Pages directly fetches the files from the repository, +just like an ordinary visitor would. +A private repository will not be served. + +{% endadmonition %} + ### User/organization websites 1. Create a repository called `pages` under your own username or under the organization you want to create a website for diff --git a/content/codeberg-pages/troubleshooting.md b/content/codeberg-pages/troubleshooting.md index b310b01..3f85116 100644 --- a/content/codeberg-pages/troubleshooting.md +++ b/content/codeberg-pages/troubleshooting.md @@ -14,6 +14,12 @@ contains a sub-sub-domain which does not work with Let's Encrypt wildcard certif Use the alternative URL as a workaround or rename you repository (e.g. replace `.` by `_`). +## My website is not published + +Make sure the `pages` repository is **public**. +Codeberg Pages directly fetches the files from the repository, just like an ordinary visitor would, +so a private repository will not be served. + ## My content is not updated The Codeberg Pages v2 server caches files under a certain size (currently 1 MiB).