mirror
/
pages-server
kopia lustrzana https://codeberg.org/Codeberg/pages-server
1
0
Forkuj 0
Kod Zgłoszenia Packages Projekty Wydania Wiki Aktywność

„Overview“ ändern

master
Moritz Marquardt 2021-11-25 19:34:10 +01:00
rodzic 434a0882e4
commit 2283647145
1 zmienionych plików z 6 dodań i 3 usunięć
Pokaż statystyki Ściągnij plik aktualizacji Ściągnij plik porównania Expand all files Collapse all files

9
Overview.md

@ -1,6 +1,6 @@
The Codeberg Pages server responds to four different URLs:
- https://raw.codeberg.org/username/reponame/: raw content, uses correct MIME types (HTML is forbidden though) & is accessible with CORS
- https://raw.codeberg.org/username/reponame/: raw content, uses correct MIME types (HTML is forbidden though) & is accessible with CORS.
- https://username.codeberg.page: user page, points the default branch of a user's or organization's `pages` repository
- https://username.codeberg.page/reponame/: repo page, points to the `pages` branch of the repository
- https://example.org: custom domain, points to a repo of choice as outlined below
@ -8,9 +8,12 @@ The Codeberg Pages server responds to four different URLs:
In all cases, you can append a branch using an `@` (e.g. https://username.codeberg.page/@develop/README.md).
For custom domains, two things are required:
- A `.domains` file in the repository (in the branch in question), containing a list of domains that shall be usable to access that repository. One domain per line, you can leave lines empty and comment out lines with `#`.
- A `.domains` file in the repository (in the branch in question), containing a list of domains that shall be usable to access that repository:
- One domain per line, you can leave lines empty and comment out lines with `#`.
- All domains (including `*.codeberg.page`) will be redirected to the first domain in that file.
- A CNAME record pointing to one of the following targets:
- `username.codeberg.page` → https://username.codeberg.page
- `reponame.username.codeberg.page` → https://username.codeberg.page/reponame/
- `branchname.reponame.username.codeberg.page` → https://username.codeberg.page/reponame/@branchname/
- If you can't use a CNAME record to configure the target, you can use an A/AAAA/ALIAS record to `codeberg.page` with an additional TXT record with the target.
If you can't use a CNAME record to configure the target, you can use an A/AAAA/ALIAS record to `codeberg.page` with an additional TXT record for the target (just as shown above for CNAME records).