「HEXO」Hexo 博客搭建

Posted on | In

Bourn tends to be ‘forgetful’,
The amnesiac hero wonders who he is and why he has such deadly skills.
He finally kowns who he is, but “Bourne” doesn’t know how to process that information.
Finally, it has all come back to him.
He creates this space to write his stuff down.

​ —— My First Blog

Hexo 博客搭建 🐬

下载安装 Git

下载NodeJS客户端，某些版本可能与npm存在兼容性的问题，可通过下命令查看版本。

1
node -v

安装 hexo

1
npm install -g hexo-cli

初始化 Hexo, 创建个人文件夹 Hexo, 在 Hexo 文件夹内，右键运行 Git Bash, 输入命令

1
hexo init

基础配置 _config.yml

本地浏览博客, 输入下面命令并在浏览器打开 localhost:4000

1
2
hexo g
hexo s

发布到 GitHub 🐬

设置 Git 的 user name 和 email

1
2
git config --global user.name "yourname"
git config --global user.email "your email"

生成密钥

1
ssh-keygen -t rsa -C "youremail" -f your_file

添加公钥（publickey）至 GitHub。登录 GitHub，进入个人设置 settings -> ssh and gpg keys -> new ssh key，添加新生成的公钥。
测试是否连接成功

1
ssh -T git@github.com

一般在添加公钥之后，可能会遇到下面的问题：

1
2
**Host key verification failed.**
fatal: Could not read from remote repository.

这是由于.ssh文件夹缺少了 known_hosts 文件，输入以下命令：

1
ssh git@github.com

部署

1
hexo d

添加访问统计 🐬

修改配置文件 /themes/xxx/layout/_partial/sidebar.ejs.

1
2
3
4
5
6
7
8
9
10
<div class="linkslist">
<span id="busuanzi_container_site_uv">
  本站访客数<span id="busuanzi_value_site_uv"></span>人次
</span>
</div>
<div class="linkslist">
<span id="busuanzi_container_site_pv">
  本站总访问量<span id="busuanzi_value_site_pv"></span>次
</span>
</div>

更多炫酷的主题个性化

文章按照更新时间排序 🐬

打开配置文件 _config.yml，然后修改或者添加 index_generator 的 order_by 为 -updated：

1
2
3
4
index\_generator:
  path: ''
  per\_page: 10
  order\_by: -updated

发布新文章 🐬

执行 new 命令，生成指定名称的文章至 hexo\source\_posts\postName.md

1
hexo new [layout] "postName"

其中 layout 为可选参数，默认值为 post。可在 scaffolds 目录查看 layout 的名称。可以添加自己的 layout 或者修改已有的 layout。

新文件的开头是属性，采用统一的 yaml 格式，用三段横线分隔。 可以直接修改 title（标题名字）、 date（时间）等。 description 是文章概要，该项为空时hexo默认在首页会显示全部文章内容，如果文章比较长就会显的内容很乱；写让该项后hexo会显示摘要和“阅读全文”连接。下面是文章正文。

1
2
3
4
5
6
7
8
9
10
title: postName #文章页面上的显示名称，可以任意修改，不会出现在URL中
date: 2013-12-02 15:30:16 #文章生成时间，一般不改，当然也可以任意修改
categories: #文章分类目录，可以为空，注意:后面有个空格， 用格式
- [tag1,tag2]
tags: #文章标签，可空，多标签请用格式[tag1,tag2,tag3]，注意:后面有个空格
- tag1
- tag2
description: #概要信息
---
正文。

存草稿 🐬

草稿默认不会显示在页面上，会在 source/_drafts 目录下生成一个 new-draft.md 文件。

1
hexo new draft "new draft"

如果要预览草稿，可
1.更改配置文件（_config.yml） render_drafts: true
2.或者如下方式启动 server： hexo server –drafts
下面这条命令可以把草稿变成文章，或者页面：

1
hexo publish [layout] <filename>

To Fix Some Bugs 🐬

  • hexo s 命令失效
    某人将 hexo 整个文件夹上传到 GitHub 服务器，在另一台电脑下载下来，运行 hexo s 命令失效，从显示信息得知，不存在该命令。这可能是由于 Hexo3 将 hexo-server 独立出来，如果需要本地调试，需要先安装 server。

    1
    2
    npm install hexo-server --save
    npm install

    重新生成静态文档，启动本地服务。如果出现网页空白，并且命令行显示：

    1
    WARN No layout: index.html

    这种情况的出现是由于主题配置错误，查看 themes 文件夹下是否有相关文件夹且文件夹下是否有文件，检查 _config.yml 内 theme 是否和主题名称对应。

  • 升级依赖包

    1
    2
    npm i hexo-cli -g
    npm update

    查看版本

    1
    hexo version

    检查更新

    1
    2
    npm install -g npm-check
    npm-check

    升级

    1
    2
    npm install -g npm-upgrade
    npm-upgrade

    本地生成环境安装

    1
    npm install --save

    Hexo 博客及环境依赖包的正确升级方法

–

---------Thanks for your attention---------
0%