This is a theme repository for satRday conference websites using the hugo static site generator. It is designed to be used in tandem with hugo-agency-theme a theme by digitalcraftsmen.

1. Install hugo

   • Install Hugo

2. Start a new site

   hugo new site [city][year] # such as cardiff2018
   
   cd [city][year]
   
   git init
   

3. Install hugo-agency-theme as a submodule

   git submodule add https://github.com/digitalcraftsman/hugo-agency-theme themes/hugo-agency-theme
   

4. Install hugo-satrday-theme as a submodule

   git submodule add https://github.com/satRdays/hugo-satrdays-theme themes/hugo-satrdays-theme
   

5. copy the config.toml from this site into your projects root (i.e. /cardiff2018/config.toml)

6. copy the files in hugo-satrdays-theme/data/projects/ into [city][year]/data/projects/ e.g. /cardiff2018/data/projects/

7. check if the site builds

   hugo serve
   

   go to the port listed in the return to see your site e.g. localhost:xxxx, probably localhost:1313

8. modify the params in the config.toml

9. if you want to make the page different in a way not accessible through the config.toml the best way is to copy the relevant partial from the theme (e.g. mysite/themes/hugo-satrdays-theme/layouts/patials/clients.html) and put it into the layouts on the root project folder (e.g. mysite/layouts/patials/clients.html, which you may need to make). This will be 'found first' when the site is generated, and so used instead.