<?xml version="1.0" encoding="utf-8"?><!DOCTYPE article  PUBLIC '-//OASIS//DTD DocBook XML V4.4//EN'  'http://www.docbook.org/xml/4.4/docbookx.dtd'><article><articleinfo><title>GitLab_Pages</title><revhistory><revision><revnumber>14</revnumber><date>2021-02-03 10:13:45</date><authorinitials>eseide</authorinitials></revision><revision><revnumber>13</revnumber><date>2021-02-03 10:08:50</date><authorinitials>eseide</authorinitials></revision><revision><revnumber>12</revnumber><date>2018-12-06 12:15:35</date><authorinitials>bbaer</authorinitials></revision><revision><revnumber>11</revnumber><date>2018-12-06 12:14:27</date><authorinitials>bbaer</authorinitials></revision><revision><revnumber>10</revnumber><date>2018-12-06 12:13:58</date><authorinitials>bbaer</authorinitials></revision><revision><revnumber>9</revnumber><date>2018-12-06 12:13:41</date><authorinitials>bbaer</authorinitials></revision><revision><revnumber>8</revnumber><date>2018-12-06 12:13:19</date><authorinitials>bbaer</authorinitials></revision><revision><revnumber>7</revnumber><date>2018-12-06 12:10:19</date><authorinitials>bbaer</authorinitials></revision><revision><revnumber>6</revnumber><date>2018-12-06 12:07:52</date><authorinitials>bbaer</authorinitials></revision><revision><revnumber>5</revnumber><date>2018-12-06 12:07:39</date><authorinitials>bbaer</authorinitials></revision><revision><revnumber>4</revnumber><date>2018-12-06 12:07:20</date><authorinitials>bbaer</authorinitials></revision><revision><revnumber>3</revnumber><date>2018-12-06 12:06:40</date><authorinitials>bbaer</authorinitials></revision><revision><revnumber>2</revnumber><date>2018-12-06 10:42:17</date><authorinitials>bbaer</authorinitials></revision><revision><revnumber>1</revnumber><date>2018-12-06 10:38:25</date><authorinitials>bbaer</authorinitials></revision></revhistory></articleinfo><section><title>GitLab Pages</title><para>Gitlab Pages allow you to create a custom website for your repository. </para><section><title>Examples</title><para>There are various ways to create HTML content and Gitlab Pages does little to limit you in this regard. </para><section><title>Static Pages</title><para>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 <ulink url="https://html5up.net/">HTML5 up</ulink> or with various page builder programs, like <ulink url="https://jekyllrb.com/">Jekyll</ulink> or <ulink url="https://hyde.github.io/">Hyde</ulink>. </para><para>Setting up those sites is easy and illustrated in this gitlab project: <ulink url="https://git.math.uzh.ch/bbaer/pages-static"/> </para><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para> Advantages </para></entry><entry colsep="1" rowsep="1"><para> Disadvantages </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> Creative freedom </para></entry><entry colsep="1" rowsep="1"><para> Requires either HTML and CSS or knowledge of a framework such as Jekyll. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> Not tied to a generator </para></entry><entry colsep="1" rowsep="1"><para> Jekyll or other builders need to be installed locally </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> Local Debugging </para></entry><entry colsep="1" rowsep="1"/></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> No need to port existing Homepage </para></entry><entry colsep="1" rowsep="1"/></row></tbody></tgroup></informaltable></section><section><title>Pages build with Hugo</title><para><ulink url="https://gohugo.io/">Hugo</ulink> is a website framework like Jekyll build on Go, that we have pre installed and can be build directly with via our git runners. </para><para>An example Project that can be used is found on our git: <ulink url="https://git.math.uzh.ch/bbaer/pages-hugo"/> </para><itemizedlist><listitem><para>Hugo offers various Themes you can use: <ulink url="https://themes.gohugo.io/"/> </para></listitem><listitem><para>Manual for managing your Content: <ulink url="https://gohugo.io/content-management/"/> </para></listitem><listitem><para>Manual for creating your own Theme (Layout): <ulink url="https://gohugo.io/themes/creating/"/> </para></listitem></itemizedlist><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para> Advantages </para></entry><entry colsep="1" rowsep="1"><para> Disadvantages </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> A selection of pre made themes </para></entry><entry colsep="1" rowsep="1"><para> Bound to one tool </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> No knowledge of HTML/CSS needed </para></entry><entry colsep="1" rowsep="1"><para> Porting an existing homepage to hugo, especially without using pre made hugo themes, takes a lot of time and effort </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> No installation required </para></entry><entry colsep="1" rowsep="1"/></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> Highly optimized webpages </para></entry><entry colsep="1" rowsep="1"/></row></tbody></tgroup></informaltable></section></section><section><title>Getting Online</title><para>After succesfully creating a Gitlab Page it is at first only reachable within the IMATH Network. </para><para>The URL to access it is as follows: </para><para><code>http://[git-username].pages.math.uzh.ch/[project-name]</code> </para><para>If we look at the previous example: </para><itemizedlist><listitem><para>Example project: </para><itemizedlist><listitem><para><ulink url="https://git.math.uzh.ch/bbaer/pages-static"/> </para></listitem></itemizedlist></listitem><listitem><para>HTML display: </para><itemizedlist><listitem><para><ulink url="http://bbaer.pages.math.uzh.ch/pages-static/"/> </para></listitem></itemizedlist></listitem></itemizedlist><para>If you have set up your gitlab page and want it to be available from the outside, please contact <ulink url="mailto:support@math.uzh.ch">support@math.uzh.ch</ulink> </para></section></section></article>