{"id":10236,"date":"2023-07-26T11:29:17","date_gmt":"2023-07-26T09:29:17","guid":{"rendered":"https:\/\/www.main-vision.com\/richard\/blog\/?p=10236"},"modified":"2023-07-26T11:29:34","modified_gmt":"2023-07-26T09:29:34","slug":"yq-frontmatter-and-jekyll","status":"publish","type":"post","link":"https:\/\/www.main-vision.com\/richard\/blog\/yq-frontmatter-and-jekyll\/","title":{"rendered":"YQ, FrontMatter and Jekyll"},"content":{"rendered":"Reading Time: <\/span> 4<\/span> minutes<\/span><\/span>\n

For two days I have been trying to understand how to use Jekyll, a Ruby version of Hugo. It is a Static website generator that is similar to Hugo but rather than being written in Go, it is written in Ruby. I find that it renders sites faster than Hugo, but that it has less assistance for creating pages, giving them layouts and the rest. That’s why I experimented with YQ<\/a><\/p>\n\n\n\n

a lightweight and portable command-line YAML, JSON and XML processor. YQ<\/a> uses jq like syntax but works with yaml files as well as json, xml, properties, csv and tsv. It doesn’t yet support everything jq does – but it does support the most common operations and functions, and more is being added continuously.<\/p>\n\n\n\n

I read about it in this article<\/a>. You can install YQ<\/a> with a brew command brew install yq or you can install it in a number of other ways, depending on whether you’re using MacOS, Linux or Windows.<\/p>\n\n\n\n

The Use case<\/strong><\/p>\n\n\n\n

Exporting a WordPress blog to MD files can be done with a multitude of tools but they don’t add all the FrontMatter that you need for a blog, especially Jekyll. I imported the most recent blog posts, that I created for Hugo, with a year-month-date-title.md name to the posts folder but I created a second one for the archive. As the file title was different Jekyll did not like the files. The problem was the file name format, so that’s why I created a separate directory.<\/p>\n\n\n\n

Side Note on Reading the Archives MD Files<\/strong><\/p>\n\n\n\n

Bard’s help<\/a>: I provide this to help you understand Jekyll logic, as well as Bard help.<\/p>\n\n\n\n

Getting It To Work On MacOS<\/strong><\/p>\n\n\n\n

In the article about using YQ to edit FrontMatter for Hugo pages the first part worked fine, but it’s written for Linux rather than macOS so some commands failed. This is where Bard comes in.You can ask Bard to explain what parts of a line of code or a command does and it will explain it to you, and you can eventually transfer the command that is understood by one OS and get it to work with the other.<\/p>\n\n\n\n

I tried this find -name “*.md” -exec yq –front-matter=”process” ‘.updated_at = now’ {} \\; but it failed to work. Bard was kind enough to explain the options<\/a> for me to figure out which options to use. I added the correct path, and specified that I was looking for the files with the ‘type f’ flag.<\/p>\n\n\n\n

find .\/_posts -type f -name “*.md” -exec yq ‘.title’ {} \\; To see the title of .md files <\/p>\n\n\n\n

I wanted to add these two lines to the FrontMatter of the files in the relevant folder.<\/p>\n\n\n\n

I tested find ..\/unprocessed “*.md” -exec yq –front-matter=”process” ‘.updated_at = now’ {} \\; and this works but does not make changes.<\/p>\n\n\n\n

This works and updates the pages to add the updated at field to the metadata with the keyword now. The -i tells it to write to the file.<\/p>\n\n\n\n

The full command is find ..\/unprocessed -name “*.md” -exec yq e –front-matter=”process” ‘.updated_at = now’ -i {} \\; works to add updated now tag .<\/p>\n\n\n\n

Implementing the Required Change<\/strong><\/p>\n\n\n\n

The lines that I wanted to add to the front matter were ‘layout: post’ and ‘categories: [archives]’. After the trial and error described above I tried:<\/p>\n\n\n\n

find ..\/unprocessed -name “*.md” -exec yq e –front-matter=”process” ‘.updated_at = now’ -i {} \\; works to add updated now tag<\/p>\n\n\n\n

find ..\/unprocessed -name “*.md” -exec yq e –front-matter=”process” ‘.layout = post’ -i {} \\; works to add updated now tag<\/p>\n\n\n\n

Finally the command to make a permanent change was:<\/p>\n\n\n\n

find ..\/_archives -name “*.md” -exec yq e –front-matter=”process” ‘.layout = “post”‘ -i {} \\; <\/p>\n\n\n\n

find ..\/_archives -name “*.md” -exec yq e –front-matter=”process” ‘.categories = “[categories]”‘ -i {} \\; <\/p>\n\n\n\n