@velonor/engine 是一个面向 VitePress 的博客微引擎，提供可复用的逻辑与数据能力，帮助你快速开发一个属于你自己的博客主题。

---

1. 安装

npm i @velonor/engine

---

2. 构建期 data 文件

posts 数据

// packages/theme/src/posts.data.js
import { createPostsLoader } from '@velonor/engine/loader';
export default createPostsLoader('posts/**/*.md');

tags / categories / archive / page-links

// packages/theme/src/tags.data.ts
import { createTagsLoader } from '@velonor/engine/loader';
export default createTagsLoader('posts/**/*.md');

// packages/theme/src/categories.data.ts
import { createCategoriesLoader } from '@velonor/engine/loader';
export default createCategoriesLoader('posts/**/*.md');

// packages/theme/src/archive.data.ts
import { createArchiveLoader } from '@velonor/engine/loader';
export default createArchiveLoader('posts/**/*.md');

// packages/theme/src/page-links.data.ts
import { createPageLinksLoader } from '@velonor/engine/loader';
export default createPageLinksLoader(['**/*.md']);

---

3. 运行期使用

分页

import { usePagination } from '@velonor/engine/client';
import { data as posts } from '../posts.data.js';

const { currentPage, paginatedItems } = usePagination(posts, { pageSize: 5 });

标签/分类

import { createTagsStore, createCategoriesStore } from '@velonor/engine/client';
import { data as posts } from '../posts.data.js';

const useTags = createTagsStore(posts);
const useCategories = createCategoriesStore(posts);

---

4. 页面 frontmatter 约定

---
layout: blog | tags | categories | archive
---

page-links 会自动扫描这些 layout，用于生成跳转链接。

---

完成。你可以直接写主题组件使用这些 data 与 composable。