开发技巧
开发技巧 介绍 Teek 开发路程的一些技巧。 规范 Teek 建议在进行项目开发时，一个文件的代码行数推荐 300 行以下，最好不超过 500 行，禁止超过 1000 行。 如果超过 300+ 行，应该考虑下是否可以拆分为多个文件，这是一个良好的 结构化思维和分治思维。 ::: tip Teek 建议您在开发前先思考有哪些模块，然后分别创建模块文件，而不是先在一个文件写完，再拆分。 :::...
15.主题开发
2025年9月28日
浏览量：--
共找到 8 篇文章
显示 8 / 8 篇文章
主题配置
主题配置 在主题开发中，往往需要提供一些配置来丰富主题的功能，最简单的是和 Vite Press 的 theme Config 配置合在一起： `ts {8} // .vitepress/config.mts import { define Config } from "vitepress"; export default define Config({ // ... theme Config:...
样式布局
样式布局 样式与组件分离 Teek 并没有和普通的 Vue 项目一样，使用如下模板进行编写组件： `vue // 组件逻辑 / 组件样式 / ` 而是使用： `vue // 组件逻辑 ` 那么组件样式去哪里了呢？ Teek 专门创建 theme-chalk/src/components 目录用于存放组件样式，然后将所有的组件样式汇总到一个 index.scss（入口样式文件），最后在...
Vite 插件
Vite 插件 Vite Press 处于 Vite 环境下，因此天然支持 Vite 插件。 Teek 有过一个想法，那就是将所有功能完全插件化，通过 NPM 下载各个插件来合并成主题： - 目录页插件 - 归档页插件 - 文章信息插件 - Footer 插件 - ... 这完全是可行的，每个插件都是独立的，支持任何 Vite Press 项目。 但是目前没有太多精力去实现这个计划，您可以通过...
目录结构
目录结构 Teek 的目录结构如下： `sh packages. ├─ components 组件目录，具体内容请看「组件布局的目录结构」 ├─ config 配置文件目录，在 .vitepress/config.mts 文件中引入 ├─ helper 工具类目录 ├─ composables composables 目录 ├─ locale 国际化文件目录 ├─ markdown...
组件结构
组件结构 一个项目的功能组件虽然有很多，但是入口组件只有一个，如果您不知道这些功能组件都在哪里执行，不妨从入口组件开始解读，一步一步往下延伸，最终把项目功能吃透。 Teek 在首页、文章页、空白页、全局都写了组件来实现功能，但是这些组件并不是分开引入，而是统一在 Layout 组件里引入，并派发到 Vite Press 不同的插槽，如： `vue import Default Theme...
容器自定义
容器自定义 Teek 提供了两种创建容器的 API，这两种容器 Teek 分别命名为 Simple 容器、Card 容器。 Teek 容器都有哪些？请看 Markdown 拓展。 容器 API 请看 Markdown 插件工具 Simple 容器 Vite Press 的 info、tip、warning、danger 容器都是 Simple 容器，其原理是添加 div 来包裹 Markdown...
开发思路
开发思路 ::: note 摘要 只要会编写 Vue 组件，那么就可以发挥您天马行空的想象力，来构建自己的主题。 ::: right 2025-03-17 @Teek ::: 本系列为 主题开发，主要介绍 Teek 的开发思路，当然这只是提供思路，不会细到每一个文件的逻辑讲解。 在阅读完本系列内容后，您可以去阅读 Teek 的源码，了解 Teek 的实现思路，也许对您的主题开发之路有些帮助。...