First ensure that you have hugo installed.
If you install from the release page, make sure to get the
extended Hugo version, which supports sass; you may need to scroll down the list of releases to see it.
For comprehensive Hugo documentation, see gohugo.io.
Run your site with compose theme
You could go with the options right below.
Option 1 (my favorite)
This option enables you to load compose theme as a hugo module. First things first, ensure you have
go binary installed on your machine.
1git clone https://github.com/onweru/compose/ 2cd compose/exampleSite/ 3hugo server
To pull in theme updates, run
hugo mod get -u ./... from the theme folder. If unsure, learn how to update hugo modules
The exampleSite uses the theme as a hugo module by default.
If you choose Option 2 or Option 3 below, ensure you edit these lines in the config.toml file as advised on the comments. Else, you will not be able to pull theme updates.
Option 2 (recommended)
Generate a new Hugo site and add this theme as a Git submodule inside your themes folder:
1hugo new site yourSiteName 2cd yourSiteName 3git init 4git submodule add https://github.com/onweru/compose/ themes/compose 5cp -a themes/compose/exampleSite/* .
Option 3 (Great for testing quickly)
You can run your site directly from the
exampleSite. To do so, use the following commands:
1git clone https://github.com/onweru/compose/ 2cd compose/exampleSite/ 3hugo server --themesDir ../..
Once set, jump over to the config.toml file and start configuring your site.