Hexo + Github Pages博客搭建实践

版权声明:未经博主本人同意,请勿私自转发分享。 https://blog.csdn.net/Nerver_77/article/details/89245978

写在开头,作为一个臭写代码的,我想我们的梦想都是拥有一个自己的博客网站
加上平时经常写MD笔记,为什么要写MD笔记? 忘了被word格式支配的恐惧了?受不鸟受不鸟
那么诸多的MD笔记,我一般都是整理好发博客之类的,方便以后查看,当然还是有一点点私心的,想让更多的人看到
需求已经出现,MD格式、想让更多人看到、方便查看存储
你想到了什么? 博客网站,木有错,那么让我们一起使用 Hexo + Github Pages个博客站点吧~~~~

一、安装 node.js

  1. node.js 环境安装,下一步安装 [这里我安装到了 D:\Software\ 目录下] https://nodejs.org/en/download/
    在这里插入图片描述

  2. 环境变量配置

    1. PATH 配置 [安装时默认的 PATH 路径已添加了 D:\SoftWare\nodejs]

    2. 全局模块存放路径、cache路径

       npm config set prefix "D:\Software\nodejs\node_global"
       npm config set cache"D:\Software\nodejs\node_cache"         
      

      在这里插入图片描述

  3. cnpm配置

    什么是 npm 和 cnpm

    npm(node package manager):nodejs的包管理器,用于node插件管理(包括安装、卸载、管理依赖等)

    cnpm:因为 npm 安装插件是从国外服务器下载,受网络的影响比较大,可能会出现异常,所以淘宝团队做了一个完整 npmjs.org 镜像,可以用此代替官方版本使用,同步频率目前为10分钟一次

     npm install -g cnpm --registry=https://registry.npm.taobao.org
    

    配置完成后,添加 D:\SoftWare\nodejs\node_global 到 PATH 环境变量中即可使用!
    在这里插入图片描述

  4. 检查 node.js 配置情况
    在这里插入图片描述

二、安装 Hexo 博客框架【基于node.js】

  • 使用 cnpm 安装 Hexo

     cnpm install hexo-cli -g 
    

    在这里插入图片描述
    安装完成后,使用 hexo -v 命令 查看安装结果:
    在这里插入图片描述

  • 创建博客文件夹源文件目录以及初始化 Hexo

    2.1 创建一个新文件夹作为我们博客目录,这里使用了 D:\hexo_blog 目录
    在这里插入图片描述
    2.2 进入 D:\hexo_blog 目录,进行 Hexo 的初始化工作:hexo init
    在这里插入图片描述
    2.3. 启动预览 Hexo 博客服务:hexo s
    在这里插入图片描述
    打开浏览器,访问:localhost:4000 查看预览效果

  • 新建博客示例

    Hexo 的 博客文件 均采用的是 MarkDown 格式的文件存储,其路径为 D:\hexo_blog\source\_posts。进入到该目录下,创建一个示例 MD文件,这里我习惯上采用 MarkDownPad 2 进行 MD文件的编辑。
    在这里插入图片描述
    这里我们在新建 MD文件下 进行内容编辑:
    在这里插入图片描述

    编辑完成后保存 MD文件,在命令行下进行博客生成和服务启动: hexo g and hexo s
    在这里插入图片描述

    下面是示例博客页面生成效果:
    在这里插入图片描述
    备注,多次编辑后的 MD文件建议使用 hexo clean 命令进行清除缓存文件 db.json 和已生成的静态文件,显示异常时可以试试这条指令。

    这里补充常用的 Hexo 命令:

    hexo s

    • hexo server 缩写,启动本地服务器进行预览,默认地址为 http://localhost:4000/
    • 对博客根目录 _config.yml 的修改,需要重启本地服务才可进行效果预览(变更主题、配置发布方式等)

    hexo n

    • hexo new 缩写,新建MD文件博客,例如: hexo new "测试"。在 ..\source\_posts 目录下就会出现 测试.md 文件
      在这里插入图片描述

    hexo d

    • hexo deploy 缩写,自动生成静态文件,并部署到指定的(远程)仓库,这个命令在后文中会进行示例

    hexo clean

    • 清除缓存文件 db.json 和已生成的静态文件public 文件夹

    hexo g

    • hexo generate 缩写,生成博客的静态文件到默认的 public 文件夹

    hexo new page

    • 生成次级标题页面,例如:hexo new page about
      在这里插入图片描述
      重新启动本地服务,访问路径:/about
      在这里插入图片描述

三、 Hexo 部署 [ 操作目录: D:\hexo_blog ]

  • 在Github上新建仓库,注意命名严格按照:用户名.github.io 进行创建
    在这里插入图片描述

  • 安装 Git 部署插件,Git安装过程省略,下载安装包,一直下一步即可

     cnpm install --save hexo-deployer-git
    

    在这里插入图片描述

  • 编辑 _config.yml,配置部署相关参数(发布类型、发布地址、发布分支master)
    在这里插入图片描述

  • 使用 Git 将 Hexo博客 部署到 Github 上:hexo d

    这里说明两种可能遇到的情况

    • 首次安装 Git 后,需要配置用户名、邮箱等操作才可以进行使用:
      在这里插入图片描述
    • 博客推送时,需要登录 Github 账户:
      在这里插入图片描述
  • 查看部署结果

    • 推送到 Github 仓库效果:
      在这里插入图片描述
    • 命令行推送结果:在这里插入图片描述
  • 通过 Github 进行访问: 用户名.github.io
    在这里插入图片描述


结尾:

基础的Hexo博客的搭建以及部署到Github上的操作实例已经完成了,关于Hexo的其他实践网上资料很多,包括深度定制个人博客,添加更多丰富好玩的功能等。选择Hexo的原因大概就是可以通过MD文件直接生成博客页面吧,毕竟懒得去转换~~~

你也可以将你的Hexo博客部署到个人云服务器上,毕竟 Github Pages 可以通过 个人仓库的方式进行访问,何乐而不为呢?

现在你的博客已经部署好了,那么写博客姿势就出现了:

  • 在本地博客 source\_posts 目录下创建MD文件
  • 编辑MD文件 [安利:MarkDown Pad2 或者 Vscode]
  • 编辑完成后本地预览 ,clean and server 双管齐下
  • 确定无误后,deployer 到你的 Github 仓库
  • username.github.io 访问你的博客内容

就是芥末的干蛋,你get到了吗?

猜你喜欢

转载自blog.csdn.net/Nerver_77/article/details/89245978