Why?

the layout was broken
.gitlab-ci.yml had a unnecessary gem (redcarpet)
the template was very old (probably Jekyll 2.4.0 or older)

What did you do?

I generated new Jekyll site locally (jekyll new project) using last Jekyll version (3.2.1)
I added readme with basic instructions and fix doc-pages URL (was https://doc.gitlab.com/ee/pages/)
I edited _config.yml url and baseurl to match the correct path and kept the same title as before ("Example Jekyll site using GitLab Pages")

Results

Before

After

Why WIP?

Because the changes are significant in terms of content. We could just fix the urls on _config.yml and the link to doc-pages on readme and we'd be good to go.

README:

Example Jekyll site using GitLab Pages. Read more at http://doc.gitlab.com/ee/pages/README.html

Theme: Jekyll 3 Default

Original source:

This project was created with Jekyll v.3.1.2 default template by running jekyll new project locally. After that, the project was pushed to this repository with the following configurations:

GitLab CI config: .gitlab-ci.yml
Gitignore: .gitignore
Jekyll config: _config.yml

Building locally

Note: We assume you already have Jekyll 3.1.2 installed and up and running on your computer.

To work locally with this project, there are a few options. But let's keep it simple:

Fork, clone or download this project
Adjust _config.yml according to your project
Preview your project: jekyll serve

GitLab User or Group Page

To use this project as your user/group website, you will need one additional step: just rename your project to namespace.gitlab.io, where namespace is your username or groupname. This can be done by navigating to Project -> Settings.

Forked projects

If you forked this project for your own use, please go to Project -> Settings and remove the forking relationship, which won't be necessary in this case.

Enjoy!

cc/ @axil

Admin message