janblank499

janblank499

Hexo Blog 搭建教程 Ⅰ

重装系统后,发现把环境配置的知识都忘光了,写个教程教未来的自己,如果能帮到其他人就再好不过了。
本文大量参考了 Argvchs 的Hexo 博客搭建教程 I, 事实上这篇文章的标题也是参考而来的。
同时也参考了 Kaitaku 的从零搭建 hexo 博客

0. 前言#

Hexo 是一个快速,简单和强大的博客框架,Hexo 使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。
Markdown 相关教程如下

1. 本地安装 Git & Node.js & Hexo CLI#

  • Git
    https://git-scm.com/downloads
    安装完成后在桌面或任意文件夹右键会出现 git bash here 单击打开 git 终端用 git --version 命令检查。
    (以下如无特殊说明则命令均在 git 终端完成)
  • Node.js
    https://nodejs.org
    一般选择 LTS(长期支持版本),安装一路确认即可。
    使用 Node.js 官方安装程序时,请确保勾选 Add to PATH 选项(默认已勾选)
    完成后使用 node -vnpm -v 两个命令检查。
  • Hexo CLI
    输入命令npm install hexo-cli -g
    并用hexo -v检查
  • 安装插件
    部署插件:pnpm add hexo-deployer-git,安装后可使用 hexo -d部署 Blog 到 Github。

2.Github 相关设置#

  • 配置 Github SSH 密钥
    使用ssh-keygen -t rsa -C "[email protected]"命令生成 SSH 密钥,(注意,填入的是自己注册 Github 的邮箱)
    使用notepad %USERPROFILE%\.ssh\id_rsa.pub命令打开本地 SSH 密钥文件并复制,当然你也可以从文本管理器里打开
    点击 Github 页面右上角的头像进入 Settings 页面,点击左侧的 SSH and GPG keys,点击右上角的 New SSH key,粘贴 SSH 密钥到 key 中,Title 不用写,点击 Add SSH key 添加密钥。
    在本地键入如下命令,绑定 Git 和 Github
    git config --global user.name "<user>"
    git config --global user.email "<email>"
    
  • 配置分支
    在 Github 中新建一个仓库作为 Blog 的仓库,仓库名称为<user>.github.io ,例如我的用户名:janblank499,则仓库名称为janblank499.github.io,并确保该仓库是公开的(pubilc)
    打开分支设置,第一个输入框里就是默认分支,(旧版为 master 新版为 main)
    打开你博客根目录的 _config.yml,设置参数。注意branch:**要与默认分支一致
    deploy:
      type: 'git'
      repository: **
      branch: **
    

以上,搭建 Blog 前的设置全部完成,下一步就是在本地生成 Blog 并部署了。
下一篇:Hexo Blog 搭建教程 Ⅱ

加载中...
此文章数据所有权由区块链加密技术和智能合约保障仅归创作者所有。