The Metalog

Posted on Mar 9, 2023

Herein is a cookbook for working with ox-hugo, especially in regard to this log’s idiosyncratic patterns.

Read more about how ox-hugo works here.

My Sections

  • Log
  • Things
  • Recipes
  • Guides

Links to sections / subtrees can be written as \[\[Name of Subtee]], like this one: Example Subtree. You can also use \<\<metalog-inline-target>> for an inline link –

Example Subtree

This subtree is linked to from above example. And for an inline link that’ll take you back.

Inline Images

To include an inline image create an unnamed link to the path of the image. Images are stored in static/imgs, so a link can be formed like:

[[file:../static/imgs/fickle-hill-snow.jpg]]

Marking Posts as Drafts

To mark a post as a draft simply add an org TODO prefix., e.g.

** TODO Draft Post

Changing the styling

This hugo project uses a fork of the archie theme, and pulls in the theme as a git submodule.

To update the theme:

  1. Checkout the repo, initialize, and fetch the submodules:

    git clone --recurse-submodules git@github.com:jtmoulia/archie.git
    
  2. Make an edit to a file in the forked archie theme under themes/archie

  3. Commit and push the changes to the archie fork:

    cd themes/archie
    git commit -m "Example of a commit"
    git push origin
    cd ../..
    git add themes/archie
    git commit -m "Updated the theme"
    

Tasks

TODO Up the paragraph font size

TODO Remove “Things” category

TODO Rename Log -> Journal

I used to do a daily log, now my posts are intermittent and journalistic.