Hexo+git建站流程及注意事项

建站基本流程

1、安装nodejs、git
2、安装hexo

1

$ npm install -g hexo-cli

3、建站，folder为站点文件夹名称

1
2
3

$ hexo init <folder>
$ cd <folder>
$ npm install

4、 本地试运行

1
2
3

$ git clean //清除原有服务器数据
$ git generate //生成静态文件，可简写为 git g
$ git server //启动本地服务

启动服务器后，默认情况下本地访问网址为： http://localhost:4000/

注意：网站信息配置参考官网 hexo

发布文章

1

$ hexo new post <title>

使用上述命令发布新文章后，会在/source/_posts 文件夹下生成以 <title> 命名的 .md文件，在该文件中编辑文章内容。

如何引用本地图片？

1、 将 _config.yml 配置文件中的 post_asset_folder 项修改为 true；
2、修改上述属性后，再次执行发布文章命令，在生成以 <title> 命名的 md. 文件的同时，还会生成同名文件夹，将需要引用的图片放在此文件夹中；
3、通过如下语法在 .md 文件中引用图片

1

{% asset_img 图片名称.jpg 图片的说明 %}

部署到github

1、注册github账号，并新建仓库，注意，仓库名必须与账号名相同；
2、修改 _config.yml 配置文件中的部署参数

1
2
3
4
5
6

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git
  repo: git@github.com:flyoob/flyoob.github.io.git //github仓库地址
  branch: master

3、为 Hexo 安装 Git 插件

1

npm install hexo-deployer-git --save

4、部署命令

1
2

$ hexo deploy
$ hexo d

部署成功后即可通过网址 https://username.github.io/ https://jiajiaaz.github.io/ 访问博客主页。

注意：

如果本地的git还未曾与 github建立连接，则需要初始化用户信息并验证 ssh key 以建立连接。
配置用户身份信息：

1
2

$ git config --global user.name "JiajiaAz"
$ git config --global user.email "635439054@qq.com"

生成秘钥：

1

$ ssh-keygen -t rsa -C "635439054@qq.com"

连续三个回车后生成密钥，存储在：C:\Users\Administrator.sshid_rsa.pub 文件中。复制秘钥，并粘贴到github的ssh key 选中。
验证秘钥是否添加成功：

1

$ ssh -T git@github.com

更换主题

1、挑选到合适的主题后，复制其github地址，并将其克隆到themes文件夹下；
2、将 _config.yml 配置文件中的theme 属性修改为新的主题名。

“cannot get/xxx”的解决办法

博客搭建好后，在点击某些菜单时，遇到 “cannot get/xxx”的问题，例如，在点击 About 菜单时，弹出的页面显示 “cannot get/about/“。这是因为没有初始化 about目录，可通过以下命令解决：

1

$ hexo new page "about"

一些小技巧

1、 博客首页默认显示文章的一部分，只要再文章中加上 标记，该标记以后的部分就不再显示，只有点击全部展开之后才显示。