ParaN3xus's template for static blogs, based on a previous version of PoeMagie, powered by Astro, DaisyUI 4 and typst.

• Typst: Write blog posts in Typst.
• Tags: Categorize your blog posts with tags.
• Link Preview: Link Preview on Open Graph, Facebook, and Twitter.
• Click Stats, Like Reaction, and Comment: Powered by Vercount and giscus.

Typst-specific features:

• Heading Permalinks and Table of Contents.
• Automatically generates yearly PDF archive.

All commands are run from the root of the project, from a terminal:

Open using the default setting:

code .vscode/blog.code-workspace

Or customize it:

cp .vscode/blog.code-workspace .vscode/blog.private.code-workspace
code .vscode/blog.private.code-workspace

Install suggseted extensions:

• myriad-dreamin.tinymist, for writing blog posts in typst.
• astro-build.astro-vscode, for developing astro components.

Create a new blog post in content/article:

#import "/typ/templates/blog.typ": *
#show: main.with(
  title: "Title of the blog post",
  desc: [This is a test post.],
  date: "2025-04-25",
  tags: (
    blog-tags.misc,
  ),
)

The blog-tags index is defined in content/article/blog-tags.typ to ensure type safety. You can add your own tags by adding a new blog-tags index.

• .env: Configuration read by files, Please check defineConfig/env in astro.config.mjs for schema.
• src/consts.ts,src/components/BaseHead.astro: global metadata, font resource declarations, and the head component.
• src/styles/*: CSS styles.

Improve experience:

• More friendly content submodule for forks

Improve website:

• Last Modified Time
• Styling
  • Inline Raw
  • Blocky Raw
• Better theme-frame

• This theme is based off of the lovely PoeMagie.
• The astro integration is supported by astro-typst.
• The web styles are powered by TailwindCSS and DaisyUI 4.
• And, the lovely typst.