Hexo搭建博客&选择主题

Catalogue
  1. 1. 搭建基础
  2. 2. hexo基本指令
    1. 2.1. hexo 初始化
    2. 2.2. hexo 构建&部署启动
  3. 3. 主题typography使用
    1. 3.1. 主题依赖项
    2. 3.2. 安装主题
    3. 3.3. 配置文件修改
    4. 3.4. 添加分类页面
    5. 3.5. 添加标签页面
    6. 3.6. 添加关于页面
  4. 4. 千言万语一句话

搭建基础

  • git 安装
    • 直接 github 上下载,拖到 theme 文件夹中也能用,但这样还不如不搭建
  • 基本linux命令
    • mkdir xxx
    • ll
    • cd

hexo基本指令

请善用 hexo文档

hexo 初始化

1
2
3
4
5
6
7
8
9
10
11
cd xxx  # 进入博客根目录

hexo init # hexo 初始化

INFO Cloning hexo-starter https://github.com/hexojs/hexo-starter.git
INFO Install dependencies
INFO Start blogging with Hexo!

ls # 初始化后的文件夹目录
_config.landscape.yml node_modules package.json source
_config.yml package-lock.json scaffolds themes

hexo 构建&部署启动

1
2
3
4
5
hexo g  # hexo 构建,完整命令 hexo generate ,参数请善用文档

hexo s # hexo 启动,完整命令 hexo server ,参数请善用文档

hexo d # hexo 部署,完整命令 hexo deploy ,参数请善用文档

主题typography使用

请善用 主题文档

主题依赖项

1
2
3
4
cd hexo # 进入 Hexo 博客根目录
npm uninstall --save hexo-generator-category # 此处我们使用 hexo-generator-category-enhance
npm install --save hexo-renderer-pug hexo-generator-archive hexo-generator-category-enhance hexo-generator-feed hexo-generator-tag
npm install --save hexo-prism-plugin # 语法高亮支持

安装主题

1
2
3
git clone https://github.com/SumiMakito/hexo-theme-typography themes/typography
cd themes/typography
npm install

配置文件修改

请对博客根目录下的主配置文件 _config.yml 进行相应的改动。

必改项:

​ - theme: typography

自定义项

​ - title: 学而后思

​ - author: Zhen Min

​ - language: zh-cn ,可选择的语言在 /themes/typography/languages 目录下

​ - 在 language: zh-cn 的情况下,添加了分类、标签、About 页面,需要在每个页面的index.md文件中修改其 title 为中文

添加分类页面

对于独立页面来说,Hexo 会创建一个以标题为名字的目录,并在目录中放置一个 index.md 文件。

1
2
3
4
5
6
cd hexo # 进入博客根目录

hexo new page Categories # 创建 Categories 页面
INFO Validating config
INFO Created: ~/hexo/source/Categories/index.md

  • 主题 typography 配置分类页面

    前提:_config_yml 文件中注明了页面文件夹的名称路径,所以需要与之对应

    # Directory

    source_dir: source

    public_dir: public

    tag_dir: tags

    archive_dir: archives

    category_dir: categories

    code_dir: downloads/code

    i18n_dir: :lang

    skip_render:

    配置:修改 categories 文件夹中 index.md 文件,添加下面一行

    layout: category-index

    注:category-index 这个参数在 /hexo/themes/typography/layout 文件夹中

添加标签页面

对于独立页面来说,Hexo 会创建一个以标题为名字的目录,并在目录中放置一个 index.md 文件。

1
2
3
4
5
6
cd hexo # 进入博客根目录

hexo new page Tags # 创建 Categories 页面
INFO Validating config
INFO Created: ~/hexo/source/Tags/index.md

主题 typography 配置分类页面

前提:_config_yml 文件中注明了页面文件夹的名称路径,所以需要与之对应

# Directory

source_dir: source

public_dir: public

tag_dir: tags

archive_dir: archives

category_dir: categories

code_dir: downloads/code

i18n_dir: :lang

skip_render:

配置:修改 Tags 文件夹中 index.md 文件,添加下面一行

layout: tag-index

注:tag-index 这个参数在 /hexo/themes/typography/layout 文件夹中

添加关于页面

关于页面本质上是个md文件,按照markdown格式编写好即可

1
2
3
hexo new page About
INFO Validating config
INFO Created: ~/hexo/source/About/index.md
  • 菜单栏的排序问题
    • 如果按照上述命令创建,生成部署的时候会发现 about 会在分类和标签之上
    • _config_yml 文件中也没有注明文件夹路径,且 layout 文件夹中也没有 about 页面的模版
    • 所以还是那句话,本质上是个md文件,而且没有加以限制,所以创建时 page 的命名直接换成排序在 c、t 后的即可
      • 例如:hexo new page y_About

关于这个排序问题解决,等我找到别的办法再更新,目前能以这样的方式解决~

千言万语一句话

请善用 hexo文档 & 主题typography文档