此仓库为 https://sandy1890.github.io 网站的内容源，该仓库的内容用于生成博客网站

• 需要node环境支持
• 安装hexo及初始化项目

$ npm install -g hexo-cli
$ npm install

# 或

• 使用NexT主题

仓库里没有存放Next主题相关代码,如果在一个新环境使用，在第一次发布之前，需要先到根目录执行下载命令

git clone https://github.com/iissnan/hexo-theme-next themes/next

• 将写作的 md 文件放到　source/_posts　目录下
• scaffolds 目录下是模版文件
• 本地生成 注意:　发布之前需要先设置一下 _config.yml 配置文件中的 deploy 选项,详细的配置查看官方文档https://hexo.io/docs/deployment.html

deploy:
    type: git
    repo: https://github.com/sandy1890/sandy1890.github.io.git
    branch: master

# hexo原生方式
$ hexo generate

# npm 命令
$ npm run gen

• 本地预览,运行命令后浏览器中打开命令行输出的地址，如:https://localhost:4000/

$ npm run server
> hexo s

INFO  Start processing
INFO  Hexo is running at https://localhost:4000/. Press Ctrl+C to stop.

• 写作完成后可以使用以下 npm 命令或 deploy.sh 脚本进行发布

# deploy.sh脚本
$ sh deplsy.sh

# node命令
$ npm run deploy

你可以执行下列命令来创建一篇新文章。

$ hexo new [layout] <title>

您可以在命令中指定文章的布局（layout），默认为 post，可以通过修改 _config.yml 中的 default_layout 参数来指定默认布局。

Hexo 有三种默认布局：post、page 和 draft，它们分别对应不同的路径，而您自定义的其他布局和 post 相同，都将储存到 source/_posts 文件夹。

{% note tip 不要处理我的文章 %} 如果你不想你的文章被处理，你可以将 Front-Matter 中的layout: 设为 false 。 {% endnote %}

Hexo 默认以标题做为文件名称，但您可编辑 new_post_name 参数来改变默认的文件名称，举例来说，设为 :year-:month-:day-:title.md 可让您更方便的通过日期来管理文章。

刚刚提到了 Hexo 的一种特殊布局：draft，这种布局在建立时会被保存到 source/_drafts 文件夹，您可通过 publish 命令将草稿移动到 source/_posts 文件夹，该命令的使用方式与 new 十分类似，您也可在命令中指定 layout 来指定布局。

$ hexo publish [layout] <title>

草稿默认不会显示在页面中，您可在执行时加上 --draft 参数，或是把 render_drafts 参数设为 true 来预览草稿。

在新建文章时，Hexo 会根据 scaffolds 文件夹内相对应的文件来建立文件，例如：

$ hexo new photo "My Gallery"

在执行这行指令时，Hexo 会尝试在 scaffolds 文件夹中寻找 photo.md，并根据其内容建立文章，以下是您可以在模版中使用的变量：

###　使用GitHub搭建免费的个人博客

在这里我使用了两个仓库，一个用于存放写作源码，另外一个用于发布博客

具体操作步骤为:

• 在github创建一个用于存放heox项目的仓库，仓库名随意，用于将写作内容提交到这个仓库保存

• 在github创建另一个名为 {你的用户名}.github.io （将{你的用户名}替换为你自己的账号，注意，这个仓库名称必须如此）新的仓库,这个仓库用于接收hexo提交上来的博客页面,github会自动将此仓库的master分支作为以 https://{你的用户名}.github.io 域名的空间 参看:https://help.github.com/articles/user-organization-and-project-pages/

• 配置_config.yml中 deploy 项 详细操作查看官方文档

deploy:
    type: git
    repo: https://github.com/sandy1890/sandy1890.github.io.git
    branch: master

We recommend GitHub Pages users follow these limits:

主页空间容量1GB GitHub Pages source repositories have a recommended limit of 1GB . Published GitHub Pages sites have a 1GB recommended limit.

每月100GB流量或100,000请求 GitHub Pages sites have a recommended bandwidth limit of 100GB or 100,000 requests per month.

限制每小时10次构建 GitHub Pages sites have a recommended limit of 10 builds per hour.

GitHub Pages官方说明 https://help.github.com/articles/what-is-github-pages

• hexo配置文档
• NexT主题文档