Biantian's Studio.

Hexo Tutorial

Word count: 902Reading time: 4 min
2020/04/09 Share

Hexo Project

Installation

  1. 安装指令

    npm是nodejs指令

    npm install -g hexo-cli

  2. 版本检查

    在PowerShell中无法运行,只能用cmd

    hexo -v

Project Creation

  1. 创建项目

    注意先加载到想要放项目的文件夹中:cd <foldername>

    这条指令会把需要的文件clone到文件夹中,需要一些时间。

    hexo init <name of project>

    当看到

    1
    INFO Start blogging with Hexo!

    后就表示成功了。

  2. 创建本地服务器

    先 cd 到创建的项目文件夹中:cd ga-hexo/

    hexo server

    运行完成后可打开 http://localhost:4000 查看默认网页。

Structure

  1. node_modules

    保存nodejs file

  2. scaffolds

    存放内容的模板。为新建的不同post类型提供模板。

  3. source

    存放所有的内容

  4. themes

    存放模板

  5. _config.yml

    默认设置

  6. pachage.json

    nodejs依赖

New Blog Post

  1. 新建md内容

    新md文件会出现在_posts文件夹下。

    hexo new <md name>

  2. 新建一个草稿

    hexo new draft <md name>

    该文件存放在_draft文件夹下。该文件不会在网页中显示。

  3. 显示draft

    hexo server --draft

  4. 发布页面

    将页面从_draft移动到_posts

    hexo publish <md name>

New Page

  1. 创建新页面

    创建一个与_posts_draft平行的文件夹

    需要用他的url直接进入才能浏览

    hexo new <post type> <folder name>

    post type could be -> page, draft or anything you costomized in Scaffolds before.

Scaffolds

  1. 一个案例 giraffe.md
1
2
3
4
5
6
7
8
9
10
11
12
---
titile: {{ title }}
data: {{ date }}
layout: {{ layout }}
author: "Dongzhe Jiang"
tag: [Tag1, Tag2, Tag3]
categories:
- [Cat1, Cat1.1]
- [Cat2]
- [Cat3]
---
Some default text.

Tags & Categories

Group content togeter, see examples in Scaffolds.

Tag Plugins

View official link.

Asset Folder

  1. 更改_config.yml设置

    1
    2
    3
    4
    # Writing
    ...
    post_assert_folder: true
    ...

    更改过后,新建post时会自动创建文件夹存放资源,然后就可以创建图片索引了。

Themes

  1. 下载主题

    View link. 打开对应的链接会进入github页面,克隆theme项目到保存项目的文件夹themes

    git clone <github page link> <address>

  2. 设置主题

    进入_config.yml

    1
    2
    3
    4
    # Extensions
    ...
    theme: <theme name>
    ...
  3. 重启Server

    记得进入project文件夹,运行hexo server.

Github

https://www.bilibili.com/video/BV1A4411G7SF?p=1

Create a theme

Watch the video.

Deployment

  1. 生成静态网页

    hexo generate

  2. 部署在网站上

    hexo deploy

  3. 有的时候静态网页的本地缓存会产生冲突,需要先清空缓存

    hexo clean

  4. 前两步可以合并为

    hexo deploy -g or hexo generate -d

    参照Commands.

Comments

1. LiveRe

在LiveRe官网注册账号安装City版复制代码:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
<!-- 来必力City版安装代码 -->
<div id="lv-container" data-id="city" data-uid="MTAyMC80OTY1MC8yNjE0MQ==">
<script type="text/javascript">
(function(d, s) {
var j, e = d.getElementsByTagName(s)[0];

if (typeof LivereTower === 'function') { return; }

j = d.createElement(s);
j.src = 'https://cdn-city.livere.com/js/embed.dist.js';
j.async = true;

e.parentNode.insertBefore(j, e);
})(document, 'script');
</script>
<noscript> 为正常使用来必力评论功能请激活JavaScript</noscript>
</div>
<!-- City版安装代码已完成 -->

由于archer这个主题已经支持评论了,直接在_config.yml里添加对应的data-uid就行了。参考.

2. Management

View Link.

Google Search Console

我想要在google上搜索到我的网站,于是先在Google Search Console上注册了一下。

  1. URL Prefix

    参考link,将googledxxxxx.html用于认证的文件添加到了网站中。认证成功。但是从google中还是搜索不到。

    添加hexo-generator-sitemap生成sitemap.xml文件,在GSC里面添加Sitemaps。

  2. Domain

    由于第一种方法没有看到成效,我尝试了Domain方法。

    首先获取验证TXT:google-site-verification=roAMZofbULJNRtnv5NJxvpi9pqhdCV7sITzCAmAbWEE

    然后在themes/archer/layout/_partial/base-head.ejs中的<head>标签中添加了

    1
    <meta name="google-site-verification" content="roAMZofbULJNRtnv5NJxvpi9pqhdCV7sITzCAmAbWEE" />

    然后。。然后就没有然后了,直接认证失败。

CATALOG
  1. 1. Hexo Project
    1. 1.1. Installation
    2. 1.2. Project Creation
    3. 1.3. Structure
    4. 1.4. New Blog Post
    5. 1.5. New Page
    6. 1.6. Scaffolds
    7. 1.7. Tags & Categories
    8. 1.8. Tag Plugins
    9. 1.9. Asset Folder
    10. 1.10. Themes
    11. 1.11. Github
    12. 1.12. Create a theme
    13. 1.13. Deployment
    14. 1.14. Comments
      1. 1.14.1. 1. LiveRe
      2. 1.14.2. 2. Management
    15. 1.15. Google Search Console