From 307fceb49f60b3d2b0d1f4dd00351e14b9499a82 Mon Sep 17 00:00:00 2001 From: Niclas Heinz Date: Tue, 31 Dec 2024 09:16:04 +0100 Subject: [PATCH] Updated publish comment on gitlab (#7853) * docs(publish gitlab pages): Update publish comment on gitlab * docs(publish gitlab): Add guide how to disable unique domains * docs(publish gitlab pages): Solve some styling issues --- docs/publishing-your-site.md | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/docs/publishing-your-site.md b/docs/publishing-your-site.md index f8318316a..e270d5bba 100644 --- a/docs/publishing-your-site.md +++ b/docs/publishing-your-site.md @@ -205,7 +205,23 @@ Now, when a new commit is pushed to the [default branch] (typically `master` or `main`), the static site is automatically built and deployed. Commit and push the file to your repository to see the workflow in action. -Your documentation should shortly appear at `.gitlab.io/`. +Your documentation is not published under `.gitlab.io/` +by default since **GitLab 17.4** [^1]. However, if you prefer a cleaner URL +structure, such as `.gitlab.io/`, you need to adjust +your configuration. + +To switch from a unique domain to the traditional URL structure, follow +these steps: + +1. Locate Your Repository +2. Go to **Settings › Pages** in the repository menu. +3. In the **Unique domain settings** section, **uncheck** the box labeled +4. **Use unique domain**. +5. Click **Save changes** to apply the update. + +Now you can reach your documentation under `.gitlab.io/`. + +[^1]: [Release notes for Gitlab 17.4](https://about.gitlab.com/releases/2024/09/19/gitlab-17-4-released/) ## Other