IAK博客 (IAK Blog) is an open-source Astro blog theme that builds a static personal blogging site from Markdown content, with support for Douban book/movie marks, friend links, a sayings page, and several built-in convenience features.
What is IAK博客?
IAK博客 is a static blog theme built on the Astro framework, using Vue 3 components for interactive parts and TypeScript for the codebase, as shown by its HTML5, CSS3, TypeScript, Astro, and Vue 3 tech badges. It takes Markdown and YAML content as input — posts in /src/content/posts/, friend links in /src/content/friends/_index.yml, and book/movie/game marks in /src/content/mark/_index.yml — and produces a fully static website with SEO, OpenGraph, sitemap, and RSS support. The project is maintained as a GitHub repository with two demo sites: iak.dorakika.cn and blog.dorakika.cn.
Key Features
- Multiple theme configurations — Switchable themes are controlled through
/src/config.ts, with the page advertising "多种主题配置" (multiple theme configurations). - Content collections — The theme supports article pages, Douban book/movie/game marks, friend links, and a sayings page, all managed as Markdown or YAML content under
/src/content/. - SEO & OpenGraph — Includes search engine optimization, OpenGraph tags, sitemap generation, and a
robot.txtfile, plus automatic share image generation for pages. - Site dashboard — A sidebar panel shows tag collections and recent Douban marks, combining blog navigation with activity tracking.
- Random post jump — A random-article button lets visitors find a post without browsing the archive.
- Simple search — A lightweight site search feature is built in, with no external search service required.
- RSS subscription — An RSS feed is generated for readers using feed readers.
- Keyboard interactions — The theme includes keyboard-friendly navigation shortcuts, as listed in its feature set.
The tech stack is Astro with Vue 3 islands, TypeScript, and plain CSS; content is written in Markdown. For deployment, the repository includes Vercel-specific instructions, though other platforms can follow Astro's standard adapter documentation.
Who is it for?
- Personal bloggers who want a fast, static site where all content lives in Markdown files and there is no database or admin panel to maintain.
- Astro and Vue developers who want a customizable blog theme; editing
/src/config.tsand the content collections covers most customization needs. - Chinese-language writers who track books, movies, and games via Douban and want those marks displayed on their site, and who prefer the Twikoo comment system.
- Vercel users who want a one-click deployment from GitHub — the project works by importing the repository into Vercel directly.
What can you do with IAK博客?
- Publish Markdown posts — Drop a Markdown file into
/src/content/posts/and the site automatically generates a new article page with SEO and OpenGraph tags. - Track your Douban marks — Maintain a list of books, movies, games, etc. in
/src/content/mark/_index.ymlto display them in the dashboard and on a dedicated page. - Add friends and sayings — Configure friend links in
/src/content/friends/_index.ymland create new pages modeled onsrc/pages/friends.astro, including a sayings (说说) page. - Deploy to Vercel in minutes — Clone the repo, push to GitHub, import into Vercel, and the site goes live; only Twikoo comments require additional setup.
How does IAK博客 work?
The theme is a standard Astro project. Run yarn to install dependencies, yarn dev for a local development server, yarn build to create a static dist folder, and yarn preview to test the built output. The main configuration is in /src/config.ts, and content is written in Markdown and YAML under /src/content/. Deployment to Vercel is done by importing the GitHub repository directly; other platforms can use Astro's standard adapter system.
FAQ
Is IAK博客 free?
The repository is open source and deployable by anyone. There is no mention of a paid tier or license fee in the documentation, and the setup process only requires free tools like GitHub, Vercel, and Twikoo (which has its own free/paid options outside this project).
Does IAK博客 use Vue or Astro components?
It uses both: Astro components for static rendering and Vue 3 components for interactive parts. Because the site is static, Vue components may show a blank moment before hydration, and the author notes they may convert Vue components back to Astro components in the future.
How do I enable comments?
The theme integrates Twikoo comments. You must deploy Twikoo yourself, obtain its service address, and configure it. Other comment systems are not built in, but the author says pull requests are welcome.
What content types are supported?
Currently, the theme supports blog posts, Douban book/movie/game marks, friend links, and a sayings page. The author also mentions a possible future document mode for diaries or weekly logs.
How do I customize and extend the theme?
The main site settings live in /src/config.ts. To create a new page, copy src/pages/friends.astro and adapt it. Friends and marks are configured via YAML files in the content collections.
