Setting up Hugo for the first time


#1

Hi, I’m trying to setup Hugo with the Kube theme for the first time https://github.com/jeblister/kube to deploy it further to Netlify. I got stuck, any help will be appreciated.

  1. When I run hugo server, I get an error:
Hugo$ hugo server
ERROR: 2017/12/06 17:45:37 hugo.go:449: Current theme does not support Hugo version 0.16. Minimum version required is 0.19
Hugo$ hugo version
Hugo Static Site Generator v0.16-DEV BuildDate: 2016-02-06T20:14:17+03:00

but I can’t update Hugo to 0.19. when I go sudo snap refresh hugo, nothing happens.

full trace (I also don’t understand how to fix other errors:

ERROR: 2017/12/06 18:26:54 hugo.go:449: Current theme does not support Hugo version 0.16. Minimum version required is 0.19
ERROR: 2017/12/06 18:26:54 template.go:350: template: theme/_default/baseof.html:14: function "slice" not defined
ERROR: 2017/12/06 18:26:54 template.go:350: template: theme/docs/single.html:18: function "slice" not defined
ERROR: 2017/12/06 18:26:54 template.go:350: template: theme/partials/post/byauthor.html:10: function "default" not defined
ERROR: 2017/12/06 18:26:54 template.go:350: template: theme/partials/post/related-content.html:10: function "default" not defined
0 draft content
0 future content
0 pages created
0 non-page files copied
0 paginator pages created
0 tags created
0 categories created
in 11 ms
Watching for changes in /home/eva/Develop/Netlify/Hugo/{data,content,layouts,static,themes}
Serving pages from memory
Web Server is available at http://localhost:1313/ (bind address 127.0.0.1)
Press Ctrl+C to stop

  1. I don’t really get what the folder structure should be. First, I followed the instruction and 1) created a folder Hugo 2) installed Hugo in it with sudo apt-get install hugo 3) changed into themes folder inside Hugo and cloned theme repository in it 4) changed into the the flder of my theme kube and run hugo server. The server didn’t launch. When I moved the kube folder from themes to Hugo, server launched, but with a blank page. I’m not sure why the page is blank and what the folder structure should be. There are also 4 config.toml files in my Hugo folder, and exampleSite which maybe should be also moved up. I’m confused with allocating all the folders and files in the proper hierarchy to make it work.

#2

You need to use a newer version of Hugo. If you have problem with Snap, try downloading a binary from here:


#3

Thank you!!! I got it up and running.

What I did:

  1. Deleted duplicates of Hugo with sudo dpkg --purge hugo (checked with whereis hugo)
  2. downloaded and unpacked hugo_0.30.2_Linux-64bit.tar.gz
  3. did export PATH="/usr/local/bin:$PATH" (checked with echo $PATH)

Then hugo server worked and showed me my theme on http://localhost:1313/.

PS but all linked pages are 404 Not Found


#4

How do I make internal links of my Hugo site work?
I’m trying to fix the “404 Not Found” blank pages that I see when click any links in the menu or footer (Blog, Docs, Faq, etc.).


#5

What is the form of these links? Can you post an example?


#6

Did you create the content files?


#7

These links are like:
http://localhost:1313/blog/
http://localhost:1313/docs/

config.toml:

baseURL = "/"
languageCode = "en-us"
title = "Kube for Hugo"
theme = "kube"
description = "Kube is a professional  and a responsive Hugo theme for developers and designers that offers a documentation section mixed with a landing page and a blog"
Paginate = 4
[Params]
  RSSLink = "/index.xml"
  author = "newpixcom" # add your company name
  github = "" # add your github profile name
  twitter = "" # add your twitter profile
  email = "myemail@myaddress.xxx"

[[menu.main]]
    name = "Docs"
    weight = -100
    url = "/docs/"
[[menu.main]]
    name = "Blog"
    weight = -100
    url = "/blog/"
[[menu.main]]
    name = "Faq"
    weight = -100
    url = "/faq/"

server log:

Hugo$ hugo server
Started building sites ...

Built site for language en:
0 draft content
0 future content
0 expired content
0 regular pages created
6 other pages created
0 non-page files copied
0 paginator pages created
0 tags created
0 categories created
total in 2 ms
Watching for changes in /home/eva/Develop/Netlify/Hugo/{data,content,layouts,themes,static}
Serving pages from memory
Running in Fast Render Mode. For full rebuilds on change: hugo server --disableFastRender
Web Server is available at //localhost:1313/ (bind address 127.0.0.1)
Press Ctrl+C to stop

#8

You have no content, so it’s natural for those links to throw a 404.


#9

I didn’t create any files by myself yet, I’m trying to launch this theme: https://github.com/jeblister/kube
It has content files, in theme/kube/content there are folders blog, doc, faq with .md content files inside them.


#10

I have content files in this theme, but what should I do to make the server see them?
I have a content folder in theme/kube/content with blog, doc, faq folders and each of them has .md files inside.


#11

You need to copy the contents of theme/kube/content to /content at the root of your Hugo project.


#12

Many thanks, this worked! :upside_down_face: