Why separate them

The screen template and the content source have different lifecycles. Structures such as the post list, detail page, and menu filters are managed by Astro files under src/, while the actual writing and attachments live under the top-level posts/ directory.

Writing rules

Each new post is created as one folder inside a menu directory.

posts/logs/260510-post-page-convention/main.mdx
posts/logs/260510-post-page-convention/main-en.mdx

If a post needs images, audio, or downloadable files, keep them in the same post folder. Common subfolders include images/, audio/, and files/.

Build checks

The build checks the following items.

  • The folder name follows <YYMMDD>-kebab-name.
  • main.mdx and translated MDX files use the same menu as the parent menu directory.
  • The date in each MDX file matches the folder date.
  • Posts with draft: true do not appear in public lists.