更新 Hexo 和 NexT 主题，使用 Twikoo 评论系统

发表于 分类于

博客换到 Hexo 之后，就一直没有更新过 Hexo 和 NexT 主题的版本，现在版本差的有些多。 

1
2
3
4
5
6
7
hexo --version
hexo: 3.4.1

# Now
hexo --version
INFO  Validating config
hexo: 5.4.2

更新一下

样式修改可以放在自定义样式文件中，尽量避免修改主题的源文件
跳转到 添加自定义样式

1. 设置环境

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 安装 Hexo
npm install hexo-cli -g
hexo init hexo

cd hexo
npm install

# 安装主题
# 注意仓库是否是最新的 8.x 的版本
git clone https://github.com/next-theme/hexo-theme-next themes/next

# 拉取 blog 的备份
rm -rf source
git clone https://github.com/Homulilly/blog.git source

2. 编辑配置

修改配置 _config.yml 将主题设置为 next

  • 语言由 zh-hans 修改为 zh-CN

使用独立的 _config.[theme].yml 文件（Hexo 文档），不在主题文件夹内修改配置，避免 git 更新时提示冲突
在 Hexo 主目录下执行下面的命令，然后修改 _config.next.yml 即可

1
cp themes/next/_config.yml _config.next.yml

2.1 使用 Git 分支处理主题源文件硬编码

偶尔还是需要直接修改一下主题源代码，使用分支进行在进行更新时比较方便一些

1
2
3
4
5
6
7
8
9
10
# 新建并切换到 my 分支
git checkout -b my

# 更新时需要切换回 master 分支
git checkout master
git pull

# 然后将更新合并至 my 分支
git checkout my
git merge master

3. 问题处理

预览

1
hexo g && hexo s

与在线版本对比后，进行修改

  • 关闭载入动画
    编辑 theme/next/_config.yml
1
2
motion:
  enable: false
  • 站点 Title 字体变动
    设置为 Lato
  • 字体变大
    字体 size 设置为 0.9 后与之前的一致
1
2
3
4
global:
  external: true
  family: Ubuntu
  size: 0.9

  • 图片

    • 启用点击
      配置文件启用 fancybox
    • 给图片加个边框
    • 移除 Fancybox 的 Image Caption
      在自定义样式文件中添加
    1
    2
    3
    4
    5
    6
    7
    8
    9
    /*一通操作猛如虎，打开暗黑模式丑上天  
    .post-body img {
      margin: 0 auto;
      padding: 3px
      border: 1px solid #ddd;
    }*/
    .post-body .image-caption {
      display: none;
    }

    或是修改 next/source/css/_schemes/Mist/_posts-expand.styl

  • 顶部导航的 MENU 改为靠右对齐
    在自定义样式文件中添加

1
2
3
.menu {
  text-align: right;
}

或是编辑文件 themes/next/source/css/_schemes/Mist/_menu.styl

  • 文章多了 更新于...
    编辑 theme/next/_config.yml
1
2
3
post_meta:
  updated_at:
    enable: false
  • Footer 红心颜色
    设置为 "#666"
  • About 页面， HTML + Markdown 嵌套后不解析
    就一行，直接用 HTML 写了
  • 启用搜索
1
2
3
4
5
6
7
8
9
10
11
12
13
npm install hexo-generator-searchdb --save

#_config.yml
search:
  path: search.xml
  field: post
  format: html
  limit: 10000

# /theme/next/_config.yml
# Local search
  local_search:
  enable: true
  • 暗黑模式选中背景不清晰
    在自定义样式文件中添加
1
2
3
::selection {
    background-color: #424242;
}

  • Disqus load after click
    不会改了，反正也没有什么评论，正好也发现了 Twikoo ，换上。

  • 隐藏 Logo 的上横线
    这就需要编辑主题的源文件了
    next/layout/_partials/header/brand.njk
    找到下面内容， <i class="logo-line"></i> 一个是上横线，一个是下横线

1
2
3
4
5
<a href="{{ config.root }}" class="brand" rel="start">
      <i class="logo-line"></i>
      <{% if is_home() or is_archive() %}h1{% else %}p{% endif %} class="site-title">{{ title }}</{% if is_home() or is_archive() %}h1{% else %}p{% endif %}>
      <i class="logo-line"></i>
</a>

4. 设置 Twikoo

使用 docker 安装

1
2
3
docker pull imaegoo/twikoo

docker run --name twikoo -p 127.0.0.1:8080:8080 -v [path]/data:/app/data -d imaegoo/twikoo

使用 docker compose

相比 docker run 命令，使用 docker compose 更为简单，首先在创建一个文件夹，再创建 docker-compose.yml 文件。 

1
2
3
4
5
6
7
8
9
services:
  twikoo:
    image: imaegoo/twikoo:latest
    container_name: twikoo
    ports:
      - 127.0.0.1:8080:8080
    volumes:
      - /var/www/twikoo/data:/app/data
    restart: always
1
2
3
4
5
6
7
8
9
# 拉取、更新镜像
docker compose pull
# 启动后台
docker compose up -d

# 常用命令
docker compose stop     # 暂停容器
docker compose down     # 删除容器
docker compose restart  # 重启容器

设置 Nginx 反代

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
server{
  //...
  location / {
    proxy_pass 127.0.0.1:8080;

    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header REMOTE-HOST $remote_addr;
    add_header X-Cache $upstream_cache_status;
    # cache
    add_header Cache-Control no-cache;
    expires 12h;
  }
}

