Mac 搭建基于Github的hexo博客

最新推荐文章于 2025-03-29 18:11:32 发布

转载最新推荐文章于 2025-03-29 18:11:32 发布 · 459 阅读

工具专栏收录该内容

1 篇文章

订阅专栏

本文详细介绍了如何使用Hexo快速搭建个人博客站点的过程，包括安装Hexo、初始化配置、关联GitHub仓库以及部署上线等关键步骤。

转载地址：http://gonghonglou.com/2016/02/03/firstblog

安装Hexo

当Node.js和Git都安装好后就可以正式安装Hexo了，终端执行如下命令：

sudo npm install -g hexo

初始化

终端cd到一个你选定的目录，执行hexo init命令：

hexo init blog

blog 是你建立的文件夹名称。cd到 blog 文件夹下，执行如下命令，安装npm：

npm install

执行如下命令，开启hexo服务器：$ hexo s

此时，浏览器中打开网址http://localhost:4000。

本地设置好后，接下来开始关联Github。

关联Github

1.创建仓库

登录你的Github帐号，新建仓库，名为用户名.github.io固定写法，如gonghonglou.github.io即下图中1所示：

本地的blog文件夹下内容为：

_config.yml    
db.json 
node_modules 
package.json
scaffolds
source
themes

终端cd到 blog 文件夹下， vim 打开 _config.yml ，命令如下：

$ vim _config.yml

打开后往下滑到最后，修改成下边的样子：

deploy:
    type: git
    repository: https://github.com/gonghonglou/gonghonglou.github.io.git
    branch: master

你需要将 repository 后 gonghonglou 换成你自己的用户名，地址在上图 2 位置获取。hexo 3.1.1版本后 type: 值为 git 。

在blog文件夹目录下执行生成静态页面命令：

 
  $ hexo generate        或者：hexo g
  此时若出现如下报错：
ERROR Local hexo not found in ~/blog
ERROR Try runing: 'npm install hexo --save'
则执行命令：
npm install hexo --save
若无报错，自行忽略此步骤。

再执行配置命令：

hexo deploy            或者：hexo d

注意坑三：若执行命令hexo deploy仍然报错：无法连接git或找不到git，则执行如下命令来安装hexo-deployer-git：

   $ npm install hexo-deployer-git --save

 
  Username for 'https://github.com':
Password for 'https://github.com':
  hexo deploy命令执行成功后，浏览器中打开网址http://gonghonglou.github.io（将gonghonglou换成你的用户名）能看到和打开http://localhost:4000时一样的页面。