content | ||
static | ||
themes/beautifulhugo | ||
.gitignore | ||
.gitlab-ci.yml | ||
config.toml | ||
docker-compose.yml | ||
LICENSE | ||
README.md |
Example Hugo website using GitLab Pages.
Learn more about GitLab Pages at https://pages.gitlab.io and the official documentation https://docs.gitlab.com/ce/user/project/pages/.
Table of Contents generated with DocToc
Using docker-compose
To build and serve locally without installing anything, provided that you have docker running:
docker-compose up
Then browse http://localhost:1313/
Building locally
To work locally with this project, you'll have to follow the steps below:
- Fork, clone or download this project
- Install Hugo
- Preview your project:
hugo server
- Add content
- Generate the website:
hugo
(optional)
Read more at Hugo's documentation.
Preview your site
If you clone or download this project to your local computer and run hugo server
,
your site can be accessed under localhost:1313/hugo/
.
The theme used is adapted from http://themes.gohugo.io/beautifulhugo/.
Troubleshooting
-
CSS is missing! That means two things:
Either that you have wrongly set up the CSS URL in your templates, or your static generator has a configuration option that needs to be explicitly set in order to serve static assets under a relative URL.
-
SSL certificate expired
see https://about.gitlab.com/2016/04/11/tutorial-securing-your-gitlab-pages-with-tls-and-letsencrypt/ (until we automate it with https://github.com/rolodato/gitlab-letsencrypt or custom api script)