More adventures on the PI, I have lost my Hugo Markup for dlf.ddns.net; fortunately it is not a big site. There are no automatic reverse engineering tools and so I’ll have to do it the long way round. So this is version 4. I have a page called Hugo on this site.
Version 4
I installed on Ubuntu and used apt to install it. This maybe missing extended functionality.
And now, let’s restate some of the comments made on V3 on the older page.
Version 3
I had another go, it seems I have forgotten a lot. The ananke theme has changed and is now very ugly.
- https://gohugo.io/getting-started/quick-start/, from download to publication; remains useful
- hugo theme: introduction, this is the theme I chose to use, which I found in Hugo’s directory
And generically
- A hint on directory structures by Jake Wiesler, these are complicated by the introduction author’s use of an example site within the themes directory, we don’t want to be doing with that this time.
- A note on making posts from Meriman Labs
Notes on Markdown
Draft needs to be false to be pushed into the local server
Rengineering
There is no re-engineering tool, why would there be? Everyone backs up their servers don’t they?
However, there is a tool, PanDoc which converts various formats. They say, “If you need to convert files from one markup format into another, pandoc is your swiss-army knife.” It goes on ubuntu via apt.
Hugo arguments
To create a publication candidate, use hugo with no parameters unless the -t parameter is needed to force a theme. It creates a folder public in the folder containing the config.toml. The target public folder needs to be empty. I run hugo from ./examplesite. There is a bug on the 404 page.
I need to run hugo new from ./examplesite specifying the name of the markdown file with a relative path. and reference to the theme folder e.g.
hugo new ../content/$lang/blog/${name}.md -t ../..
The document’s suggest issuing the command from the site home directory and that new pages will be written into the content folder i.e. ../blog/index.md becomes ./content/blog/index.md
Draft needs to be false to be pushed into the local server