..

how do i blog

This is a meta post in order to teach myself from the future how to do it!

I often spend a few weeks without the desire to write anything in my blog (I should fix that but let’s be real first), but at some moment I do want to type some letters down.. but they I freeze.. how do I do it?

These are the steps I used to write this blog post starting from complete scratch:

  1. I use hugo.

  2. These are the relevant commands run using Hugo

    hugo new site wandersoncferreira
    hugo new posts/first.md
    cd themes/
    git submodule add git@github.com:wandersoncferreira/hugo-theme-nostyleplease.git
    
  3. I use Emacs

  4. My Emacs has a ox-hugo plugin enabled

  5. These are the relevant lines to configure ox-hugo properly

    (after! ox-hugo
      (setq org-hugo-base-dir "~/code/wandersoncferreira.github.io"
            org-hugo-section "posts"))
    
  6. I wrote an org file inside the orgfiles folder

  7. I had to add some special meta information in the header of the file:

    1. #+title:
    2. #+date: created using M-x org-time-stamp
    3. #+draft: true or false
    4. [OPTIONAL] #+author:
    5. [OPTIONAL] #+filetags:
      1. are you wondering why filetags and not only tags? The answer is waiting for you
  8. Time to publish

    1. spc m e to run org-export-dispatch
    2. H to export to ox-hugo
    3. commit all the files

A clever github action will handle everything from here onwards!