Hugo

There are 10 posts filed in Hugo (this is page 1 of 1).

Glossary plugin now available for Micro.blog and Hugo sites

As a result of this thread, I have developed a glossary plugin for Micro.blog! Thanks to @JohnPhilpin for his review and testing. The plugin is available in the Plugins directory, and more info on using the plugin is at the Github repo. Enjoy, and let me know if there are any questions!

In addition, the shortcode and data file within the repo can be used for standalone Hugo sites, so Hugo users should take a look as well. Credits go to Brian Wisti at Random Geekery for basically developing the entire concept!

Feedback on my zettelkasten experiment

I have decided to slow down my updates on this project, but I do have a few observations. Adding links to the OPML file was pretty easy in Drummer. I missed adding tags to some links, but will make a sweep of the over the next week. I did some re-arranging of categories, as well as added a lot of categories after the start. In the rendered file, I noticed (as well as a reader) that all the entries are fully expanded. I may experiment with trying to flatten the categories. Also, I have not explored using XSLT style sheets to render the OPML file. Still, my biggest benefit so far is that I am now entering links into the OPML file that I would have pasted in some other file, and they are categorized, which helps in navigation.

My Hugo-based zettelkasten site is lagging in updates. I chose to create a single Markdown file for each entry, and I found that it was a significant amount of typing, even though I was starting with text from the OPML file. My favorite feature of the site is being able to view links by tag. I will continue working to get this caught up with the OPML zettelkasten.

Final note: there are lots of good tools out there, this is what I chose to start with, so far it is working for me!

OPML Zettelkasten Update – Day 13

Added over 10 links today for my ZK file, new links in Mastodon, Blogging, and Writing, and added Agriculture and Directories categories. I reorganized the Podcasting section into Resources and History subsections to group the links better. There are 143 links in the OPML ZK, more than 10 links a day on average – wow! I also updated the Blogging category on my Hugo ZK site, still need to finish migrating the OPML content over. Also on the to-do list – playing with XSLT style sheets to view the OPML content by tags. However, the full ZK file list still looks pretty good.

OPML Zettelkasten Update – Day 6

Still managed to add over 10 links again to my ZK file (open tabs and some old links). As I have been going through my old links, I find that not all of them are worth saving – I guess that is a consequence of review/curation. I was able to get a start on a Hugo-based ZK site (see it in action here). I was able to get the Activism section added, will probably migrate one section a day. I will be creating a document soon on the setup.

A reader has suggested another ZK tool – Zettelstore – I will take a look at that soon.

OPML Zettelkasten Update – Day 4

I was able to add over 10 links today to my ZK file (today from my big link list and some open tabs). I created at least two more categories, and I like seeing my ZK growing. If I keep up this pace, I will have over 300 links in a month organized by categories and tags. Still ahead: duplicating the ZK using Markdown files and Hugo, and also playing with XSLT files to transform my OPML ZK into a tag-based ZK. I hope to make some progress on this during the weekend!

Another thought: when I started a work weblog, it was work at first. Once I got into the swing of things (adding more content), it became more and more useful. As I have been blogging more over the past two weeks, I find I am linking back to previous posts where I have “done some digging” in the past. My point is this – what you get out of something depends on what you put into it. Adding 10 links a day to my ZK seems doable, and I am creating a resource for myself (and others) that will be useful in the future. 

OPML Zettelkasten Update – Day 3

I was able to add another 10 links today to my ZK file (mostly taken from yesterday’s posts – it was EASY to copy outline headlines from other OPML files in the Drummer editor). I then had enough subject headings that I decided to re-arrange the order to be alphabetical. Of course, this was EASY in the Drummer outliner, so yay for that too. Just a note to pass on – the little orange XML icon in the upper right corner of the ZK page shows the raw OPML of the file.

I was able to make progress on the Markdown front, in that I FINALLY got the Hugo static site generator to render a site for the theme I wanted to use. Yesterday, I was struggling with configuration files and setup, and then found this page from Bryce Wray acknowledging that the Hugo Quick Start page needs some updates (at least for Windows users like me – YESSSS!). Also, I became aware of the fact that many Hugo themes have an “exampleSite” folder built in the theme directory, and I found a post from Infinite Ink describing how to get that to render in the Hugo development server (another YESSSS! can you tell I was a little frustrated?). My hope is to have a parallel zettelkasten using Markdown files by the weekend.

Enabling reverse order display of posts in Hugo for Book theme

In an earlier post, I mentioned an issue with rendering a website built with Hugo. In the build command, I had to specify the theme. Jack Baty pointed out the theme could also be added to a configuration file (config.toml) so as not to have to enter it each time at the command line.

My next problem was that I wanted the blog post part of the Book theme to display the posts in reverse chronological order. However, it was displaying my post in the middle of the example posts, and I could not figure out what was driving the order. Jack Baty suggested looking at the template file in /layouts/posts/list.html. I looked at that file in the Book theme directory, and started looking at the lists page on the Hugo documentation site. After some reading, I found an example that showed how to display content in reverse order based on the date specified within the file. I changed the third line in the file from:

{{ range sort .Paginator.Pages }}

to

{{ range .Pages.ByDate.Reverse }}

I also edited the Date field in the posts to all have the same format:

date: “2019-06-03”

Once I did that, I got the results i was looking for – hurray! It would have been nice if the theme had done this “out of the box”, but at least I figured it out.

 

Rendering a static site in Hugo

I am working on a project using the Hugo static site generator with the Book theme. When I looked at this command page, it looked like typing the word “hugo” at the base directory of my site would render the site to the public folder. However, when I did that, no index.html file was generated – grr! After some more searching, I figured out that if you are using a theme (like I am), the theme needs to be specified (“hugo -t book”). Once I added that flag, it worked! Oh, the joy….