一个仅需三步配置就能生成免费个人博客的开源模板vdoing-template

文章发布较早，内容可能过时，阅读注意甄别。

# 前言

项目地址： https://github.com/eryajf/vdoing-template (opens new window)

vdoing-template

Vdoing主题博客模板.

- name: vdoing-template
  desc: Vdoing主题博客模板.
  avatar: https://avatars2.githubusercontent.com/u/416130?s=460&u=8753e86600e300a9811cdc539aa158deec2e2724&v=4 # 可选
  link: https://github.com/eryajf/vdoing-template # 可选
  bgColor: "#0074ff" # 可选，默认var(--bodyBg)。颜色值有#号时请添加单引号
  textColor: "#fff" # 可选，默认var(--textColor)

1
2
3
4
5
6

⚗️ 功能亮点：

三步配置生成一个属于自己的免费个人博客。
使用Vdoing (opens new window)主题，感谢作者写出如此简洁美观的博客主题。
模板已内置集成全文搜索能力。
模板已内置集成基于 GitHub Issue 的 vssue 评论系统。
本地 Markdown 编写文档，提交到远程之后 GitHub Actions 自动构建发布。

🦩 以下仅需简短的几步配置，就可以配置拥有一个免费的个人博客。准备好了吗，来吧

# 效果展示

首页效果图：

内部文章效果：

如果你也想要一个这种效果的博客，请往下看，只需简单几个配置步骤，即可免费拥有。

# 初始配置

首先访问模板仓库：vdoing-template (opens new window)。点击此仓库右侧的 Use this template

然后根据自己的实际情况，给仓库起名字：

这里有一个注意点：仓库的名字将会是 GitHub Pages 的访问一级路由。比如上边我仓库名字定义为：lql-notes，那么配置成功之后的首页访问路径是： https://lql95.github.io/lql-notes ，如果你想让首页的访问路径是根，那么只需把仓库名字命名为：lql95.github.io。

创建完成之后，自己仓库中的项目内容如下：

然后将代码克隆到本地，使用编辑器打开：

$ git clone git@github.com:lql95/lql-notes.git

# 调整内容

接下来的操作就是将模板中的内容，替换成自己想要的内容，好在模板我已经精简了很多，不需要繁琐的配置，这里简单说明一下：

# 全局替换关键字

这样基本上就搞定了配置内容的一大步，剩下的就是一些修改美化方面的内容了。

# 配置首页

首页的配置信息在 docs/index.md 这个文件当中，我们可以参照官方文档进行按需配置：点我去看文档 (opens new window)

# 配置评论

模板默认内置了 vssue 的评论组件，也是基于 github 的 issue 作为评论的存储数据。

只需两步即可完成配置：

第一步：参考官方文档 (opens new window)，创建一个GitHub OAuth App。或者不用看官方文档，直接看如下两个步骤。

点击此处 (opens new window)，进入创建页面：

点击注册之后，就进入到了详情页面，可以看到Client ID，点击 Generate a new client secret 生成一个秘钥：

第二步：将配置信息填写到 docs/.vuepress/config.js 中。

// vssue 评论插件
  plugins: [
    [
      "vuepress-plugin-vssue-global",
      {
        platform: "github",
        title: "[Comment]<%- frontmatter.title %>",
        needComments: true,
        // 其他的 Vssue 配置
        autoCreateIssue: true,
        clientId: "d3ec4ca6363950ca41a2",
        clientSecret: "897465b6393f1d663e6128d2fab6959a0c0333cc",
        owner: "lql95",
        repo: "lql-notes",
      },
    ],
  ],