Add a Blog Post
Use this skill when the user asks to add a new blog post
Steps
-
Choose a blog folder name
YYYY-MM-DD-short-slug(use the current date unless the user specifies one). -
Create
blog/<folder>/index.mdwith front matter:description: short summary stringslug: URL slug without dateimage:/img/blogs/<folder>/cover.<ext>tags: array (e.g.[MoonBit])
-
Add the H1 title and insert a cover image near the top:
. -
Copy the staging Markdown content into the blog
index.mdafter the front matter and cover. -
If the post includes videos, follow the existing pattern (see
blog/2024-04-18-ai-coding):- Place
.mp4(or.webm) files inblog/<folder>/. - Add
importstatements at the top ofindex.md. - Use
<video controls src={videoImport} style={{width: '100%'}}></video>in the body.
- Place
-
Copy referenced images/assets into
blog/<folder>/and ensure all./imagelinks resolve. -
Pick a cover image.
-
Copy the cover into
static/img/blogs/<folder>/cover.<ext>for the meta image path. -
If the staging post is English-only, Add a zh placeholder for English-only posts:
-
Create
i18n/zh/docusaurus-plugin-content-blog/<folder>/index.mdwith:--- unlisted: true ---
If the staging post includes Chinese content, Repeat steps 2-6 for the Chinese version in
i18n/zh/docusaurus-plugin-content-blog/<folder>/index.md. -
-
Remove the staging folder
Notes
- No Docusaurus config changes are required; the blog plugin picks up new folders automatically.
- Keep file paths and front matter ASCII-safe; avoid introducing new non-ASCII unless required.