title: 目录结构 date: 2020-05-11 13:54:56

permalink: /pages/2f674a

  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 用于存放全局的配置、样式、静态资源等，同官方，查看 详情

  • docs/@pages 此文件夹是自动生成的，存放分类页、标签页、归档页对应的.md文件，一般不需要改动

  • docs/_posts 专门用于存放碎片化博客文章，里面的.md文件不需要遵循命名约定，不会生成结构化侧边栏和目录页。

  • docs/<结构化目录> 请查看《构建结构化站点的核心配置和约定》。

  • docs/index.md 首页

  • theme-vdoing 存放在本地的vdoing主题文件，如果你想深度的修改主题，首先要在docs/.vuepress/config.js中配置使用的主题指向这个文件。

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

    注意：主题的后续维护升级只对npm主题包负责，就是说你使用本地主题就等于放弃了后续的升级服务。因此，能在docs/.vuepress/内配置和修改的，就尽量不要改动主题内部代码。

::: tip 提示 为了方便您更快的学习和使用本主题，我在代码当中添加了比较多的注释说明。 :::