macOS下使用Hexo在Github/Coding上搭建私人博客

2018-10-19
折腾教程

安装Command Line Tools

ps: 如果你安装过Clion这些跑c语言的软件，你可能已经被自动安排了Command Line Tools，无需手动安装
在launcher中找到终端，输入xcode-select --install，弹出一个窗口，点击install，接受协议等待安装成功即可

安装Node.js

点击进入Node.js官网，下载左边的LTS版本(比较稳定)，直接一路安装即可

安装git环境

在launcher中找到终端，输入git，如果已经安装就会提示git的使用命令，如果没有安装就按提示确认安装即可

安装Hexo

npm install -g hexo-cli

配置Hexo文件夹

找一个习惯的位置放置Hexo文件夹，然后再终端cd进去，例如我的安装目录

cd /Users/JabinGP/MyHexoBlog

然后执行

hexo init blog
cd blog
npm install

以我的路径为例子，这个命令会把hexo安装在/Users/JabinGP/MyHexoBlog/blog下,
新建完成后，指定文件夹的目录如下：

.
├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├── _drafts
|   └── _posts
└── themes

在本机上查看

hexo generate   //编译生成静态网站，可以简化成 hexo g
hexo server     //开启本机的服务，可以简化成 hexo s

如果报错和权限有关，尝试加上sudo权限

sudo hexo generate   //编译生成静态网站，可以简化成 hexo g
sudo hexo server     //开启本机的服务，可以简化成 hexo s

如果出现报错：
ERROR Local hexo not found in ~/blog
ERROR Try runing: ‘npm install hexo –save

则执行命令：

npm install hexo --save

成功开启后会提示已经成功在http://localhost:4000/部署，在浏览器中输入http://localhost:4000/访问，应该可以看到这个界面
测试成功后就准备同步到github或者coding上了

注册Github或者Coding并创建一个仓库

  • Github
    1. 点击进入Github官网,注册过程不再赘述
    2. 点击Start a project,Repository name项按这个格式填写: 你的用户名.github.io 如:JabinGP.github.io
      其他不需要更改，可以勾选Initialize this repository with a README来初始化你的仓库
  • Coding
    1. 点击进入Coding官网注册，也可以点击Github绑定Github账号
    2. 新建一个项目，名称可以自己定义，可以勾选启用 README.md 文件初始化项目

配置git的全局用户名、邮箱

git config --global user.name "***"
git config --global user.email "***@example.com"

ps: 其中user.name填Github或者Coding的用户名，user.email填Github或者Coding的注册邮箱这里以我的用户名和邮箱来举例

git config --global user.name "JabinGP"
git config --global user.email "1748511181@qq.com"

配置Hexo下的文件

到Hexo文件夹下找到_config.yml文件，打开后拉到底下更改

deploy: 
  type: git
  repo: 
        #ps：一下github以项目名JabinGP.github.io为例，coding以项目名JabinGP为例
    github: https://github.com/JabinGP/JabinGP.github.io.git,master
    coding: https://git.coding.net/JabinGP/JabinGP.git,master
        #ps：上面两行分别是github和coding的仓库地址，这样填可以同时同步两个仓库  
             如果只有一个的话只填一个就好

同步到Github或者Coding

hexo generate   //编译生成静态网站，可以简化成 hexo g
hexo deploy     //同步到托管平台，可以简化成 hexo d

如果出现权限问题，尝试添加sudo

sudo hexo generate   //编译生成静态网站，可以简化成 hexo g
sudo hexo deploy     //同步到托管平台，可以简化成 hexo d

如果报错无法连接到git或者找不到git，则执行如下命令安装hexo-deployer-git：

npm install hexo-deployer-git --save

没有error就算成功了

登陆Github或者Coding查看网页

Github以项目名JabinGP.github.io为例，Coding以项目名JabinGP为例

Github登陆 https://jabingp.github.io/
Coding登陆 https://jabingp.coding.me/