Giving content a home

One folder per article ​

Keep writing beside its images and diagrams. The file tree becomes a small map of the work.

en/posts/my-first-note/
  index.md
  figures/
zh/posts/my-first-note/
  index.md

Connect translations by identity ​

Titles and addresses may change. Content identity should remain stable. Each translation shares an ID while retaining its own URL.

interface Translation {
  readonly id: string;
  readonly locale: string;
  readonly url: string;
}

Make publication explicit ​

A draft must be excluded from the published output, including its page, assets, and search data.