Unicado Pages

This repository contains the static website of UNICADO which is hosted by GitLab pages. We are using mkdocs as the static site generator to generate the website from markdown files.

Preview

It is assumed you have a working 🐍 Python installation in the following!

You can preview the website after cloning it. First you need to install mkdocs and the used theme by:

pip install mkdocs mkdocs-material mkdocs-glightbox mkdoxy mkdocs-site-urls mkdocs-bibtex

Then you can change the directory to the repository and run

mkdocs serve

This will start a local webserver which you can access with your webbrowser and preview the website.

with pipenv

You can also start the server inside a virtual environment using pipenv:

pipenv run mkdocs serve

Further Documentation

For features of the site generator and its theme please refer to their excellent documentation:

• ⤷ MkDocs
• ⤷ MkDocs Material

Page Template

The pages are written in plain markdown. The site generator has the option the extract some meta data from the content. A template might look like this:

---
title: Displayed Title of Page
summary: Summary of the page content.
authors:
    - Author 1
    - Author 2
date: yyyy-mm-dd
---
# MyPage

<Content goes here>