Commit acbb947d authored by Romain Lesur's avatar Romain Lesur
Browse files

Intermediate commit

parent 2a16272a
Pipeline #11811663 passed with stage
in 1 minute and 55 seconds
# Details {#details}
TBD
A comprehensive documentation of `GitLab Pages` can be found here: https://docs.gitlab.com/ee/user/project/pages.
## `GitLab CI` configuration file {#CI-file-details}
```{r comment=NA, class.output='yaml', echo=FALSE}
readLines("./.gitlab-ci.yml") %>%
grep("image:", ., fixed = TRUE)
```
......@@ -24,13 +24,18 @@ output:
citation_package: natbib
---
# Overview: a very simple workflow {-}
# Overview: a simple workflow {-}
```{r include=FALSE}
```{r setup, include=FALSE}
library(magrittr)
```
```{r write-bib, include=FALSE}
knitr::write_bib(c(.packages(), 'bookdown'), 'packages.bib')
```
Publishing a `R` [@R-base] `bookdown` [@R-bookdown] website with [`GitLab Pages`](https://docs.gitlab.com/ee/user/project/pages/index.html) is as easy as:
Publishing a `R` [@R-base] `bookdown` [@R-bookdown] website with [`GitLab Pages`](https://about.gitlab.com/features/pages/) is as easy as:
- hosting a repository on [`GitLab`](https://gitlab.com)
- adding a configuration file to the project
......@@ -40,16 +45,16 @@ Publishing a `R` [@R-base] `bookdown` [@R-bookdown] website with [`GitLab Pages`
As [`GitHub`](https://www.github.com), [`GitLab`](https://gitlab.com) is a web-based [`Git`](https://git-scm.com/) repository manager. Creating a new project on [`GitLab`](https://gitlab.com) is fairly intuitive for [`GitHub`](https://www.github.com) users. [`GitLab`](https://gitlab.com) users can create unlimitate private projects for free (see [here](https://about.gitlab.com/gitlab-com/)).
[`GitLab`](https://gitlab.com) also offers a continuous integration service ([`GitLab CI`](https://about.gitlab.com/features/gitlab-ci-cd/)) and a static websites hosting service ([`GitLab Pages`](https://about.gitlab.com/features/pages/)) in its free plan ^[CI pipelines are limited to 2,000 minutes per month].
These features are present in the open source software [`GitLab Community Edition (CE)`](https://about.gitlab.com/products/).
These features are also present in the open source software [`GitLab Community Edition (CE)`](https://about.gitlab.com/products/).
## Add a `GitLab CI` configuration file {-}
Add the following `.gitlab-ci.yml` file in the root of the project:
```{r comment=NA, class.output='yaml', echo=FALSE}
```{r write-ci-file, comment=NA, class.output='yaml', echo=FALSE}
cat(readChar("./.gitlab-ci.yml", 1e5))
```
For explanations, see chapter \@ref(details).
For explanations, see section \@ref(CI-file-details).
## See the result {-}
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment