主题开发指南

主题包负责页面布局、主题样式和主题级插件声明,不应在布局组件中重新实现文章扫描、评论或搜索等业务逻辑。

主题包结构

themes/my-theme/
├── package.json
└── src/
    ├── index.ts
    ├── layouts/
    │   └── Home.tsx
    └── theme.css

导出主题配置

import type { CogitaTheme } from '@cogita/shared';

export function getThemeConfig(): CogitaTheme {
  return {
    name: '@cogita/theme-my-theme',
    pageLayouts: { home: './layouts/Home.js' },
    plugins: [],
  };
}

主题只声明能力。插件工厂负责校验自己的配置,主题通过 plugins 声明所需插件;Core 负责校验主题首页布局和插件布局契约。

发布和消费

主题包应有自己的 package.json、构建配置和版本。消费者直接安装该包并引用包名。Core 不绑定特定主题,因此生态可以扩展而不需要持续修改框架 Core。

可以复制主题模板获取可运行骨架。模板包含 pageLayouts.home、React 布局、全局样式和独立包构建配置。

验证主题

pnpm --filter @cogita/theme-my-theme build
pnpm run build:packages
pnpm exec cogita build

完整契约请参考 API 参考 和插件 API 规范。