Mac OS 搭建 Github Pages 个人博客

环境 mac os , 文件路径：桌面 Hexo文件夹

配置本地 hexo

• 1 安装 Node.js

• 2 git

• 3 安装Hexo

  sudo npm install -g hexo
  

• 4 创建blog文件

  hexo init blog
  

• 5 安装 (cd 到 blog目录下)

  npm install
  

• 6 启动hexo 服务器

  hexo s
  

• 7 替换 next 主题 (在 blog下)

  git clone https://github.com/iissnan/hexo-theme-next themes/next
  修改 _config.yml 文件
  theme: landscape 改成 theme: next

• 8 启动hexo 服务器

  hexo clean
  hexo g
  hexo s
  

• 9 开启MathJax

修改 themes\themes\next_config.yml
mathjax:
enable: true

• 10 markdown 与 mathjax兼容问题

当使用Latex处理数学公式的时候 会出现兼容问题例如 ：$h_\theta (x)$ 单个 $$直接基本正常，多个的时候可能就出现异常 主要原因是 _ 冲突， 在 _前面加上 \ 即可。

Github Pages 配置

• 在github上创建repository

1.png

2.png

创建成功后 可以使用 http://用户名 .github.io 来访问。

提交内容到Github Pages

• 1 Clone repository

  git clone https://github.com/username/username.github.io
  

• 2 生成对应文件

  cd username.github.io
  echo "Hello World" > index.html
  

• 3 推送本地文件到Github pages

  git add --all
  git commit -m "Initial commit"
  git push -u origin master
  

同步本地的 hexo 博客 到 github 上

• 1 安装一个扩展( Hexo/blog 下)

  sudo npm install hexo-deployer-git --save

• 2 配置_config.yml

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

• 3 清除缓存上传本地hexo 本地博客到Github pages

  hexo clean 
  hexo g
  hexo d
  

关于配置Hexo可能出现的一些错误

• 1 权限问题

  sudo chown -R 路径/Hexo/blog
  

• 2 无法更新到Github pages

  很多情况是配置自己的git路径出问题，还有另一种情况是有些时候直接 hexo d 会直接报错误。
  如果遇到类似情况， 可以尝试使用 "提交内容到Github Pages" 步骤先提交一个 hello word 试试。然后在hexo d 同步整个blog

参考资料

https://pages.github.com/
http://jeasonstudio.github.io/2016/05/26/Mac%E4%B8%8A%E6%90%AD%E5%BB%BA%E5%9F%BA%E4%BA%8EGitHub-Page%E7%9A%84Hexo%E5%8D%9A%E5%AE%A2/