cupper-hugo-theme/content/patterns/installation.md
2017-07-03 12:23:53 +01:00

2.3 KiB

+++ title = "Installation" +++

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.

1. Install Hugo

First we 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.

2. 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.

3. Getting 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/heydon/inclusive-pattern-library 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/heydon/inclusive-pattern-library 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.