Hexo 配置

安装前提

  1. 安装Node.js(官网)

  2. 安装Git for Windows(官网)

  3. 在安装上述两个程序后, 在Git Bash窗口中输入以下命令来安装Hexo:

    1
    npm install -g hexo-cli

    Notice:系统环境为Windows10 version1903

配置

  • 建站

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

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

    相关命令

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    # 新建一篇文章
    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

    1. 卸载Hexo自带的Markdown渲染器

      1
      npm un hexo-renderer-marked --save
    2. 安装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规范.
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    ## 高级配置
    # 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文件, 找到以下语句:

      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里更改.

      footer_swig更改后

    2. 下面是我对footer.swig更改后的代码, 可以做一下比较:

      footer_swig代码更改后

    3. 找到/themes/next/languages/下面的zh-Hans.yml, 对其进行更改:

      zh-Hans.yml更改

      可以看到, footer下的powered和theme分别对应footer.swig中:

      1
      2
      {% if theme.footer.powered %}
      {% if theme.footer.theme.enable %}
  • 文章中设置Read More:

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

    1
    <!-- more -->

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

    1
    scroll_to_more false

Reference

Hexo Document

Markdown-it Wiki

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

Hexo-Next底部powered by的logo栏更改以及注意事项

0%