Guides

to get you started.

Initial Setup

clone

The master branch contains also the github page published here. You can make an empty start by cloning the plain branch:

git clone --single-branch --branch plain https://github.com/bdcaf/r-hugo-papercss-template.git

local setup

Many actions are run as make actions.

You can do to all actions doing

make setup

read more..

Create Post

Create a post using

hugo new --kind r-bundle post/mytitle

For now this will create a skeleton directoru under content/post/mytitle/. This content will contain a file index.md which will be overwritten. The interesting file is source.md - it will get special treatment as it is ignored in the settings. Without this ignoring it would show up twice.

It is a hugo specific that it will only fill out templates with extension .md. I put in a modeline for vim to set the filetype to rnoweb.

read more..

Tips

  • the contents of docs/ is deleted before building the site. If this is not done no longer used files will build up in there. Should you need to keep files put them in the static directory.

  • I dislike the way hugo truncates posts automatically for summary.
    Manually truncating by placing <!–more–> assures the head is rendered nicely. For short posts one can just put it at the and assure they are rendered fully.

read more..