Git Skills 1

This presentation is a Website built with the Hugo generator and the reveal-hugo theme, which uses reveal.js.

Prerequisites

• Git: On Windows, use Git for Windows
• Hugo
• A UNIX shell: On Windows, use the Git bash shell
• Optional: Docker

The example commands in this workshop are for a UNIX shell. If you are using Windows, open a Git Bash window and run the commands in it.

Use whichever text editor you prefer.

Setup

Hugo is a self-contained binary.

Windows

1. Download the latest release ZIP from GitHub: https://github.com/gohugoio/hugo/releases

2. Unzip the release

3. Copy the hugo.exe file to the root of this project

4. Make Hugo executable:

   $ chmod 0700 ./hugo.exe

macOS or Linux

1. Download the latest release ZIP from GitHub: https://github.com/gohugoio/hugo/releases

2. Unzip the release

3. Copy the hugo file to the root of this project

4. Make Hugo executable:

   $ chmod 0700 ./hugo

Docker on macOS

The Docker configuration in this project does not current run on Windows.

The do.sh utility script provides tools for building and running the site.

Run the setup subcommand to build the Docker container:

./do.sh setup

Usage

To view the content, we use the serve subcommand of Hugo. This generates the Website from the text files in this repository, and makes the site available at this address:

http://localhost:1313/

If you save a change to the text files, the Website will instantly update.

Windows

./hugo.exe serve

macOS and Linux

./hugo.exe serve

Docker on macOS

To view the content, use the serve subcommand of the do script:

./do.sh serve

Creating a PDF

This site includes support for print as PDF. To save the whole presentation as a PDF file, open the site in a Chromium browser, with the ?print-pdf string in the address:

http://localhost:1313/?print-pdf#/

Then open Print in Chrome, set the Destination to Save as PDF, set the Margins to None, enable Background graphics option, and choose Save.