= GitLab Pages =

GitLab Pages allow you to create a custom website for your repository.

== Examples ==

There are various ways to create HTML content and Gitlab Pages does little to limit you in this regard.

=== Static Pages ===

The most freedom you have by using prebuild, static websites. Those can be either created by hand from scratch,
using a publicly available free templates such as [[https://html5up.net/|HTML5 up]] or with various page builder programs, like [[https://jekyllrb.com/|Jekyll]] or [[https://hyde.github.io/|Hyde]].

Setting up those sites is easy and illustrated in this gitlab project: https://git.math.uzh.ch/bbaer/pages-static

|| Advantages || Disadvantages ||
|| Creative freedom || Requires either HTML and CSS or knowledge of a framework such as Jekyll. ||
|| Not tied to a generator || Jekyll or other builders need to be installed locally ||
|| Local Debugging || ||
|| No need to port existing Homepage || ||


=== Pages build with Hugo ===

[[https://gohugo.io/|Hugo]] is a website framework like Jekyll build on Go, that we have pre installed and can be build directly with via our git runners.

An example Project that can be used is found on our git: https://git.math.uzh.ch/bbaer/pages-hugo

 * Hugo offers various Themes you can use: https://themes.gohugo.io/
 * Manual for managing your Content: https://gohugo.io/content-management/
 * Manual for creating your own Design: https://gohugo.io/themes/creating/

|| Advantages || Disadvantages ||
|| A selection of pre made themes || Bound to one tool ||
|| No knowledge of HTML/CSS needed || Porting an existing homepage to hugo, especially without using pre made hugo themes, takes a lot of time and effort ||
|| No installation required || ||
|| Highly optimized webpages || ||