|
Size: 1812
Comment:
|
← Revision 14 as of 2021-02-03 10:13:45 ⇥
Size: 2348
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 3: | Line 3: |
| GitLab Pages allow you to create a custom website for your repository. | Gitlab Pages allow you to create a custom website for your repository. |
| Line 11: | Line 11: |
| 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]]. |
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]]. |
| Line 31: | Line 31: |
| * Manual for creating your own Template: https://gohugo.io/themes/creating/ | * Manual for creating your own Theme (Layout): https://gohugo.io/themes/creating/ |
| Line 38: | Line 38: |
== 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 |
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 HTML5 up or with various page builder programs, like Jekyll or 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
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:
- HTML display:
If you have set up your gitlab page and want it to be available from the outside, please contact support@math.uzh.ch