JERRY Hexo & GitHub 静态网站搭建说明

$ git --version

# 查看 git 版本号
# 若成功识别即为 git 安装成功

$ git config --global user.name "xxx"
$ git config --global user.email xxx@xxx.com

# 配置个人的用户名称和电子邮件地址

$ git config --list

# ...
# user.name=xxx
# user.email=xxx@xxx.com

# 检查已有的配置信息
# 若配置信息中出现正确用户名及邮箱即为配置成功

$ node -v

# 查看 Node.js 版本

$ npm -v

# 查看 npm 包管理器版本

$ npm install -g cnpm --registry=https://registry.npm.taobao.org

# 利用 npm 下载国内淘宝镜像 cnpm

$ cnpm -v

# 查看 cnpm 版本
# 若以上命令成功识别，那么 cnpm 便安装成功

$ cnpm install hexo-cli -g

# 等待一会，安装完毕

$ hexo -v

# 查看 hexo 版本
# 若以上命令成功识别，那么 hexo 便安装成功

$ hexo init [folder]

# 如果没有设置 folder，Hexo 默认在当前的文件夹建立网站

$ hexo generate

# 该命令可以简写为 $ hexo g

$ hexo server

# 该命令可以简写为 $ hexo s
# 默认情况下，访问端口为：http://localhost:4000/
# 在浏览器中访问 http://localhost:4000/ 即可打开本地搭建好的网站

$ hexo new 

# 如果标题包含空格的话，请使用引号括起来 $ hexo new "first blog"
# 生成的 Markdown 文章放在 source 内的 _posts 下</code></pre><h1>六、利用 GitHub 部署网站</h1><h2>6.1 注册用户</h2><p><a href="https://github.com/">GitHub官网</a></p><p>点击右上角注册即可。</p><h2>6.2 创建同名仓库</h2><ul><li>点击右上的 <code>+</code>，选择 <code>New repository</code> 新建一个仓库</li><li>仓库名称设为 <code>用户名.github.io</code></li><li>仓库类型为 <code>Public</code> 公共类型</li><li>复制仓库 <code>HTTPS</code> URL</li></ul><h2>6.3 更改 Hexo 配置文件</h2><p>修改根目录 <code>_config.yml</code> 内的 <code>deploy</code>。</p><pre><code class="lang-yml"># Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
  type: 'git'
  repo: https://github.com/用户名/用户名.github.io.git    # HTTPS URL
  branch: master</code></pre><h2>6.4 安装 hexo - git 部署工具</h2><p>在 Hexo 博客根目录下，打开终端键入：</p><pre><code class="lang-bash">$ cnpm install hexo-deployer-git --save

# 安装 hexo-deployer-git 工具</code></pre><h2>6.5 远程部署到 GitHub Pages 服务器</h2><pre><code class="lang-bash">$ hexo deploy

# 该命令可以简写为 $ hexo d</code></pre><p>部署成功后即使用 <code>https://用户名.github.io/</code> 在浏览器中访问网站。</p><h1>七、结束语</h1><h2>7.1 美化 Hexo 网站</h2><p>Hexo 支持主题自定义，并且有一个活跃的 <a href="https://hexo.io/themes/">主题社区</a>。</p><p>切换主题方法：下载主题到 <code>themes</code> 文件夹内并修改根目录 <code>_config.yml</code> 内的 <code>theme</code> 设定，即可切换主题。</p><p>修改配置主题请查阅相应主题的文档。</p><p>目前比较热门的几个主题：</p><ul><li><a href="https://github.com/iissnan/hexo-theme-next">NexT GitHub</a></li><li><a href="https://github.com/jerryc127/hexo-theme-butterfly">Butterfly GitHub</a></li><li><a href="https://github.com/litten/hexo-theme-yilia">Yilia GitHub</a></li><li><a href="https://github.com/blinkfox/hexo-theme-matery">Matery GitHub</a></li></ul><h2>7.2 使用 Hexo 插件</h2><p>Hexo 是一个支持插件的可扩展框架，具体插件类型及安装方法请前往 <a href="https://hexo.io/plugins/">Hexo 官网查看</a> 或在搜索引擎求助。</p><h2>7.3 帮助文档</h2><p>Hexo 提供了全面的 Hexo <a href="https://hexo.io/docs/index.html">使用文档</a>（中英文版）及 <a href="https://hexo.io/api/">API 文档</a>，在使用及开发优化 Hexo 的过程中，建议以官方文档为基准。</p>