Setting up our Project

  • GitLab CI/CD is a powerful tool for automating all kinds of tasks, not just software development.
  • The .gitlab-ci.yml file is where we define the commands that will run in our pipeline.
  • Pipelines are made up of stages and jobs. Stages run sequentially, but jobs within a stage run in parallel.

Understanding the CI/CD File

  • Use .md files for episodes when you want static content
  • Use .Rmd files for episodes when you need to generate output
  • Run sandpaper::check_lesson() to identify any issues with your lesson
  • Run sandpaper::build_lesson() to preview your lesson locally

Using CI/CD to Build and Deploy a LaTeX Document

  • We can use CI/CD to automate the process of building and deploying a LaTeX document.
  • Each job in the CI/CD pipeline runs in a Docker container, and we can specify which Docker image to use for each job.
  • We can use the “artifacts” feature of CI/CD to save files generated by a job and make them available for download.
  • We can use the “pages” feature of GitLab CI/CD to deploy static files to a public URL.

Pandoc

  • We can use Pandoc to convert Markdown files into different formats, including PDF files.
  • We can apply templates to our Pandoc documents to customize the appearance of the output.

Working with Custom Templates

  • The beamer class is a popular LaTeX class for creating slide presentations.
  • We can use custom templates with Pandoc to create more complex documents.