index.md

layout: default
title: Index
order: 1

Gitlab pages

Welcome to an example page! Below you will find a detailed instruction on how to set-up your own gitlab website.

Sources for this page are available in Gitlab. Additionally, you can also navigate to the repository for theme.

Setting up your web page

The process

0. Make sure that you have access to gitlab. If you ever cloned a repository or set-up a new one there, then you should be fine. If you don't have it, either contact the sysadmins (lcsb-sysadmins (at) uni.lu) or open a ticket at https://service.uni.lu.
1. Create an empty repository in gitlab. Please bear in mind, that the both names of the namespace and the project influence final address of the page - it will follow the https://<namespace>.pages.uni.lu/<project_name> convention.
2. On your computer, clone this very repository using: git clone ssh://git@git-r3lab-server.uni.lu:8022/core-services/pages-jekyll-lcsb-template.git.
3. Once cloned, navigate into cloned repository (cd pages-jekyll-lcsb-template) and remove the remote (so that you update your repository, and not this very page): git remote rm origin, and add remote to your repository. You can find the correct remote address in gitlab, as in the following image:
4. Modify site's settings (_config.yml) to match your needs. Refer to the next section for help.
5. Modify the index page. Modify (or delete) help and about pages. Add your own content.
6. Add your changes (git add .), commit (git commit -m "Initial commit") and push (git push --set-upstream master) to the repository.
7. If you want to have your page publicly available, make a ticket to SIU.
8. Your page is published! Go to https://<namespace>.pages.uni.lu/name-of-repository in your favourite browser, or the URL you specified in the SIU ticket.
9. (optional) In gitlab, go to Settings (under left-hand menu) > General > Advanced (hit Expand button) > Remove fork relationship (red button), then follow the instructions from the pop-up.

What should you change in settings file?

Nothing! :) We've taken care of everything for you!

You may want to change:

• title field
• e-mail field
• description field
• date field
• banner field - if you want to have your own banner (the text next to uni.lu logo), please send us an email (lcsb-sysadmins (at) uni.lu).

Testing the web page locally

You can test your website locally (on your machine).

• First, make sure that you have Ruby installed. If not - please install it.
• Then, install bundler - gem install bundler.
• Next, initialize the site: bundle install.
• Finally, run the site: bundle exec jekyll serve.

Common problems

The website looks broken! There are no images, no colors etc.

You probably didn't configure baseurl parameter in the settings. Please take a look on _settings.yml file.

The links in the menu are not working (they point to "404: Not found").

You probably didn't add permalink attribute. Or the post has published: false or draft: true set. Please take a look on the post file.

Other problems?

Please send us an email! (lcsb-sysadmins (at) uni.lu)