New site!

Overview

Finally putting my website back up after a year; I haven’t firewalled or otherwise secured myself out of this server yet, and I think I’m safe at this point.¹

This new website is rebuilt on Zola after spending half an hour failing to get my old Eleventy repo to build.²

It’s been stable and reliable for 6 months so far.

It’s not much, but it’s home.

Todo

• Fix feed icons on mobile/small screens
  
• Add a projects page?
• Flesh out this post.
• Continue testing with submodule repos
• Document setup
• Add notifications on successful update
• Update convert-markdown.sh to replace indented image links
• Fix newline in numbered lists
• Remove Todo list from this page

This site’s editing process

1. Open obsidian on computer/tablet/phone (Android devices sync regularly via git, committing only when changes are made)

2. CTRL+P > AddPost to use the QuickAdd Obsidian plugin to create a post from a template

   
   

3. Edit site in Markdown/Reader view (I should have given these links )

   

   Drafts don’t post; The date is automatically added when the post is created. Tags are used to list all posts with tag.

   

4. CTRL+P > Commit-And-Sync Pulls and pushes to site git repository, Gitea’s workflow handles it from there

Site Setup

Dependencies

Software:

• Obsidian
• Zola
• Gitea (May change to Forgejo)

Repos needed:

• Site content / Obsidian Notebook
• Site theme

Gitea actrunners:³

• Local actrunner
• Debian actrunner

Gitea Workflow

Gitea build-and-update-site workflow handles building & updating site files:

• Job 1: update-content-from-notebook (runs on Local actrunner)

• Get site repository
• Update theme submodule
• List build content
• Clean old build files
• Build site content: convert-markdown.sh --build --copy
• List site repository content
• Add and commit changes to site repository

Build site content / convert-markdown.sh:

• Prepares files and cleans old folders
• Converts Obsidian markdown to standard markdown
• Replaces tags and image links where needed

• Job 2: build-site-content (runs on Debian actrunner)

• Get site repository
• Get theme submodule
• Check and install Zola and NodeJS if needed (I haven’t bothered to rebuild the docker image)
• Clean old public files locally
• Clean old public files in CI release path
• Build site content with Zola
• Copy built content to release folder

• Job 3: update-live-site-files (runs on Local actrunner)

• Show CI release path file tree
• Clean old public files in live site path
• Copy files from CI release path to live site path
• List live site path contents

#code #projects