目录结构

最后更新于: 2025-12-06 17:39:04

目录结构

 1.
 2├── .github   (可选，GitHub 相关文件)
 3│   ├── workflows
 4│   │   ├── baiduPush.yml (可选，百度定时自动推送)
 5│   │   └── ci.yml (可选，自动部署)
 6├── docs (必须，不要修改文件夹名称)
 7│   ├── .vuepress （同官方，查看：https://vuepress.vuejs.org/zh/guide/directory-structure.html#目录结构）
 8│   ├── @pages (可选，自动生成的文件夹，存放分类页、标签页、归档页)
 9│   ├── _posts (可选，专门存放碎片化博客文章的文件夹)
10│   ├── <结构化目录>
11│   └── index.md (首页)
12├── vdoing (可选，本地的vdoing主题)
13├── utils  (可选，vdoing主题使用的node工具)
14│   ├── modules
15│   ├── config.yml (可选，批量操作front matter配置)
16│   ├── editFrontmatter.js (可选，批量操作front matter工具)
17├── baiduPush.sh (可选，百度推送命令脚本)
18├── deploy.sh (可选，部署命令脚本)
19│
20└── package.json

docs 文件夹名称请不要修改
docs/.vuepress 用于存放全局的配置、样式、静态资源等，同官方，查看详情(opens new window)
docs/@pages 此文件夹是自动生成的，存放分类页、标签页、归档页对应的.md文件，一般不需要改动
docs/_posts 专门用于存放碎片化博客文章，里面的.md文件不需要遵循命名约定，不会生成结构化侧边栏和目录页。
docs/<结构化目录> 请查看《构建结构化站点的核心配置和约定》。
docs/index.md 首页
vdoing 存放在本地的vdoing主题文件，如果你想深度的修改主题，首先要在docs/.vuepress/config.js中配置使用的主题指向这个文件。
config.js

1  module.exports = {
2    // theme: 'vdoing', // npm主题依赖包
3    theme: require.resolve('../../vdoing'), // 使用本地主题包
4  }

config.ts

1  import { resolve } from 'path'
2  import { defineConfig4CustomTheme } from 'vuepress/config'
3  import { VdoingThemeConfig } from 'vuepress-theme-vdoing/types'
4  export default defineConfig4CustomTheme<VdoingThemeConfig>({
5    // theme: 'vdoing', // 使用npm主题包
6    theme: resolve(__dirname, '../../vdoing'), // 使用本地主题包
7  })