A single page theme for hugo
A live example of this theme is running at this site hugoscroll.fredrikloch.me
To get started with hugo you first need to download the binaries, whith these in place it is easy to get started.
# Init site hugo new site My_New_Cool_Venture cd My_New_Cool_Venture # Get this cool theme git clone https://github.com/SenjinDarashiva/hugoscroll themes/hugoscroll # Start the watching your folder hugo --buildDrafts --theme="hugoscroll" --watch server
With this done you can start creating posts, for this theme theme there is some specific information that needs to be added to your post header. For the first and the last post you need to add a class definition, the headers for this page look like this:
+++ title = "What is this" description = "First post" weight = 1 type = "post" class="post first" +++ +++ title = "Finaly!" description = "Last Post" weight = 100 type = "post" class="post last" +++
Every standard post must contain a weight between the weight of the first and the last to ensure correct ordering, in this case this allows us to use any number between 2 – 99
Apart from the regular config you can specify the following parameters to get extra features in the theme
[Params] github = "Senjindarashiva" bitbucket = "floch" flickr = "senjin" twitter = "senjindarshiva" email = "[email protected]" description = "" linkedin = "fredrikloch" cover = "/images/background-cover.jpg" logo = "/img/logo-1.jpg"
In order to develop or make changes to the theme you will need to have the sass compiler and bourbon both installed.
To check installation run the following commands from a terminal and you should see the
> cli output but your version numbers may vary.
sass -v > Sass 3.3.4 (Maptastic Maple)
If for some reason SASS isn’t installed follow the instructions from the Sass install page
bourbon help > Bourbon 3.1.8
If Bourbon isn’t installed follow the installation instructions on the Bourbon website
Once installation is verified we will need to go mount the bourbon mixins into the
From the project root run
bourbon install with the correct path
bourbon install --path static/scss > bourbon files installed to static/scss/bourbon/
Now that we have the bourbon mixins inside of the
scss src folder we can now use the sass cli command to watch the scss files for changes and recompile them.
sass --watch static/scss:static/css >>>> Sass is watching for changes. Press Ctrl-C to stop.
To minify the css files use the following command in the statics folder
curl -X POST -s --data-urlencode [email protected]/base.css' http://cssminifier.com/raw > css/base.min.css
For more information on available icons: font-awesome The files supplied with this theme have a minor alteration to work around an issue with adblocks and social icons. The changes means that the following classes is used:
- fa-tt – twitter
- fa-fb – facebook
- fa-ll – linkedin