How I made my website

2024-05-23

As I Believe is Required When A Programmer Sets Up A Blog

I Will Now Describe How I Made It

Or really just what I can do.

Firstly, this site is hosted on Codeberg, a FOSS alternative to GitHub that uses Forgejo. Codeberg supports static website hosting (ala GitHub Pages), the way it does this is that it will look for either a repo with the name pages or if pointed to a repo, a branch on that repo called pages. I believe you can even manually point it to a specific branch as well.

Zola is the framework I am using for this blog. It is made in rust and allows me (now that it's setup) to make all my new posts as just new markdown files. I can insert code blocks like so:

fn main() {
    // Print text to the console.
    println!("Hello World!");
}

These blocks are highlighted with the gruvbox-dark colourscheme (the one I use when I code).

Additionally, extra features are also included in my "theme" called serene.

I Can Use Mathematical Formulae.

Which can be rendered using either KaTeX (as below) or typst.

$$
\frac{\sqrt{x^2+1}}{\sin(90\degree)}
$$

$$ \frac{\sqrt{x^2+1}}{\sin(90\degree)} $$

And Am Also Able To Make Graphs Using Mermaid.

flowchart LR
A[Hard] -->|Text| B(Round)
B --> C{Decision}
C -->|One| D[Result 1]
C -->|Two| E[Result 2]
  flowchart LR
A[Hard] -->|Text| B(Round)
B --> C{Decision}
C -->|One| D[Result 1]
C -->|Two| E[Result 2]

Although as dark users will see, the mermaid graphs don't yet support the colourscheme.

I shall not beholden myself to writing actually good or comprehensible blog posts and so will abruptly end this one here; without really having explained anything at all. Do pop back if you want to see me post inane ramblings about my programming projects whatever (there’s a cool tag system I will be using to categorise my posts for easy sorting).

Todeloo