腾讯云部署vitepress,高颜值文档博客

首先上官方网站。https://vitepress.dev/

先看两张效果图。

请在此添加图片描述

请在此添加图片描述

一定要用这个官网,之前看了一个翻译版本,好像翻了一半不弄了,坑了半天时间也解决不了。目前看起来还没有官翻。

目前使用到的是腾讯云的轻量应用服务器,效果还是非常好的,感觉也比较划算。

下边一步步鼓捣配置。

安装node

这个教程比较多了,就不再细说了

安装vitepress依赖

mkdir viteblog // 新建博客目录
npm init // 新建node环境
npm install -D vitepress // 安装vitepress
npx vitepress init // 安装向导

本教程使用的配置如下:

请在此添加图片描述

默认的文档及编译后静态文件产出都存放到 docs 下边。

运行一下看看效果,感觉还是非常不错的。

npm run docs:dev

一般来说要用的话还需要加上点数据统计。

在 .docs/config.ts里边加入如下配置,以Google统计为例。

export default defineConfig({
  title: "xyccstudio",
  description: "xyccstudio",
  head: [
    [
      'script',
      {
        async: '',
        src: 'https://www.googletagmanager.com/gtag/js?id=G-xxxx'
      }
    ],
  ],
  themeConfig: {
    // ...
  }
})

之后就能在调试器里边看到如下内容:

请在此添加图片描述

一般来说还需要增加点图片等静态文件。

在 .docs 的文件下新建一个public的文件夹,之后在markdown中直接使用即可,譬如说放了文件 logo.png 那么使用的路径就是 /logo.png 。

部署的时候由于可能不是根目录,因此需要稍稍修改一下部署路径。

譬如说想要部署在 https://www.xyccstudio.cn/books/ 路径下,那么在config.ts 下增加

export default defineConfig({
  // ...
  base: 'books',
  // ...
})

之后直接 build 并且部署就完成了。编译的默认文件是 ./docs/.vitepress/dist

以下是一个当前使用中的例子,有兴趣可以看一下。

https://www.xyccstudio.cn/books/

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

xyccstudio

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值