二丫讲梵 二丫讲梵
首页
  • 最佳实践
  • 迎刃而解
  • Nginx
  • Php
  • Zabbix
  • AWS
  • Prometheus
  • Grafana
  • CentOS
  • Systemd
  • Docker
  • Rancher
  • Ansible
  • Ldap
  • Gitlab
  • GitHub
  • Etcd
  • Consul
  • RabbitMQ
  • Kafka
  • MySql
  • MongoDB
  • OpenVPN
  • KVM
  • VMware
  • Other
  • ELK
  • K8S
  • LLM
  • Nexus
  • Jenkins
  • 随写编年
  • 家人物语
  • 追忆青春
  • 父亲的朋友圈
  • 电影音乐
  • 效率工具
  • 博客相关
  • Shell
  • 前端实践
  • Vue学习笔记
  • Golang学习笔记
  • Golang编程技巧
  • 学习周刊
  • Obsidian插件周刊
关于
友链
  • 本站索引

    • 分类
    • 标签
    • 归档
  • 本站页面

    • 导航
    • 打赏
  • 我的工具

    • 备忘录清单 (opens new window)
    • json2go (opens new window)
    • gopher (opens new window)
    • 微信MD编辑 (opens new window)
    • 国内镜像 (opens new window)
    • 出口IP查询 (opens new window)
    • 代码高亮工具 (opens new window)
  • 外站页面

    • 开往 (opens new window)
    • ldapdoc (opens new window)
    • HowToStartOpenSource (opens new window)
    • vdoing-template (opens new window)
GitHub (opens new window)

二丫讲梵

行者常至,为者常成
首页
  • 最佳实践
  • 迎刃而解
  • Nginx
  • Php
  • Zabbix
  • AWS
  • Prometheus
  • Grafana
  • CentOS
  • Systemd
  • Docker
  • Rancher
  • Ansible
  • Ldap
  • Gitlab
  • GitHub
  • Etcd
  • Consul
  • RabbitMQ
  • Kafka
  • MySql
  • MongoDB
  • OpenVPN
  • KVM
  • VMware
  • Other
  • ELK
  • K8S
  • LLM
  • Nexus
  • Jenkins
  • 随写编年
  • 家人物语
  • 追忆青春
  • 父亲的朋友圈
  • 电影音乐
  • 效率工具
  • 博客相关
  • Shell
  • 前端实践
  • Vue学习笔记
  • Golang学习笔记
  • Golang编程技巧
  • 学习周刊
  • Obsidian插件周刊
关于
友链
  • 本站索引

    • 分类
    • 标签
    • 归档
  • 本站页面

    • 导航
    • 打赏
  • 我的工具

    • 备忘录清单 (opens new window)
    • json2go (opens new window)
    • gopher (opens new window)
    • 微信MD编辑 (opens new window)
    • 国内镜像 (opens new window)
    • 出口IP查询 (opens new window)
    • 代码高亮工具 (opens new window)
  • 外站页面

    • 开往 (opens new window)
    • ldapdoc (opens new window)
    • HowToStartOpenSource (opens new window)
    • vdoing-template (opens new window)
GitHub (opens new window)
  • 最佳实践

  • 迎刃而解

  • Nginx

  • Php

  • Zabbix

  • AWS

  • Prometheus

  • Grafana

  • Loki

  • CentOS

  • Supervisord

  • Systemd

  • Docker

  • Docker-Compose

  • Rancher

  • Ansible

  • OpenLdap

  • GitLab

  • GitHub

    • GitHub中开源项目维护流程手册
    • 分享我的开源项目Thank-Mirror
    • 2024年重磅开源项目 awesome-ops 已收录项目500个
    • 分享我的开源项目Cloud_Dns_Exporter,妈妈再也不担心我忘换证书了
    • 一个仅需三步配置就能生成免费个人博客的开源模板vdoing-template
      • 前言
      • 效果展示
      • 初始配置
      • 调整内容
        • 全局替换关键字
        • 配置首页
        • 配置评论
      • 终极配置
    • 如何将个人的GitHub主页配置的优雅好看
    • 利用GitHub Actions自动为README添加TOC目录
    • 利用GitHub Actions自动将项目贡献者列表添加到README中
    • 利用GitHub Actions自动优雅地为项目构建Releases
    • 利用GitHub Actions自动获取博客rss文章
    • 利用GitHub Actions自动构建项目的docker镜像并发布到DockerHub
    • 利用GitHub Actions自动生成GitHub的Fans
    • 利用GitHub Actions自动生成个人star列表并归类
    • 利用GitHub Actions自动对仓库内图片进行无损压缩
    • 利用GitHub Actions自动检测项目中的问题链接
    • 利用GitHub Actions自动构建go项目的二进制到release
    • 利用github-slug-action暴漏Github Action上下文中的关键变量
    • 利用Github Action自动检测项目中 yaml 或 json 的语法
    • 记录最近在Github Action配置实践中的几个新的收获
    • VMR一个开源的通用SDK版本管理器
  • Etcd

  • Consul

  • RabbitMQ

  • Kafka

  • Mysql

  • MongoDB

  • OpenVPN

  • Kvm

  • VMware

  • 配置文件详解

  • Other

  • 运维观止
  • GitHub
二丫讲梵
2022-07-23
目录

一个仅需三步配置就能生成免费个人博客的开源模板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
1

# 调整内容

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

# 全局替换关键字

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

# 配置首页

首页的配置信息在 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",
          },
        ],
      ],
    
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17

现在基本配置项都已经搞定,可以将代码提交上去,然后GitHub Actions会自动将代码部署到 gh-pages 分支。

# 终极配置

终极配置就是等 GitHub Actions 跑完之后,我们能看到分支当中多了一个 gh-pages 分支。

此时点击 Settings ---> Pages,进行如下配置:

两个配置项,第一个表示选择哪个分支作为静态文件,第二个表示选择前边分支的哪个目录。

点击保存之后,静待一分钟,然后就可以访问上边提供的那个地址了。成果如下:

如果一路配置没问题,那么文章也应该会自动加载评论功能:

剩下的就是一些细节的优化调整,稍微打磨之后,就可以愉快地撰写你的博客了。

微信 支付宝
上次更新: 2024/09/26, 21:41:44
分享我的开源项目Cloud_Dns_Exporter,妈妈再也不担心我忘换证书了
如何将个人的GitHub主页配置的优雅好看

← 分享我的开源项目Cloud_Dns_Exporter,妈妈再也不担心我忘换证书了 如何将个人的GitHub主页配置的优雅好看→

最近更新
01
学习周刊-总第212期-2025年第21周
05-22
02
从赵心童世锦赛夺冠聊聊我的斯诺克情缘
05-16
03
学习周刊-总第211期-2025年第20周
05-15
更多文章>
Theme by Vdoing | Copyright © 2017-2025 | 点击查看十年之约 | 浙ICP备18057030号
  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式