杂记

Keep It Simple & Stupid.

0%

Hexo 使用备忘

发表于 更新于 分类于 Disqus：
本文字数： 2.2k 阅读时长 ≈ 2 分钟

安装

具体可以看：https://hexo.io/zh-cn/docs/

  • 安装node.js和npm

  • 利用npm安装hexo

    1
    npm install -g hexo-cli

  • 创建博客目录，以blog目录为例

    1
    hexo init blog

  • 安装插件（包括上传github的，主题等等）

    1
    2
    3
    4
    #cd blog
    绘图类：#npm install hexo-filter-mermaid-diagrams
    主题：#git clone https://github.com/theme-next/hexo-theme-next themes/next
    上传github插件：#npm install hexo-deployer-git

  • 配置主题支持mermaid绘图插件
    编辑next/_config.yml

    1
    2
    3
    4
    5
    # Mermaid tag
    mermaid:
      enable: true
      # Available themes: default | dark | forest | neutral
      theme: forest

  • 用法
    靠标记符载入mermaid.js

    1
    2
    3
    4
    {% mermaid type %}
    {% endmermaid %}

    type : type of the mermaid chart, visit https://github.com/mermaid-js/mermaid for more information.

    例子：

    1
    2
    3
    4
    5
    6
    {% mermaid graph TD %}
    A[Hard] -->|Text| B(Round)
    B --> C{Decision}
    C -->|One| D[Result 1]
    C -->|Two| E[Result 2]
    {% endmermaid %}

    mermaid详细教程： http://mermaid-js.github.io/mermaid/diagrams-and-syntax-and-examples/examples.html

    typora图表介绍：https://support.typora.io/Draw-Diagrams-With-Markdown/

  • 各种命令

    1
    2
    3
    4
    生成新博文：hexo n "博文标题"
    生成静态页面：hexo g
    开启本地服务：hexo s --debug
    上传github：hexo d

主题

Hexo 添加分类及标签

  • 创建“分类”选项
    生成“分类”页并添加tpye属性,进入博客目录。执行命令下方命令

    1
    $ hexo new page categories

    添加type: “categories”到内容中，添加后是这样的：

    1
    2
    3
    4
    5
    ---
    title: 分类
    date: 2019-04-24 15:30:30
    type: categories
    ---

    给文章添加“categories”属性

    打开需要添加分类的文章，为其添加categories属性。下方的categories:Hexo表示这篇文章添加到到“Hexo”这个分类。注意：一篇文章只会添加到一个分类中，如果是多个默认放到第一个分类中。

    1
    2
    3
    4
    5
    ---
    title: Hexo 添加分类及标签
    date: 2017-05-26 12:12:57
    categories: Hexo
    ---

  • 创建“标签”选项
    生成“标签”页并添加tpye属性 

    1
    $ hexo new page tags

    添加type: “tags”到内容中，添加后是这样的：

    1
    2
    3
    4
    5
    ---
    title: 标签
    date: 2019-04-24 15:40:24
    type: tags
    ---

    给文章添加“tags”属性,打开需要添加标签的文章，为其添加tags属性。

    1
    2
    3
    4
    5
    6
    7
    8
    ---
    title: Hexo 添加分类及标签
    date: 2019-04-24 15:40:24
    categories: 
               - Hexo
    tags:
               - 博客
    ---

添加 RSS 订阅功能

  • 安装插件：
    1
    $ npm install hexo-generator-feed
  • 修改hexo的_config.yml，新增如下：
    1
    2
    3
    4
    5
    #Feed Atom
    feed:
      type: atom
      path: atom.xml
      limit: 20
  • 修改主题_config.yml的Rss相关配置，打开开关即可。

关于typora插入图片后hexo生成路径问题

  • 安装插件 hexo-image-link
    1
    npm install hexo-image-link --save
  • 修改hexo的_config.yml
    1
    post_asset_folder: true

其他：插入视频

具体参考：https://hexo.io/docs/tag-plugins

  • youtube
    1
    {% youtube video_id [type] [cookie] %}
    例如:
    1
    2
    3
    {% youtube lJIrF4YjHfQ %}
    也可以插入播放列表
    {% youtube PL9hW1uS6HUfscJ9DHkOSoOX45MjXduUxo 'playlist' %}
    例子见：Post not found: hello-world