博客搭建纪要

Hexo博客使用记录

Hexo安装

git

Node.js

  1. linux

    1
    sudo yum install nodejs
  2. windows
    官网下载安装

hexo

1
npm i -g hexo

hexo中plantuml

安装java

  1. linux

    1
    2
    sudo yum install java
    sudo yum install java-devel
  2. windows
    下载地址
    Java环境变量配置

    1
    2
    3
    4
    5
    6
    7
    8
    变量名:JAVA_HOME
    变量值:C:\Program Files (x86)\Java\jdk1.8.0_91 // 要根据自己的实际路径配置

    变量名:CLASSPATH
    变量值:.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar; //记得前面有个"."

    变量名:Path
    变量值:%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin;

安装graphviz

  1. linux

    1
    sudo yum install graphviz -y
  2. windows
    下载地址
    将其bin目录加入系统Path变量中

安装Hexo插件hexo-filter-plantuml

1
npm install --save hexo-filter-plantuml

hexo-filter-plantuml

站内搜索功能

1
2
npm install hexo-generator-search --save
npm install hexo-generator-searchdb --save

hexo命令

1
2
3
4
5
6
7
hexo n "我的博客" == hexo new "我的博客" #新建文章
hexo p == hexo publish
hexo g == hexo generate#生成
hexo s == hexo server #启动服务预览
hexo d == hexo deploy#部署

hexo server --drafts 预览草稿

hexo报错解决

找不到git部署

1
ERROR Deployer not found: git

解决方法

1
npm install hexo-deployer-git --save

Jekyll目录结构

  • _config.yml 保存配置数据
  • _drafts 未发布文章
  • _includes
  • _layouts 包裹在文章外部的模版,布局可以在YAML头信息中根据不同文章进行选择,标签

    Hexo博客使用记录

    Hexo安装

    git

    Node.js

    1. linux

      1
      sudo yum install nodejs
    2. windows
      官网下载安装

    hexo

    1
    npm i -g hexo

    hexo中plantuml

    安装java

    1. linux

      1
      2
      sudo yum install java
      sudo yum install java-devel
    2. windows
      下载地址
      Java环境变量配置

      1
      2
      3
      4
      5
      6
      7
      8
      变量名:JAVA_HOME
      变量值:C:\Program Files (x86)\Java\jdk1.8.0_91 // 要根据自己的实际路径配置

      变量名:CLASSPATH
      变量值:.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar; //记得前面有个"."

      变量名:Path
      变量值:%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin;

    安装graphviz

    1. linux

      1
      sudo yum install graphviz -y
    2. windows
      下载地址
      将其bin目录加入系统Path变量中

    安装Hexo插件hexo-filter-plantuml

    1
    npm install --save hexo-filter-plantuml

    hexo-filter-plantuml

    站内搜索功能

    1
    2
    npm install hexo-generator-search --save
    npm install hexo-generator-searchdb --save

    hexo命令

    1
    2
    3
    4
    5
    6
    7
    hexo n "我的博客" == hexo new "我的博客" #新建文章
    hexo p == hexo publish
    hexo g == hexo generate#生成
    hexo s == hexo server #启动服务预览
    hexo d == hexo deploy#部署

    hexo server --drafts 预览草稿

    hexo报错解决

    找不到git部署

    1
    ERROR Deployer not found: git

    解决方法

    1
    npm install hexo-deployer-git --save

    Jekyll目录结构

    • _config.yml 保存配置数据
    • _drafts 未发布文章
    • _includes
    • _layouts 包裹在文章外部的模版,布局可以在YAML头信息中根据不同文章进行选择,标签{{content}}可以将content插入页面中。
    • _posts 存放正式发布文章,文件格式很重要,必须符合:YEAR-MONTH-DAY-title.MARKUP
    • _data
    • _site Jekyll完成转换,生成的页面存放处(默认),该目录最好加入.gitignore
    • index.html 其它html、markdown、testile 文件 如果文件包含YAML头信息部分,Jekyll自动将它们转换,其它.html、.markdown、.md或者.textile等在站点根目录下或者不是以上提到的目录中的文件也会被转化。
    • 其它文件目录 其它未被提及的目录和文件豆浆杯完全拷贝到生成的site中。

    头信息

    • 任何只要包含YAML头信息的文件在Jekyll中都被当做一个特殊的文件来处理
    • 头信息必须在文件开始部分,需要安装YAML的格式卸载两行三虚线之间

    预定义的全局变量

    • layout 如果设置的话,会指定使用该模板文件。指定模板文件时候不需要扩展名。模板文件需要放在 _layouts 目录下。
    • permalink 如果你需要让你的博客中的URL地址不同于默认值 /year/month/day/title.html 当你设置这个变量后,就会使用最终的URL地址。
    • published 当站点生成的时候,如果你不需要展示一个具体的博文,可以设置这个变量为 false。
    • category/categories 除过将博客文章放在某个文件夹下面外,你还可以根据文章的类别来给他们设置一个或者多个分类属性。这样当你的博客生成的时候这些文章就可以根据这些分类来阅读。在一个文章中多个类别可以通过 YAML list来指定,或者用空格隔开。
    • tags 类似分类,一篇文章也可以给它增加一个或者多个标签。同样多个标签之间可以通过 YAML 列表或者空格隔开。

    自定义变量

    在头信息中没有预先定义的任何变量都会在数据转换中通过 Liquid 模板被调用

    在文章中预定义的变量

    在文章中可以使用这些在头信息变量列表中未包含的变量
    date 会覆盖文章名字中的日期。可以用来确定文章分类的正确。

    可以将content插入页面中。
  • _posts 存放正式发布文章,文件格式很重要,必须符合:YEAR-MONTH-DAY-title.MARKUP
  • _data
  • _site Jekyll完成转换,生成的页面存放处(默认),该目录最好加入.gitignore
  • index.html 其它html、markdown、testile 文件 如果文件包含YAML头信息部分,Jekyll自动将它们转换,其它.html、.markdown、.md或者.textile等在站点根目录下或者不是以上提到的目录中的文件也会被转化。
  • 其它文件目录 其它未被提及的目录和文件豆浆杯完全拷贝到生成的site中。

头信息

  • 任何只要包含YAML头信息的文件在Jekyll中都被当做一个特殊的文件来处理
  • 头信息必须在文件开始部分,需要安装YAML的格式卸载两行三虚线之间

预定义的全局变量

  • layout 如果设置的话,会指定使用该模板文件。指定模板文件时候不需要扩展名。模板文件需要放在 _layouts 目录下。
  • permalink 如果你需要让你的博客中的URL地址不同于默认值 /year/month/day/title.html 当你设置这个变量后,就会使用最终的URL地址。
  • published 当站点生成的时候,如果你不需要展示一个具体的博文,可以设置这个变量为 false。
  • category/categories 除过将博客文章放在某个文件夹下面外,你还可以根据文章的类别来给他们设置一个或者多个分类属性。这样当你的博客生成的时候这些文章就可以根据这些分类来阅读。在一个文章中多个类别可以通过 YAML list来指定,或者用空格隔开。
  • tags 类似分类,一篇文章也可以给它增加一个或者多个标签。同样多个标签之间可以通过 YAML 列表或者空格隔开。

自定义变量

在头信息中没有预先定义的任何变量都会在数据转换中通过 Liquid 模板被调用

在文章中预定义的变量

在文章中可以使用这些在头信息变量列表中未包含的变量
date 会覆盖文章名字中的日期。可以用来确定文章分类的正确。