HexoABC

确保系统安装好Node.js与Git

---

## 安装与配置

1. 安装Hexo

   $ npm install hexo-cli -g

2. 指定某一文件夹为建站文件夹 使用在该目录下初始化站点

   $ hexo init <folder name>

3. 进入该目录 使用npm安装必要模块

   $ cd <folder name>
   $ npm install

4. 配置站点根目录下的_config.yml
   设置网站标题 副标题 网站所属者
   如果想增加搜索曝光率可以设置sitemap并提供给各大搜索引擎
   • Hexo有特殊的资源引用方式 比如图片可以不使用[]()方式加载
   • 在_config.yml中设置post_asset_folder: true开启此功能 具体使用在下一节

---

## 写作与预览

1. 使用 new 命令创建一篇新文章
   • 如果post_asset_folder处于开启模式 则创建文章后会生成文章资源目录 可以将外部的静态资源放入

     $ hexo new post <title>

2. 使用Markdown写文章
   • 使用命令创建的文章顶部会有默认的title, date与tag
   • 如果post_asset_folder处于开启模式 引用静态资源将使用如下格式
   • {% asset_img(asset_path|asset_link) [width] [height] [desc] %}
   • width height不能使用单位 也不能使用百分比 可以不设置
3. 预览文章
   • 按顺序执行如下命令
   • hexo clean (清除已生成的静态页面)
   • hexo generate (生成静态页面)
   • hexo server (启动本地服务 默认端口为4000 在浏览器中访问localhost:4000预览刚写好的文章)

---

## 配置GitHub

1. 在自己的GitHub账户中新建一网站专用空仓库 可以不用初始化README.md
   • 名称必须以.github.io结尾
2. 将该仓库ssh路径配置在本地站点根目录的_config.yml中的deploy节点下
   • type设置git
   • repo设置刚刚仓库的ssh地址
   • branch默认master
3. 在本地使用git生成公钥

   $ ssh-keygen -t rsa -C "<github registe email>"

4. 将3步中拿到的公钥在GitHub个人设置中SSH and GPG keys中新建一站点专用ssh key名称随意

---

## 部署

1. 确认本地预览没有问题
   GitHub SSH key 设置正确
   _config.yml配置仓库正确
2. 按顺序执行如下命令

   $ hexo clean
   $ hexo generate
   $ hexo deploy

3. 接着访问之前设置的仓库名称即<repo_name>.github.io

---

## 外观与个性化

Hexo支持主题设置且社区拥有很多精美的自制主题可供使用

1. 下载主题到根目录下的themes/
2. 在根目录下_config.yml的theme节点配置主题
3. 按需在themes/<theme>/_config.yml中配置属性
4. 重复写作与预览第三点中的三行命令 并预览

---

END