| home | actionText | actionLink |
|---|---|---|
true | Work-Life Balance → | /#Order |
:::tip Based on this repository, you can quickly create your own document website. Highlight syntax support list PrismJSShiki:::::tip automatically configures the menu bar and sidebar during compilation, with up to three-layer directory structure. :::::tip Many enthusiastic developers open source theme vuepress-theme :::
:::tip If you feel it is inconvenient to use VuePressvitepress, you can use the static blog writing client gridea :::
.
│ .gitignore git忽略文件
│ package-lock.json NPM依赖配置文件
│ yarn.lock yarn依赖配置文件
│ package.json 项目配置文件
│ README.md 首页md文件
│
├─.github GitHub配置目录
│ └─workflows Actions工作流目录
│ deloy.yml 项目的Actions部署配置
│
├─.vuepress 用于存放VuePress的配置、组件、静态资源等。
│ │ config.js VuePress配置
│ │ nav.js 除创建的目录之外,自定义添加的导航栏
│ │ push.js 自定义推送脚本
│ │ utils.js 侧边栏和菜单栏自动配置工具
│ │
│ ├─styles 用于存放样式相关的文件
│ │ │
│ │ └─index.styl 自定义全局样式文件
│ │
│ ├─public 静态资源目录
│ │ │ CNAME CNAME文件指定域名,防止发布时被清空
│ │ │ manifest.json 5+App(HTML5 Plus移动App)的配置文件
│ │ │ static.json heroku使用buildpack静态部署配置文件
│ │ │
│ │ ├─assets css/img/js等默认的存放路径
│ │ │ │
│ │ │ └─js 自定义js文件存放目录
│ │ │
│ │ ├─files 可直接访问并下载的文件存放目录
│ │ │
│ │ └─images 存放所有文档的图片目录
│ │ │
│ │ └─icons 存放图标目录
│ │
│ └─theme 主题存放目录
│
├─docs 编译后的静态资源文件输出目录
│
│
......其他自己的md文档或文件夹,都会打包到docs文件夹下,md文件会编译成html
That is to say, you only need to follow the above directory structure to modify your own document to use it. ::: warning Pay attention to the comment text part in the configuration file. Please understand its meaning in combination with the official VuePress document and then modify the configuration! :::
# 先克隆本仓库
git clone https://github.com/bajins/notes-vuepress.git
# 保留上面目录结构列出的文件和文件夹,其他的全部删除
# 使用前请自行安装Node.js环境
# 安装项目的全部依赖
npm install
# 这时创建并书写你自己的md文档
# 开始运行开发环境,然后访问窗口中的路径
npm run dev
# 修改.vuepress/public/CNAME中的域名
# 如果发布到GitHub请见:项目的Actions部署配置
# Actions教程:https://www.bajins.com/IDE/Git%E6%9C%8D%E5%8A%A1.html#actions
::: warning Note Make sure your Node.js version >= 8.6. :::