cupper-hugo-theme/content/patterns/installation.md

2.5 KiB

+++ title = "Installation" weight = 1 +++

Infusion is built using the static site engine, Hugo, and NPM. The codebase is available to download on Github. Let's get set up step-by-step.

Install Hugo

First you need to install Hugo globally.

OSX users

If you are a Mac user and have Homebrew on your system, installing Hugo is simple:

{{}}brew install hugo{{}}

Alternatively, you can manually install Hugo from a package. You can verify the installation was successful by typing:

{{}}hugo version{{}}

Windows users

Installing on Windows is a bit more involved than on OSX. The authors of Hugo provide a guide with instructions for technical and less technical users.

It's also best you install a Windows Subsystem for running Linux, and therefore bash (Infusion incorporates some bash commands in its scripts). Microsoft offer a complete guide.

Install Node & NPM

It is likely you already have Node and NPM installed on your system. If so, you can skip this step. Otherwise, refer to NPM's own guide, which includes a video tutorial.

Get the files

Infusion is hosted on Github. To start using it, you'll need to get the files from there. If you are comfortable with the command line, just fork the github.com/ThePacielloGroup/infusion repository, then do a git clone to your local system. Replace [your username] in the following:

{{}}git clone https://github.com/[your username]/infusion.git{{}}

If the command line is not your thing, fork github.com/ThePacielloGroup/infusion and choose Open in Desktop from Clone or download (see figure 1, below).

{{% figure caption="The Github web interface" %}} The open in desktop option, revealed when clicking clone or download {{% /figure %}}

{{% note %}} If you do not have a version of the Github desktop client installed, follow the prompts after clicking Open in Desktop. {{% /note %}}

Once you have your local copy of the files, move to the root of that folder and in your terminal run an npm installation:

{{}}npm install{{}}

Now it's time to consult the {{% pattern "Library setup" %}} pattern.