Hexo 配置

安装前提

安装Node.js(官网)
安装Git for Windows(官网)
在安装上述两个程序后, 在Git Bash窗口中输入以下命令来安装Hexo:
1
npm install -g hexo-cli
Notice:系统环境为Windows10 version1903

配置

建站

安装Hexo之后, 我们需要在指定的文件夹新建网站Push的地方:

# 初始化一个Hexo仓库
hexo init <folder>
# 进入该仓库
cd <folder>
# 安装Hexo相关配置文件
npm install

相关命令

# 新建一篇文章
hexo new <title>
# 生成静态文件
hexo g
# 启动本地服务器[--调试模式]
hexo s --debug
# 发表草稿
hexo publish <filename>
# 部署网站
hexo d
# 清理最近一次的缓存以及生成的静态文件
hexo clean
# 列出网站资料
hexo list <type>
# 显示hexo版本
hexo version

替换Markdown渲染器

原因: 提供更加丰富的Markdown解析和渲染.

安装hexo-renderer-markdown-it

卸载Hexo自带的Markdown渲染器
1
npm un hexo-renderer-marked --save
安装markdown-it渲染器
1
npm i hexo-renderer-markdown-it --save

对于markdown-it的配置

配置文件: 在Hexo仓库的根目录下, 对_config.yml文件进行配置.

1
2
3

## 简化配置
# markdown-it config
markdown: ['zero' | 'default' | 'commonmark']

zero: 禁用大多数渲染器的功能. 仅支持斜体和粗体.
default: 渲染器的行为类似于Github规范.
commonmark: 使用最新的CommonMark规范.

## 高级配置
# markdown-it config
markdown:
  # 渲染器
  render:
    html: true # 对Html内容进行转义, 使标签作为文本输出
    xhtmlOut: false # 不必使用完全的XHtml代码, 换行可以为<br>
    breaks: true # 每次回车换行相当于一个<br/>标签
    linkify: true # 链接内联, 将其文本作为链接输出
    typographer: true # 替换常见的排版元素
    quotes: '“”‘’' # 将英文单引号和双引号变成中文单引号和双引号
  # 插件
  plugins:
    # 缩写插件
    - markdown-it-abbr
    # 脚注插件
    - markdown-it-footnote
    # 插入插件
    - markdown-it-ins
    # 下标插件
    - markdown-it-sub
    # 上标插件
    - markdown-it-sup
  # 锚
  anchors:
    # 生成Heading ID的标题等级
    level: 2
    # Heading ID重复时, 数字的后缀
    collisionSuffix: 'v'
    # 创建一个锚标记, 除标题还有一个固定链接
    permalink: true
    # 用于确定锚标记的样式
    permalinkClass: header-anchor
    # 用于确定链接标记的符号
    permalinkSymbol: ¶

字体导致的访问缓慢

原因: 第三方字体的加载

解决办法: 到Next主题下的_config.yml中设置不从google加载字体.
1
2
# default: 加载本地字体
use_font_lato: false

Next主题底部logo栏更改
1. 找到/themes/next/layout/_partials/下面的footer.swig文件, 找到以下语句:
  
  其中, 第一个框代表的是下图中第一行的文字, 如果在编辑作者(config.author)的旁边加注的话, 需要在那两个大括号外写明.
  
  第二个框代表的是下图中第二行的|左边的文字, 原来应该是由Hexo驱动的一个链接, 所以直接将<a></a>这一标签以及内部的内容删除, 注意这里的单引号不能删除, 至于中文则需要在themes/next/languages/里的zh-Hans.yml更改.
  
  第三个框代表的是下图中第二行|右边的文字, 原来是主题-..., 只要将<a></a>标签和之后的:
  1
  {% if theme.footer.theme.version %} v{{ theme.version }}{% endif %}
  删除掉, 至于主题两字同样是在zh-Hans.yml里更改.
2. 下面是我对footer.swig更改后的代码, 可以做一下比较:
3. 找到/themes/next/languages/下面的zh-Hans.yml, 对其进行更改:
  
  可以看到, footer下的powered和theme分别对应footer.swig中:
  1
  2
  {% if theme.footer.powered %}
  {% if theme.footer.theme.enable %}

文章中设置Read More:

在用Markdown编辑文章时, 如果我们想在Hexo的首页自由的截断文章, 显示摘要, 那么可以在文章的截断位置写下:
1

并且, 如果对于每次点击阅读更多后, 网页跳转的并不是全文的开始位置, 而是锚点的所在位置而不满的话, 你可对/themes/next/里的_config.yml文件进行配置:
1
scroll_to_more false

Reference

Hexo Document

Markdown-it Wiki

Hexo next 打开博客过慢的解决办法