From a07611d9981ea1840dbf95ddb66ff3ebe5d888ad Mon Sep 17 00:00:00 2001
From: Andreas Reiser <areiser@hm.edu>
Date: Thu, 22 Nov 2018 17:49:29 +0100
Subject: [PATCH 1/2] Add instructions on how to deploy to GitLab pages

---
 .../documentation/deployment/gitlab-pages.md  | 69 +++++++++++++++++++
 1 file changed, 69 insertions(+)
 create mode 100644 docs/content/documentation/deployment/gitlab-pages.md

diff --git a/docs/content/documentation/deployment/gitlab-pages.md b/docs/content/documentation/deployment/gitlab-pages.md
new file mode 100644
index 0000000..77b0a7c
--- /dev/null
+++ b/docs/content/documentation/deployment/gitlab-pages.md
@@ -0,0 +1,69 @@
+ +++
+title = "GitLab Pages"
+weight = 30
++++
+
+We are going to use the GitLab CI runner to automatically publish the site (this CI runner is already included in your repository if you use GitLab.com).
+
+## Repository setup
+
+Your repository needs to be set up to be a user or group website. This means the name of the repository has to be in the correct format.
+
+For example, under your username, `john`, you have to create a project called `john.gitlab.io`. Your project URL will be `https://gitlab.com/john/john.gitlab.io`. Once you enable GitLab Pages for your project, your website will be published under `https://john.gitlab.io`.
+
+Under your group `websites`, you created a project called `websites.gitlab.io`. Your project’s URL will be `https://gitlab.com/websites/websites.gitlab.io`. Once you enable GitLab Pages for your project, your website will be published under `https://websites.gitlab.io`.
+
+
+This guide assumes that your zola project is located in the root of your repository.
+
+## Ensuring that the CI runner can access your theme
+
+Depending on how you added your theme your repository may not contain it. The best way to ensure the theme will be added is to use
+submodules. When doing this ensure you are using the `https` version of the URL.
+
+```shell
+$ git submodule add {THEME_URL} themes/{THEME_NAME}
+```
+
+For example, this could look like
+```shell
+$ git submodule add https://github.com/getzola/hyde.git themes/hyde
+```
+
+## Setting up the GitLab CI/CD Runner
+
+The second step is to tell the gitlab continous integration runner how to create the gitlab page.
+
+To do this, create a file called  `.gitlab-ci.yml` in the root directory of your repository.
+
+```yaml
+variables:
+  # This variable will ensure that the CI runner pulls in your theme from the submodule
+  GIT_SUBMODULE_STRATEGY: recursive
+
+pages:
+  script:
+    # Download the zola executable and store it in zola.tar.gz
+    - curl -L https://github.com/getzola/zola/releases/download/v0.5.0/zola-v0.5.0-x86_64-unknown-linux-gnu.tar.gz > zola.tar.gz
+    # Unpack the zola executable
+    - tar -xzf zola.tar.gz
+    # Execute zola build
+    - ./zola build
+    
+  artifacts:
+    paths:
+      # Path of our artifacts
+      - public
+      
+  # This config will only publish changes that are pushed on the master branch
+  only:
+  - master
+```
+
+Push this new file and... Tada! You're done! If you navigate to `settings > pages` you should be able to see something like this:
+
+> Congratulations! Your pages are served under:  
+https://john.gitlab.io
+
+More information on the process to host on GitLab pages and additional information like using a custom domain is documented 
+[in this GitLab blog post](https://about.gitlab.com/2016/04/07/gitlab-pages-setup/).

From 644e53a3fd6ed97a9ffec8446980831e4a5d0b67 Mon Sep 17 00:00:00 2001
From: Andreas Reiser <areiser@hm.edu>
Date: Thu, 22 Nov 2018 19:25:34 +0100
Subject: [PATCH 2/2] Extract zola version to a variable

---
 docs/content/documentation/deployment/gitlab-pages.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/docs/content/documentation/deployment/gitlab-pages.md b/docs/content/documentation/deployment/gitlab-pages.md
index 77b0a7c..73bb2b0 100644
--- a/docs/content/documentation/deployment/gitlab-pages.md
+++ b/docs/content/documentation/deployment/gitlab-pages.md
@@ -39,12 +39,14 @@ To do this, create a file called  `.gitlab-ci.yml` in the root directory of your
 ```yaml
 variables:
   # This variable will ensure that the CI runner pulls in your theme from the submodule
-  GIT_SUBMODULE_STRATEGY: recursive
+  GIT_SUBMODULE_STRATEGY: recursive  
+  # Specify the zola version you want to use here
+  ZOLA_VERSION: "v0.5.0"
 
 pages:
   script:
     # Download the zola executable and store it in zola.tar.gz
-    - curl -L https://github.com/getzola/zola/releases/download/v0.5.0/zola-v0.5.0-x86_64-unknown-linux-gnu.tar.gz > zola.tar.gz
+    - curl -L https://github.com/getzola/zola/releases/download/$ZOLA_VERSION/zola-$ZOLA_VERSION-x86_64-unknown-linux-gnu.tar.gz > zola.tar.gz
     # Unpack the zola executable
     - tar -xzf zola.tar.gz
     # Execute zola build