= 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 get by using pre-built, static websites. Those can be either created by hand from scratch,
using a publicly available free template 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 Theme (Layout): 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 || ||


== Getting Online ==

After succesfully creating a Gitlab Page it is at first only reachable within the IMATH Network.

The URL to access it is as follows:

{{{http://[git-username].pages.math.uzh.ch/[project-name]}}}

If we look at the previous example:

 * Example project:
   * https://git.math.uzh.ch/bbaer/pages-static

 * HTML display:
   * http://bbaer.pages.math.uzh.ch/pages-static/

If you have set up your gitlab page and want it to be available from the outside, please contact support@math.uzh.ch