Hexo介绍

hexo是一种静态博客框架，它可以将markdown语法的文本转换成符合其下主题的静态网页资源，只需要几行命令就能在我们的电脑上创建其脚手架，然后利用hexo 进行对应的搭建博客的各种操作。

安装Hexo并进行博客配置

  1. npm install hexo-cli -g 全局安装hexo博客框架，就类似vue的脚手架一样

  2. 初始化博客： hexo init <directory> or cd <directory>;hexo init

  3. 这里我在安装的时候遇见了开启代理仍无法访问GitHub的情况

  4. 解决办法：取消掉git之前的代理

1
2
3
4
5
6
7
8
9
10
11

// 取消代理
git config --global --unset http.proxy 
git config --global --unset https.proxy

// 设置代理
git config --global http.proxy http://127.0.0.1:1080
git config --global https.proxy https://127.0.0.1:1080

// 查看代理
git config --global --list

  1. 这里记录一下hexo的基本指令：指令 | Hexo 下面是hexo的基本文件示意图：

    1
    2
    3
    4
    5
    6
    7
    8
    .
      ├── _config.yml // hexo主要的配置文件
      ├── package.json // 一些前端所需的包（npm install那些）
      ├── scaffolds // 用来生成文章页面的框架
      ├── source // 所有源文件，即最后生成的public文件里存放的所有内容。除了_posts外其他的以_开头的文件都会被隐藏
      |   ├── _drafts
      |   └── _posts
      └── themes

  2. 注意：hexo new page <command>中–path 和–slug其实效果差不多，只不过一个可以改全路径名，一个只改文件名。

这里再做一个简单的解释：三个概念（文件名、路径名、文章名），文件名是这个文件的名字，路径名是最终访问这个文件的路径，文章名是front_matter中的title参数内容，即实际文章标题。最常用的命令hexo new post "paper_title"这里给出的就是文章名，此时：文章名=路径名=文件名；如果加了参数hexo new post --slug "paper_title" dir_title此时：文章名为paper_title、文件名为dir_title=路径名；如果加了参数hexo new post --path paper/title "paper_title"此时：文章名为paper_title、文件名为title、路径名为paper/title。

  1. 预览博客：hexo server

  2. 更换主题：

    1. 所有主题 这是我使用的主题的文档: Butterfly
    2. 将主题代码拷贝到本地themes文件夹下git clone <url> themes/<file>
    3. 修改Blog文件下的_config.yml文件，theme: <file>
    4. 运行hexo server

  3. 利用GitHub Pages来部署博客：

    1. 新建一个<userName.github.io>的仓库

    2. 配置ssh密钥

      1. 如果之前配置过别的ssh密钥，需要加一个config配置文件 

           # github
   Host github.com
   HostName github.com
   PreferredAuthentications publickey
   IdentityFile ~/.ssh/id_rsa_github

      2. 没配置过，直接ssh key-gen -t rsa -C "your_email@email.com"生成一个，将公钥复制到GitHub上即可:smile:

    3. 输入ssh -T git@github.com测试ssh连接是否成功

    4. 修改配置文件，将remote repository的ssh链接复制

    1
    2
    3
    4
    deploy:
          type: git
          repo: 你复制的地址
          branch: main

    1. 安装插件 Hexo Deployer Git npm install hexo-deployer-git --save

    2. 运行hexo g -d生成静态文件并部署

Hexo Deployer Git介绍

项目简介

hexo-deployer-git 是Hexo生态系统的一部分，它允许你在每次更新博客内容后，自动将生成的静态文件推送到如GitHub、GitLab或Bitbucket等支持Git的平台。

技术优势

此项目的核心在于集成Git命令与Hexo的生命周期。当执行 hexo deploy 命令时，它会：

  1. 构建 - 首先，Hexo会编译你的Markdown等内容成HTML。
  2. 添加 - 然后，将所有新的和已修改的文件添加到本地Git仓库中。
  3. 提交 - 创建一个新的提交，附带上自定义的提交信息。
  4. 推送 - 最后，将这些改动推送到你指定的远程仓库。

整个过程自动化处理，无需手动操作，减少了出错的可能性。

使用方法

安装这个插件后，在_config.yml配置文件中添加deploy的相关配置信息。这样在运行hexo deploy的时候就会把静态文件推送到Github.

创建新的帖子和页面

  1. command: hexo new “title”(layout: post、drafts、page)
  2. 在/_post下找到创建的帖子，更新front-matter，比如cover、top_img、update_date等等
  3. 利用markdown尽情开始创作吧😎