পোস্ট লেখা

পোস্টগুলো থাকে src/posts/ ডিরেক্টরিতে (postsDir দিয়ে কনফিগার করা যায়)। প্রতিটি পোস্ট একটি .md ফাইল। ফাইলের নাম (.md বাদ দিয়ে) হয়ে যায় slug এবং /posts/ এর নিচে URL পাথ।

Frontmatter

src/posts/my-post.md

---
title: A new beginning
date: 2026-04-17
author: Dongsheng
tags: [svelte, web]
category: engineering
excerpt: কার্ড এবং RSS এ দেখানোর এক-লাইনের সারসংক্ষেপ।
cover: /covers/new-beginning.jpg
draft: false
---

frontmatter এর নিচে markdown এ লিখুন।

ফিল্ড	টাইপ	বাধ্যতামূলক	নোট
`title`	string	হ্যাঁ	পোস্টের hero সেকশন এবং লিস্ট কার্ডে দেখানো হয়।
`date`	string	হ্যাঁ	ISO তারিখ (`YYYY-MM-DD`)। সর্ট অর্ডার এবং টাইমলাইন গ্রুপিং নির্ধারণ করে।
`excerpt`	string	সুপারিশকৃত	সংক্ষিপ্ত বর্ণনা। কার্ড, RSS, OG তে ব্যবহৃত হয়। না দিলে থিম পোস্টের বডি থেকে একটি তৈরি করে।
`tags`	string[]	—	পোস্ট টাইটেলের নিচে pill লিংক হিসেবে রেন্ডার হয়। প্রতিটি ট্যাগের জন্য `/tags/<name>/` পেজ তৈরি হয়।
`category`	string	—	প্রতি পোস্টে সর্বোচ্চ একটি। `/categories/<name>/` পেজ পায়।
`author`	string	—	এই পোস্টের জন্য সাইট-ওয়াইড `author.name` ওভাররাইড করে।
`cover`	string	—	কভার ইমেজের পাথ বা URL। সেট করলে পোস্টটি `PostCardLarge` দিয়ে রেন্ডার হয়; না হলে থিম ট্যাগ-হ্যাশ করা gradient বেছে নেয়।
`draft`	boolean	—	ড্রাফট বিল্ড হলেও লিস্টিং, RSS, OG ইমেজ জেনারেশন এবং টাইমলাইন থেকে বাদ থাকে।

লিস্টিং

হোম পেজ (/) সর্বশেষ পোস্টকে ফিচার করে সব পোস্ট ম্যাসনরি গ্রিডে দেখায়।
/timeline/ সব নন-ড্রাফট পোস্টকে মাস অনুযায়ী গ্রুপ করে দেখায়।
/tags/ সব ট্যাগ এবং পোস্ট কাউন্ট দেখায়।
/categories/<name>/ এবং /tags/<name>/ সেই taxonomy অনুযায়ী পোস্ট ফিল্টার করে দেখায়।

Excerpt

excerpt না দিলে থিম পোস্টের বডির প্রথম প্যারাগ্রাফ থেকে একটি তৈরি করে। নিয়ন্ত্রণ রাখতে সবসময় excerpt স্পষ্টভাবে সেট করুন — বিশেষত যেসব পোস্ট ইমেজ বা কোড ব্লক দিয়ে শুরু হয়।

রিডিং টাইম

শব্দ সংখ্যার উপর ভিত্তি করে রিডিং টাইম স্বয়ংক্রিয়ভাবে হিসাব হয় এবং পোস্ট কার্ড, টাইমলাইন ও পোস্ট মেটা স্ট্রিপে দেখানো হয়। শব্দ গণনা হয় রেন্ডার হওয়া HTML এ।

ড্রাফট

পাবলিক লিস্টিং থেকে দূরে রাখতে frontmatter এ draft: true দিন। পোস্টটি বিল্ডের সময় ডিস্কে লেখা হয় (যাতে প্রি-পাবলিশ শেয়ার করা লিংক এখনও কাজ করে), কিন্তু হোম গ্রিড, RSS, টাইমলাইন বা OG ইমেজ সেটে আসবে না।

পাবলিশ করতে draft: false করুন।