准备用这个文档来记录一下github page和gitee page的部署事项，目前github page已经成功绑定了自己的域名http://dreamstar.top/，也算是一个小小的进步吧。

hexo blog的部署方式

hexo作为一种便捷的博客系统搭建方式，可以使用多种主题快速的搭建个人博客，满足文章的存档和个性化需求。这个文档的主要内容是来描述hexo blog 的部署方式，目前已包含了gitee和github的部署方式，并且已经可以实现和域名的绑定。

通用内容

要想建立一个属于自己的博客，首先需要先建立一个项目（并可使用git进行管理），在master的基础上，先建立一个dev分支（或者其他任意名字）来储存hexo的主要文件和主题信息，在本地建立hexo项目的详细的内容见hexo的基本用法。

在完成本地hexo项目之后，需要在hexo目录下的_config.yml文件中完成对\# URL和\# Deployment部分的设置。

\# URL：用于定义网页中默认的url和分支情况，主要需要注意以下两个参数。

url: http://dreamstar.top/ - - 这个参数是你网页访问的网址，如果绑定了域名，就需要直接使用域名的链接。如果没有，就要使用https://mengfan1993.gitee.io/这样的链接，实测gitee中好像不受这个参数的影响。
root: - - 这个参数反映了你项目中分支的名称当你使用了默认值之外的分支名称时，就需要填写这个内容。

gitee：默认为pages

github：默认为gh-pages

注意：github中必须严格的按照上述的规则进行填写，否则主题可能无法进行应用，可以在.deploy_git和生成的public中的index.html中看到这两个参数对静态页面产生的影响。

\# Deployment是用于填写一键部署上传方式和对应仓库位置的地方。以下是gitee和github同时部署的填写方式：

# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
  - type: git
    repo: git@gitee.com:gitee的账户名称/gitee的账户名称.git
    branch: pages
  - type: git
    repo: git@github.com:github的账户名称/github的账户名称.github.io.git
    branch: gh-pages

直接使用github的账户名称.github.io和gitee的账户名称来分别作为github和gitee的仓库名是最简单快捷的搭建方式，这样可以直接使用一级域名，便于后期域名的绑定

一键部署插件

Hexo中提供的一键部署方式是最简单且快捷的方式，使用方式如下：

首先需要完成hexo-deployer-git插件的安装。

$ npm install hexo-deployer-git --save

随后修改配置

deploy:
  type: git
  repo: <repository url> #https://bitbucket.org/JohnSmith/johnsmith.bitbucket.io
  branch: [branch]
  message: [message]

参数	描述	默认
`repo`	库（Repository）地址
`branch`	分支名称	`gh-pages` (GitHub) `coding-pages` (Coding.net) `master` (others)
`message`	自定义提交信息	`Site updated: {{ now('YYYY-MM-DD HH:mm:ss') }}`)
`token`	可选的令牌值，用于认证 repo。用 `$` 作为前缀从而从环境变量中读取令牌

生成站点文件并推送至远程库。执行 hexo clean && hexo deploy。

除非你使用令牌或 SSH 密钥认证，否则你会被提示提供目标仓库的用户名和密码。
hexo-deployer-git 并不会存储你的用户名和密码. 请使用 git-credential-cache 来临时存储它们。

登入 Github(或gitee、BitBucket、Gitlab)，请在库设置（Repository Settings）中将默认分支设置为_config.yml配置中的分支名称。稍等片刻，您的站点就会显示在您的Github Pages中。

当执行 hexo deploy 时，Hexo 会将 public 目录中的文件和目录推送至 _config.yml 中指定的远端仓库和分支中，并且完全覆盖该分支下的已有内容。

由于 Hexo 的部署默认使用分支 master，所以如果你同时正在使用 Git 管理你的站点目录，你应当注意你的部署分支应当不同于写作分支。
一个好的实践是将站点目录和 Pages 分别存放在两个不同的 Git 仓库中，可以有效避免相互覆盖。
Hexo 在部署你的站点生成的文件时并不会更新你的站点目录。因此你应该手动提交并推送你的写作分支。

此外，如果您的 Github Pages 需要使用 CNAME 文件自定义域名，请将 CNAME 文件置于 source 目录下，只有这样 hexo deploy 才能将 CNAME 文件一并推送至部署分支。