docker run 模式设置自启动

1
docker update --restart=always  twikoo

测试

访问使用的域名，如果成功则提示

1
{"code":100,"message":"Twikoo 云函数运行正常，...","version":"1.x.x"}

设置面板

第一次打开 Twikoo 面板，需要设置 密码 ，然后进入面板可以导入平路、设置站点信息、邮件发送、消息推送等功能。

Ref: Twikoo小白私有化部署教程,迁移腾讯云

部署到 Hexo

1
2
3
#NexT version 8.15.0 

npm install [email protected]

编辑配置主题文件，添加下面内容

1
2
3
4
twikoo:
  enable: true
  visitor: false
  envId: {url}
1
hexo g && hexo s

预览，然后点击 ⚙ 设置管理密码，然后进入面板设置。

5. 推送更新

1
2
3
npm install hexo-deployer-git

hexo d

已失效，新版请查看：Hexo 7.3 添加友链页面（Hexo Theme NexT）

添加自定义样式文件

先修改主题配置文件，开启自定义样式文件，将文件放在 Hexo 文件夹内，而不是主题的文件夹
编辑 themes/next/_config.yaml 

1
2
custom_file_path:
  style: source/_data/styles.styl

编辑或是创建 styles.styl，加入下面的样式

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
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
/* Links 页面样式 */
#links {
    margin-top: 5rem;
}

.links-content {
    margin-top: 1rem;
}

.link-navigation {
  display: flex;
  flex-wrap: wrap;
  justify-content: space-between;
}

.link-navigation::after {
 content: " ";
 display: block;
 clear: both;
}

.card {
    width: 280px;
    font-size: 1rem;
    padding: 10px 20px;
    border-radius: 4px;
    transition-duration: 0.15s;
    margin-bottom: 1rem;
    display: flex;
}

/* 鼠标悬浮时效果
.card:hover {
    transform: scale(1.1);
    box-shadow: 0 2px 6px 0 rgba(0, 0, 0, 0.12), 0 0 6px 0 rgba(0, 0, 0, 0.04);
} */

.card a {
    border: none;
}

.card .ava {
    width: 3rem !important;
    height: 3rem !important;
    margin: 0 !important;
    margin-right: 1em !important;
    border-radius: 4px;
    margin-top: 5px !important;
}

.card .card-header {
    font-style: italic;
    overflow: hidden;
    width: 236px;
}

.card .card-header a {
    font-style: normal;
    color: #2bbc8a;
    font-weight: bold;
    text-decoration: none;
}

.card .card-header a:hover {
    color: #d480aa;
    text-decoration: none;
}

.card .card-header .info {
    font-style: normal;
    color: #a3a3a3;
    font-size: 14px;
    min-width: 0;
    text-overflow: ellipsis;
    overflow: hidden;
    white-space: nowrap;
}

编辑主题配置文件，设置链接

1
2
3
menu:
  #...
  links: /links || fas fa-link

创建页面

1
hexo new page links

内容如下

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
---
title: Links
type: links
---

<div class="links-content">
    <div class="link-navigation">
        {% for link in site.data.links %}
        <div class="card"><img class="ava nomediumzoom" src="{{ link.avatar }}" />
            <div class="card-header">
                <div><a href="{{ link.site }}" target="_blank"> {{ link.name }}</a> </div>
                <div class="info">{{ link.info }}</div>
            </div>
        </div>
        {% endfor %}
    </div>
</div>

------

> 友接格式  
```md
- name: Homulilly
  info: Aroes's Blog | \萌脇舞以/
  site: https://homulilly.com/
  avatar: https://homulilly.com/images/avatar.jpg
  rss: https://homulilly.com/atom.xml
```

site.data 就是 source/_data 目录，后面的 links 就是后面创建的 links.yml 友链文件。

如果想再添加一组不同的链接，可以再建一个 linkb.yml => {% for link in site.data.linkb %}。

添加友链

在 source/_data/ 目录下新建 links.yml 文件，按照格式填入链接。

部署到 Hexo

links.yml 有改动时 hexo g 不会更新 links 页面，先 hexo clean 一下就可以了。

1
2
3
4
hexo clean 
hexo g && hexo s

hexo d

Ref: Hexo + NexT 8 添加友链

在 自定义样式 中添加 

1
2
3
4
5
6
7
8
/* 侧栏 Social Link */
.links-of-author a::before{
    display: none;
}

.links-of-author a{
    border-bottom: none;
}

8. 设置 Feed

1
npm install hexo-generator-feed

在 Hexo 主配置文件中加入 

1
2
3
4
5
6
7
plugin:
- hexo-generator-feed
#Feed Atom
feed:
type: atom
path: atom.xml
limit: 20

9. 主题文件中硬编码的内容备份

删除 NexT.Mist LOGO 顶部横线，删除第一个 <i class="logo-line"></i>

themes\next\layout\_partials\header\brand.njk
1
2
3
4
5
<a href="{{ config.root }}" class="brand" rel="start">
  <i class="logo-line"></i>
  <{% if is_home() or is_archive() %}h1{% else %}p{% endif %} class="site-title">{{ title }}</{% if is_home() or is_archive() %}h1{% else %}p{% endif %}>
  <i class="logo-line"></i>
</a>

导航菜单 links 翻译

themes\next\languages\zh-CN.yml
1
2
menu:
  links: 友链

修改颜色

themes\next\source\css\_variables\base.styl
1
2
3
$black-dim    = #303134;

$body-bg-color-dark           = #27272a;