Gitlab normally displays the source of HTML files you access through your web browser.
Here is how to force Gitlab to interpret and display the render of these files.
Bonus:
- You can use HTML along with CSS and Javascript
- It works on any Gitlab instance (Gitlab.com or Frama.io for example)
Let’s go!#
- Upload your files to your Gitlab repository
- Add a file called
.gitlab-ci.ymlcontaining the following lines at the root of this repo:
pages:
script:
- mkdir .public
- cp -r * .public
- mv .public public
artifacts:
paths:
- public
Done!
Your file is now available at
https://your-username.gitlab.io/project-name/filename.html
Please note that your repository must be public (in Settings → Visibility) if you want to allow unregistered users to access your file.
Update: You can also use this technique with a private repository. See this post for details: Gitlab: use public Pages while keeping the Git repo private.
Further reading#
- How to host an html page in GitLab Pages
- Websites for your GitLab projects, user account or group
- GitLab Pages | GitLab
- Comment utiliser les Gitlab Pages ? (in french)
- Get a shorter URL with this solution based on
.htaccess - Another implementation : https://gitlab.com/pages/plain-html