使用GitHub page搭建自己的静态网页

环境 mac os ，终端, 文件路径：桌面 Hexo文件夹.

1 安装 Node.js

2 安装git 使用git init 全局初始化

3 安装Hexo

sudo npm install -g hexo

注： 如果mac 上安装hexo出错,报错

可以执行下面命令： sudo npm install --unsafe-perm --verbose -g hexo

然后，就可以 hexo version 成功看到版本号，安装成功！

4 创建blog文件

hexo init blog

5 安装npm依赖文件(cd 到 blog目录下)

npm install

6 启动hexo 本地服务器

hexo clean hexo g hexo s

7 替换 next 主题 (在 blog下)

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

8 开启MathJax

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

9 markdown 与 mathjax兼容问题

当使用Latex处理数学公式的时候 会出现兼容问题例如 ：h_\theta (x) 单个

Github Pages 配置

• 在github上创建repository

创建成功后 可以使用 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/