vuepress-blog-template: 基于 vuepress 模板构建，用于快速搭建简洁的知识博客

# vuepress-blog-template

## 介绍
项目基于 VuePress1.9.9 构建的个人静态博客模板，采用 vuepress-theme-vdoing 主题，可快速搭建博客。

## 前提
确保 Node>=18.0.0版本。

## 安装与启动
```
git clone https://gitee.com/yisennno/vuepress-blog-template.git

cd vuepress-blog-template

npm install

npm run docs:dev
```

启动后，访问地址：http://localhost:8080/

## 目录结构
```
- docs
  - .vuepress
    - config.ts (全局配置，包括导航栏配置，侧边栏配置等)
    - public文件夹 (静态资源)
    - styles文件夹 (样式配置)
  - 一级文件夹 (博客内容分类，尽量遵循顺序命名)
    - 二级文件夹 (目录命名影响侧边栏顺序，按照从小到大排)
      - 具体md文件 (命名影响顺序，同上)
    - 01.导航.md (可选，用于记录所有二级目录和目录下的md文件)
  - index.md (主页配置)
  - todo.md (可选，临时页面)
```
需要注意：
- 一级文件夹“全局导航”，一般跳转二级文件夹的第一个md文件，如果没有则跳转导航md文件
- 创建md文件，会自动生成front matter(dev or build)，并且生成随机的link，默认为/pages/+ 6位字母加数字的随机码，link为路由关键

## 服务器部署
### ip访问
```
# 1.上传dev-ops文件夹到云服务器根目录，使用docker-compose安装并启动nginx
docker-compose -f docker-compose.yml up -d

# 2.构建html文件，构建的内容存放在dev-ops/nginx/html, 可以在config.ts中配置dest
npm run docs:build

# 3.IDEA配置SFTP上传html内容，也可以使用其他方式上传
Tools >> Deployment >> Configuration，配置SFTP，Mapping配置本地上传文件路径和服务器路径
```
访问地址: http://ip

### 域名访问及ssl证书配置
暂时没有域名，还是用ip访问，后续有了再完善文档

pengyisheng/vuepress-blog-template

简介

发行版

贡献者

近期动态

pengyisheng/vuepress-blog-template .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

pengyisheng/vuepress-blog-template