基于 Hexo3 与 Github 搭建个人博客(Win7)


参考教程

  1. Hexo+github 搭建个人博客
  2. 搭建 Hexo 博客中碰到的坑
  3. Next 主题使用介绍
  4. hexo生成博文插入图片

下载安装必要的工具

Nodejs 8.9.4 LTS

  • 由于 Hexo 是基于 Nodejs 的,所以需要相应的环境。
  • 下载地址:Nodejs
  • 进入上述网站,找到合适的版本下载,由于我下的是 Windows 的 8.9.4 LTS 版,所以接下来的步骤都是按照这个版本进行的。
  • 下载完成后获得一个 .msi 文件(Windows Installer 程序包),双击一路 next 安装即可。
    @图1. 下载 nodejs
  • 安装完成后,环境变量应该自动配置好了(我所安装的版本是这样的),如果是旧的版本,可能没有自动配置,就自己去设置一下 PATH,添加 nodejs 安装路径即可。

Git Bash

  • 在 Windows 下,需要这个特殊的命令行工具来操作 git。
  • 下载地址:Git Bash
  • 直接下载一个最新版本即可,获得安装包后也是一路 next ,安装路径需要更改的就改一下就好。不过在环境配置的那一步,我选了 Use Git from Git Bash only,就是只在 Git Bash 里面使用 Git,因为以前安装的时候用了默认的第二个选项,之后使用 Win7 命令行时候出现了许多不明所以的问题……
    @图2. Git Bash 安装步骤之一

MarkDown 编译器

  • 通过 hexo 建立的博客文件都是 .md 文件,所以我们需要一个 markdown 编辑器来方便博客的编写与预览。这里我选择的是马克飞象,因为我一直用它和印象笔记来做笔记的。
  • 官方地址:马克飞象
  • 进入网站后,点击 “账号” 按键,侧边栏出现后点击 “下载桌面客户端” 就可以了。这个安装配置也没什么好说的,也是一路 next 搞定。
    @图3. 马克飞象桌面版下载

安装 Hexo 并搭建博客

  • 注意,首先需要打开 Git Bash,之后的操作都会基于它来进行。
    @图4. Git Bash 界面

安装 Hexo

  • 进入之前安装 nodejs 的目录下,再输入命令 npm install -g hexo 安装 hexo。
  • 注意,这个安装比较久,不知道是不是因为墙的原因导致下载速度慢,有次我安装要十多分钟才完成,所以这一步可能需要等待较长时间。
    @图5. 使用 npm 命令安装 hexo

搭建一个最基本的博客

  1. 到你想保存博客相关文件的目录下,创建一个文件夹并进入。
    @图6. 创建 Blog 目录并进入

  2. 接下来执行命令:

    • hexo init:初始化 hexo
    • npm install:安装相应的依赖包
    • hexo g:生成静态页面(以后更新博客或修改配置后,都要使用这个命令更新)
    • hexo s -p 9090:启动 hexo-server 并设定端口为 9090(随便找个没用到的端口,它默认为 4000,但这个端口总被占用,导致启动成功后总是进不了 localhost:4000 的页面)
    • 在启动 server 时注意一个问题,如果 hexo-server 对博客文件夹没有执行权限,就会导致启动失败并报错。我最初是在 Win7 虚拟机下操作,然后进入到从 Ubuntu 挂过来的网络路径中创建博客文件夹,然后启动 server 时报了一个 EPERM 相关的错误。
  3. 打开 http://localhost:9090/ 即可查看生成的博客的本地预览,看到如下界面就是成功了。
    @图7. 最初博客本地预览

