基于obsidian插件、hexo和github action的博客方案

经验分享
,
1

最后的功能就是用github pulisher提交文档到github，由GitHub action自动生成页面并部署。

第一次尝试

[!note] 熟悉了基本流程，但是觉得生成部署有点麻烦，后面发现有 github action 可以自动部署(2.0)，折腾了两天，暂时没问题

参考教程

本地配置

  • 安装hexo

    • 创建一个文件夹 MyBlog，用来存放自己的博客文件，然后 cd 到这个文件夹下（或者在这个文件夹下直接右键 git bash 打开）。
    • 定位到该目录下，输入 npm install -g hexo-cli 安装 Hexo。可能会有几个报错，无视它就行。
    • 安装完 hexo -v 验证安装成功没

  • 初始化

    • 在主题根目录 hexo init
      • 初始化失败注意根目录的位置（在三层？）
    • 安装必备组件 npm install
      这时指定目录会有几个文件夹

  • 预览

hexo g (hexo generate)
hexo server(或者简写:hexo s）)

连接 github 到本地

  • 在 MyBlog 中右键打开 git bash，第一次使用 git 后需要将用户名和邮箱进行初始化
git config --global user.name "用户名"
git config --global user.email "邮箱"
  • 检查
git config user.name
git config user.email
  • ssh
    ssh，简单来讲，就是一个秘钥，其中，id_rsa 是你这台电脑的私人秘钥，不能给别人看的，id_rsa. pub 是公共秘钥，可以随便给别人看。把这个公钥放在 GitHub 上，这样当你链接 GitHub 自己的账户时，它就会根据公钥匹配你的私钥，当能够相互匹配时，才能够顺利的通过 git 上传你的文件到 GitHub 上。
  • 创建 SSH
ssh-keygen -t rsa -C "邮箱"
  • 检验是否创建成功
ssh -T [email protected]

将 hexo 部署到 github

这一步，我们就可以将 hexo 和 GitHub 关联起来，也就是将 hexo 生成的文章部署到 GitHub 上，打开博客根目录下的_config. yml 文件，这是博客的配置文件，在这里你可以修改与博客配置相关的各种信息。修改最后一行的配置：

# Deployment 
## Docs: https://hexo.io/docs/one-command-deployment 
deploy:
  type: 'git'
  repository: https://github.com/yohakuo/yohakuo.github.io.git
  branch: main

  • 注意空格

  • repository 修改为你自己的 github 项目地址即可就是部署时，告诉工具，将生成网页通过 git 方式上传到你对应的链接仓库中。

  • 先安装部署的命令

npm install hexo-deployer-git --save
  • 部署
hexo clean //缩写成 hexo cl
hexo generate // 缩写 hexo g
hexo deploy // hexo deploy

写文章、发布

  • 先安装拓展
npm i hexo-deployer-git
  • 新建博客
hexo new post "name"

  • 然后在 source\ _posts 目录可以看到. md 文件

  • 实时预览和发布
    编写完 markdown 文件后，在根目录用 hexo g 生成静态网页，hexo s 本地预览
    如果没有问题可以 hexo d 上次到github

本地预览

第二次参考

结合了第二、三个博文中的 workflow 文件，最终实现自动化部署。