A collection of notes, thoughts, and ideas, or whatever I feel like writing about.

Visit the blog

Making this blog yours

This blog is built using a fork of zola, a static site generator written in Rust. You can read about the changes I made in the README.

Getting up and running

1. Clone the repository

git clone https://github.com/cestef/blog.cstef.dev.git
cd blog.cstef.dev

2. Install zola

Homebrew

brew install cestef/tap/zola

Cargo (manual)

git clone https://github.com/cestef/zola
cd zola
cargo install --path .

3. Install node dependencies

pnpm install

4. Start the development server

pnpm dev

This will start both zola and tailwindcss in watch mode.

Writing content

This blog uses an extended version of the markdown syntax.

Frontmatter

Front matter is a block of TOML at the beginning of a file that specifies metadata (title, date, etc.) about the file. It is delimited by +++.

+++
title = "My awesome post"
description = "A short description of the post"
date = 2021-08-01

[taxonomies]
tags = ["rust", "zola"]
+++

Math (SSR)

Currently, only rendering via typst is supported. To render math, use the following syntax:

Display math

$$
lim_(x->oo) (1 + 1/x)^x
$$

Inline math

$lim_(x->oo) (1 + 1/x)^x$

Raw math

Raw math is rendered using typst but without any additional formatting. See it as just rendering a file.

```typ
#set text(20pt)
#align(center + horizon)[
    $ lim_(x->oo) (1 + 1/x)^x $
]
```

Diagrams (SSR)

Diagrams are rendered using pikchr. To render a diagram, use the following syntax:

```pikchr
box "Hello, World!"
```