将博客部署到 Git Pages

  • 目前为止所得到的都是本地的博客,想要让别人能通过网络访问,就需要进行一些必要的配置了。直接在自己的机子上搭建环境,或者去租个云服务器之类的,也可以,不过这些操作相对来说会比较麻烦。
  • 一个很简单有效的方式,就是利用 Git Pages (免费的)来直接部署博客。
    • 首先要到 Github 官网注册一个账号,当然如果你有过了就省略这步。
    • 新建一个仓库:
      • 仓库名称设定必须你的Github账户名.github.io
      • 记得勾选初始化一个 README,不然可能之后的一些步骤会有报错。
      • 注意:图中仓库名设置出现警告,是因为我已经创建过这个仓库了。
  • @图8. Github 新建仓库之其一
  • @图9. Github 新建仓库之其二
    • 仓库建好后,进入其设置界面,查看 Git Pages 相关设置是 OK 的就行。
  • @图10. Git Pages 设置之其一
  • @图11. Git Pages 设置之其二
    • 打开之前创建的博客文件夹,其目录结构如下,其中的 .yml 文件就是基本配置文件。
    • 打开 .yml 文件,修改几处:
      • 注意,冒号之后必须带有一个空格。并且建议不要复制粘贴,所有输入纯手打,因为 hexo3 似乎对配置文件内容要求很严格。我原先是把地址复制粘贴进来,导致最终部署时候出现各种各样的问题。
      • type:设定为 git
      • repository:设定为自己的 github 项目地址
      • branch:使用 master 即可
      • url:设定为 git pages 地址(如果没设定这个,配置主题后很可能会找不到 js 与 css 文件,导致页面只有文本。)
  • @图12. yml 配置之其一
  • @图13. yml 配置之其二
  • @图14. yml 配置之其三
    • 完成配置后,回到 Git Bash,执行下面几个命令:
      • npm install hexo-deployer-git --save(这是 hexo3 必须要有的,否则部署时会一直报错)
      • hexo g
      • hexo s,可以先本地预览看看效果)
      • hexo d(部署到 git pages 上)
    • 完成后,登陆你的 git pages 地址就能看到最终效果了。

发布新文章

  • 原本是用命令 hexo new "New Filename" 来在博客目录下的 source/_post 文件夹下生成一个 md 文件,然后通过完善该文件来写文章的。
  • 但使用马克飞象时,似乎无法直接打开生成的 md 文件,所以就要先在马克飞象中写好文章,然后将文章导出为 Markdown 文件到对应目录即可。
  • 注意,导出的 Markdown 格式上可能与 new 出来的那些有些不同,所以需要照着原来的 HelloWorld 文件修改一下格式(主要是 title),不然发布后可能会出现文章题目不对之类的问题。
  • 完成文章后,回到博客目录下,执行 hexo g -d 即可。

删除文章

  • 与发布类似,通过将 source/_post 下的文章对应的 md 文件删除,然后执行 hexo g -d 即可。

设置博客主题

  • 不知道你会不会觉得默认的主题不好看,反正我是觉得比较难看……
  • 所以我们可以到 hexo主题 上面去找个心仪的主题来给自己的博客进行美化。
  • 我选择的是 Next 主题,我比较喜欢它的简约风格:
    • 首先进入主题的 git 页面,记下其项目地址:https://github.com/iissnan/hexo-theme-next
    • 到博客目录下,执行:git clone https://github.com/iissnan/hexo-theme-next themes/next
    • 找个小图当头像,保存到 source/_uploads (新建这个文件夹)下,我这里命名为 first.png
    • 修改博客 yml 文件:
      • theme: next(设置主题为 next,这个名对应着 themes/next
      • language: zh-Hans(设置语言为中文简体)
      • title(博客名)、author(你的昵称)、description(一些描述,如同 QQ 签名一般的存在),这些就按照个人喜好改掉就好。
      • 在文件最末尾新加一个字段:avatar: /_uploads/first.png
    • themes/next 中修改 yml 文件:scheme: Pisces(这步只是切换风格,不改就是默认的风格)
    • 重新生成博客:hexo g
    • 本地预览博客:hexo s -p 9090
    • 最终部署博客:hexo d
  • 大功告成
    @图15. 最终界面

猜你喜欢

转载自blog.csdn.net/qq_16775897/article/details/79098267