Hugo In Concrete

Currently a Work-in-Progress

This page tells you how to get started with the Concrete theme.

Setting up a new site

To prepare your new site environment just a few steps are required:

1. Create a new empty Hugo site.

   hugo new site demosite

2. Change the directory to the root of the new site.

   cd demosite

3. Create a new theme folder

   mkdir themes

Get the Concrete theme

From the site root either clone or add the Concrete repository as a new submodule.

# Cloning
git clone https://github.com/coderrob/hugo-in-concrete themes/concrete

# Submodule
git submodule add https://github.com/coderrob/hugo-in-concrete themes/concrete

Preview the Concrete theme

cd themes/concrete/exampleSite/
hugo serve --themesDir ../..

Concrete configuration

1. Add the Concrete theme to the site config.toml.

   baseURL = "http://example.org/"
   languageCode = "en-us"
   title = "My New Hugo Site"
   
   # Set the theme to Concrete
   theme = "concrete"

2. Configure the site navigation.

   # Add the site navigation links
   [menu]
   
   [[menu.main]]
   name = "Home"
   url = "/"
   weight = 1
   
   [[menu.main]]
   name = "Blog"
   url = "/posts/"
   weight = 2

3. Configure the syntax highlighting to use Github shortcodes.

   # Required for using the Github style syntax
   [markup]
   defaultMarkdownHandler = "goldmark"
   
   [markup.goldmark]
   
   [markup.goldmark.extensions]
   definitionList = true
   footnote = true
   linkify = true
   strikethrough = true
   table = true
   taskList = true
   typographer = true
   
   [markup.goldmark.parser]
   attribute = true
   autoHeadingID = true
   
   [markup.goldmark.renderer]
   hardWraps = false
   unsafe = true
   xHTML = false
   
   [markup.highlight]
   codeFences = true
   hl_Lines = ""
   lineNoStart = 1
   lineNos = false
   lineNumbersInTable = true
   noClasses = true
   style = "github"
   tabWidth = 4
   
   [markup.tableOfContents]
   endLevel = 6
   startLevel = 2

Test your site

1. Test your site.

   hugo server --theme concrete -D