summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorSpencer Burris <sburris@posteo.net>2020-12-01 13:25:28 -0800
committerSpencer Burris <sburris@posteo.net>2020-12-01 13:25:28 -0800
commitd1721667b6302128727abbf4c346b2cf2f3cd255 (patch)
treec3c808ef263588163a8d63783bf13a38f2411072
parent59f2a9bf4ed62f7ad37ff8a14887886ca16ef576 (diff)
Add instructions for publishing via GitLab Pages
-rw-r--r--guide/src/continuous-integration.md28
1 files changed, 28 insertions, 0 deletions
diff --git a/guide/src/continuous-integration.md b/guide/src/continuous-integration.md
index e9dacc6e..f19b49cd 100644
--- a/guide/src/continuous-integration.md
+++ b/guide/src/continuous-integration.md
@@ -124,3 +124,31 @@ deploy: book
git commit -m "deployed on $(shell date) by ${USER}" && \
git push origin gh-pages
```
+
+## Deploying Your Book to GitLab Pages
+Inside your repository's project root, create a file named `.gitlab-ci.yml` with the following contents:
+```yml
+stages:
+ - deploy
+
+pages:
+ stage: deploy
+ image: rust:latest
+ variables:
+ CARGO_HOME: $CI_PROJECT_DIR/cargo
+ before_script:
+ - export PATH="$PATH:$CARGO_HOME/bin"
+ - mdbook --version || cargo install --debug mdbook
+ script:
+ - mdbook build -d public
+ only:
+ - master
+ artifacts:
+ paths:
+ - public
+ cache:
+ paths:
+ - $CARGO_HOME/bin
+```
+
+After you commit and push this new file, GitLab CI will run and your book will be available!