narmnevis.github.io

A bilingual (Persian/English) technical blog, built with Zola and just.

Structure

config.toml           # Zola site config (bilingual FA+EN, feeds, sass)
content/
  _index.md           # EN landing page
  _index.fa.md        # FA landing page
  blog/
    _index.md         # EN posts section
    _index.fa.md      # FA posts section
    YYYY/MM/
      post.fa.md      # Persian post  (lang = "fa", dir = "rtl" in [extra])
      post.md         # English post  (lang = "en", dir = "ltr" in [extra])
templates/
  base.html           # Tera base template (lang/dir from page.extra)
  index.html          # Landing page
  page.html           # Blog post
  section.html        # Post listing
sass/
  main.scss           # Stylesheet (RTL-aware, GitHub markdown style)
static/
  _template.html      # pandoc template (compat, for build-post/build-pdf)
  default.css         # pandoc stylesheet (compat)
  disqus.html         # Disqus snippet (used by page.html template)
Justfile              # Build recipes
mise.toml             # Tool versions (zola 0.19.2)

Getting started

just install   # install zola via mise (first time only)
just serve     # local dev server at http://localhost:1111 with live reload
just build     # production build → public/
just check     # validate internal links

Writing a post

Persian post

Create content/blog/YYYY/MM/my-post.fa.md:

+++
title = "عنوان نوشته"
date = YYYY-MM-DD

[extra]
lang = "fa"
dir = "rtl"
keywords = ["کلیدواژه"]
+++

متن نوشته در اینجا...

Then add a transparent _index.fa.md in each new year/month subdir if it doesn't exist:

+++
transparent = true
render = false
+++

English post

Create content/blog/YYYY/MM/my-post.md (same structure, lang = "en", dir = "ltr").

Multilingual routing

File suffix	URL	Language
post.fa.md	/fa/blog/YYYY/MM/post/	Persian (RTL)
post.md	/blog/YYYY/MM/post/	English (LTR)

Pandoc compat

The old pandoc setup is preserved for one-off use:

just build-post content/blog/YYYY/MM/post.md   # → .html via pandoc
just build-pdf  content/blog/YYYY/MM/post.md   # → .pdf via XeLaTeX

Dependencies

• zola — static site generator (managed via mise)
• just — command runner
• mise — tool version manager
• pandoc + XeLaTeX (optional, for build-post / build-pdf)