本站的更新和维护记录

2021-05-04
作者 Suite
~16.19K 字
次阅读

1. 站点主题
1. 1.1. 站点主题-图片
2. 站点-网站配置
1. 2.1. 站点所有权验证
2. 2.2. 站点永久链接
3. 站点-文章
1. 3.1. 站点-文章-评论系统
4. 📖参看
5. ※参考和引用
6. 🔗外部链接

本站的更新和维护记录。

站点主题

根据分类或标签检索的文章列表异常：文章置顶功能失效。
相关BUG
- 【待解决】Bug 回报：主题配置 → 文章页面：【sticky】对应的数字权重与使用指南不一致 #53 - github.com
补充说明
- BUG 已提交，暂未解决。
- BUG 涉及第三方插件，站点主题源作者已向第三方提交 Issue 作为 BUG 跟进。
  
  相关截图：

站点主题-图片

将站点主题的图片文件统一调整为 WebP 格式
将站点主题的图片文件统一调整为 WebP 格式 👆
- 图片文件路径，相对于主题根目录：themes\Kratos-Rebirth\source\images\及其子文件
- 目的：
  
  统一文件格式，便于管理；（次要）
  
  节省存储空间√~~紧跟潮流🎵~~。（主要）
- 使用工具 —— ezgif.com
  
  截图：

文章随机图标的自定义配置

调试时发现站点主题中的文章随机图标有数量上限

站点主题中的文章随机图标的实际数量上限为20。~~可恶，我还想要100张美图！prprpr~~~

解决方案 👆

【已解决】已向站点主题的开源作者Candinya🍭 提交 ISSUE。

（在站点主题的配置文件_config.yml中）使用新的配置项random_amount ⤵

# JavaScript 相关配置
## 由于 Javascript 被压缩后难以有效编辑与生成，因而为了简化操作，将相关的配置项在生成文件时以独立的 json 文件写出，调用时使用 fetch API 获取。
jsconfig:
  main:
    pic:
      CDN: false # 表示不使用CDN加载图片
      # 注意：如果"random_amount"配置项的值大于随机图片的数量，则会在站点运行时出现找不到图片的显示问题
      random_amount: 104 # 表示从1~104
      # 如果包含<code>//</code>表示使用指定域名的绝对路径（例如第三方图床服务等），此时会忽略CDN配置项
      filename: "images/thumb/thumb_{no}.webp" # 相对于主题根目录，表示文件名的格式，{no}用以指代随机的编号。

注意：

配置项random_amount的值应该等于随机图片的数量，且随机图片的序号从1开始递增且不间断。
⤷ 如果”random_amount”配置项的值大于随机图片的数量，则会在站点运行时出现找不到图片的显示问题。

本地服务与在线服务的图片不一致问题

问题简述

「文章随机图标的自定义配置」完成之后，在[在线服务]上检查时发现大多数文章的随机图标缺失。
排查过程 & 解决方案 👆
- 最开始，先入为主地认为问题出在 Travis CI 的部署过程中，浪费了很多时间……
- 之后，检查了用于部署的Github仓库分支gh-pages，发现只有建站时的20张图片 🡆 顺藤摸瓜找到了主分支main上对应的文件，也是这么个情况。
  
  ⤷ 检查【站点主题】仓库根目录下的.gitignore配置文件，并修正相应的配置项 ⤵
  
  1
  2
  # 站点图像
  #source/images/
  
  终于，图片如期所愿上传成功。 ⤵
- 最后，本地确认无误后提交代码，在线确认问题已解决。
经验教训 👆
- 避免先入为主。
- 线上问题：网页信息 🡆 Github仓库对应分支（主要检查是否与本地文件一致） 🡆 本地文件 🡆 凭经验结合文档记录排查问题 & Google搜索。

文章区域的背景图片
1. 选图；
  上P站……
2. 抠图 → 背景透明。
  工具选择
  - Clipping Magic: 立即删除在线图像背景
  操作步骤
  👆
  
  上传图片，（自动）智能AI抠掉背景；
  
  可以选择绿色和红色区域刷（裁剪小刀工具不怎么会用）来修正。
  右侧是预览图，很直观。
  
  需要注意网络问题，建议操作频率不要太高。
  
  下载图片（需要破费一下，但是真的很好用；主要还是方便，随时随地都能处理）
3. 合成图片
  工具选择
  - Win 10 自带的 3D画图工具。
  操作步骤
  👆
  
  打开其中一张图片。
  
  显示画布
  
  透明画布
  
  锁定纵横比
  
  通过画布调整图像大小
  
  调整宽度和高度，并确认单位（默认为像素）
  
  插入另一张图片
  
  提示：
  
  水平位移可以使用 [ 选择边框水平拉伸，再通过右侧选项菜单恢复原始宽度 ] 的方式来实现。
  
  调整合成后的图片
  
  （意外问题）发现其中一张图片的抠图处理有瑕疵 → 最后找朋友拿到 PhotoShop 软件，通过 PhtoShop 的魔术棒功能抠掉了瑕疵。
  
  最后重复第1~3步的操作，完成了此次「合成图片」操作。
4. 图片虚化（调整透明度）
  工具选择
  - PhotoShop
  操作步骤
  
  在 PhotoShop 中，选择对应的图层，调整选项菜单里的“不透明度”选项即可。
5. 转换图片格式为.webp
  工具选择
  - Animated GIF editor and GIF maker - ezgif.com

站点-网站配置

站点所有权验证

参考-文档

[ Kratos-Rebirth食用说明 | 糖菓·部落 ]#[ 主题配置 ]#[ Site verify related 站点所有权验证相关 ]

搜索引擎 - Google

站点永久链接

永久链接 → [ 多语种支持 & 使用布局(Layout)名称 ]
参看文档
- 功能：在永久链接中，实现多语种支持。
  - [ 永久链接（Permalinks） | Hexo ]#[ 多语种支持 ]
  - Front-matter | Hexo
  - （相关配置）[ 国际化（i18n） | Hexo ]#[ 路径 ]
  - （相关标准）
    
    ISO 639-1 - 维基百科，自由的百科全书
    
    Language Code Table - lingoes.net
- 功能：在永久链接中，使用布局(Layout)名称。
  - [ Front-matter | Hexo ]#[ 布局 ]
解决方案 & 功能实现
功能：在永久链接中，实现多语种支持

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

备注 👆

全局变量的相关使用方式不明确，官方文档缺乏详细的说明 / 已过时。

最终确定：使用文章模板来直接实现配置。
1. 在项目根目录下的站点配置文件（_config.yml）中，permalink配置项使用:lang配置值。
  1
  permalink: :lang/:layout/:title/
2. ⤷ 同时，在permalink_defaults配置项下，添加lang子配置项及其配置值。
  1
  2
  permalink_defaults:
  lang: zh # 缺省值为"zh"（指代中文）
3. 在项目根目录下的scaffolds文件夹中，修改指定的文章模板post.md（也可以是其他名称的模板） —— 在 Front-matter 区域中，添加lang配置项及其配置值。
  1
  2
  3
  4
  5
  6
  7
  8
  9
  10
  11
  12
  13
  14
  15
  ---
  title: {{ title }}
  date: {{ date }}
  lang: zh
  categories:
  tags:
  sticky: 0
  pic:
  comments: true
  toc: true
  only:
  - home
  - category
  - tag
  ---
功能：在永久链接中，使用布局(Layout)名称

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
1. 在项目根目录下的站点配置文件（_config.yml）中，permalink配置项使用:layout配置值。
  1
  permalink: :lang/:layout/:title/
实现效果

站点-文章

文章中声明但未赋值配置项，导致站点服务启动抛错（不影响服务启动，但是对应文章加载失败）。

错误信息

（截选） 👆

INFO  352 files generated in 1.58 s
INFO  Validating config
INFO  Start processing
ERROR {
  err: ValidationError: `null` is not a string!
      at new WarehouseError (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\warehouse\lib\error.js:14:11)
      at new ValidationError (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\warehouse\lib\error\validation.js:5:1)
      at SchemaTypeString.validate (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\warehouse\lib\types\string.js:36:13)
      at Array.<anonymous> (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\warehouse\lib\schema.js:510:27)
      at Schema._applySetters (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\warehouse\lib\schema.js:640:15)
      at _Model._insertOne (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\warehouse\lib\model.js:158:12)
      at E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\warehouse\lib\model.js:179:63
      at tryCatcher (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\bluebird\js\release\util.js:16:23)
      at E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\bluebird\js\release\using.js:185:26
      at tryCatcher (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\bluebird\js\release\util.js:16:23)
      at Promise._settlePromiseFromHandler (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\bluebird\js\release\promise.js:547:31)
      at Promise._settlePromise (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\bluebird\js\release\promise.js:604:18)
      at Promise._settlePromise0 (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\bluebird\js\release\promise.js:649:10)
      at Promise._settlePromises (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\bluebird\js\release\promise.js:729:18)
      at Promise._fulfill (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\bluebird\js\release\promise.js:673:18)
      at PromiseArray._resolve (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\bluebird\js\release\promise_array.js:127:19)
      at PromiseArray._promiseFulfilled (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\bluebird\js\release\promise_array.js:145:14)
      at Promise._settlePromise (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\bluebird\js\release\promise.js:609:26)
      at Promise._settlePromise0 (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\bluebird\js\release\promise.js:649:10)
      at Promise._settlePromises (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\bluebird\js\release\promise.js:729:18)
      at _drainQueueStep (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\bluebird\js\release\async.js:93:12)
      at _drainQueue (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\bluebird\js\release\async.js:86:9) {
    code: undefined
  }
} Process failed: %s _posts/【Linux第一作者】Linus-Torvalds.md
INFO  Hexo is running at http://localhost:4000 . Press Ctrl+C to stop.
ERROR {
  err: ValidationError: `null` is not a string!
      at new WarehouseError (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\warehouse\lib\error.js:14:11)
      at new ValidationError (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\warehouse\lib\error\validation.js:5:1)
      at SchemaTypeString.validate (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\warehouse\lib\types\string.js:36:13)
      at Array.<anonymous> (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\warehouse\lib\schema.js:510:27)
      at Schema._applySetters (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\warehouse\lib\schema.js:640:15)
      at _Model._insertOne (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\warehouse\lib\model.js:158:12)
      at E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\warehouse\lib\model.js:179:63
      at tryCatcher (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\bluebird\js\release\util.js:16:23)
      at E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\bluebird\js\release\using.js:185:26
      at tryCatcher (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\bluebird\js\release\util.js:16:23)
      at Promise._settlePromiseFromHandler (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\bluebird\js\release\promise.js:547:31)
      at Promise._settlePromise (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\bluebird\js\release\promise.js:604:18)
      at Promise._settlePromise0 (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\bluebird\js\release\promise.js:649:10)
      at Promise._settlePromises (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\bluebird\js\release\promise.js:729:18)
      at Promise._fulfill (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\bluebird\js\release\promise.js:673:18)
      at PromiseArray._resolve (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\bluebird\js\release\promise_array.js:127:19)
      at PromiseArray._promiseFulfilled (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\bluebird\js\release\promise_array.js:145:14)
      at Promise._settlePromise (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\bluebird\js\release\promise.js:609:26)
      at Promise._settlePromise0 (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\bluebird\js\release\promise.js:649:10)
      at Promise._settlePromises (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\bluebird\js\release\promise.js:729:18)
      at _drainQueueStep (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\bluebird\js\release\async.js:93:12)
      at _drainQueue (E:\Computer Programming\Git\Git Repositories\SuiteLHY.github.io\node_modules\bluebird\js\release\async.js:86:9) {
    code: undefined
  }
} Process failed: %s _posts/【Linux第一作者】Linus-Torvalds.md
Deprecated as of 10.7.0. highlight(lang, code, ...args) has been deprecated.
Deprecated as of 10.7.0. Please use highlight(code, options) instead.
https://github.com/highlightjs/highlight.js/issues/2277

站点-文章-评论系统

通过【站点主题】使用文章评论系统以及阅读统计
参考文档
- [ Kratos-Rebirth食用说明 | 糖菓·部落 ]#[ Valine-评论相关 ]
- [ Kratos-Rebirth食用说明 | 糖菓·部落 ]#[ Post-Page-文章页面相关 ]
相关网站
- LeanCloud - console.leancloud.cn
业务实现
👆
根据参考文档的说明，选择合适的评论系统，按照步骤到对应平台注册应用，并获取调用该平台服务接口所需的必要数据。

根据所获取的必要数据，参看【参考文档】，配置完成后重启本地服务。本地验证通过以后上传代码，最后在线验证通过，业务实现。
补充 & 拓展
👆
一顿操作操作猛如虎，幡然醒悟“0-25” —— 我^TMD怎么把配置文件直接上传Github了呢¿数据没有脱敏，更新一时爽，补救泪汪汪 orz

解决方案，暴露的是公钥，只要在平台上绑定域名就能救；结果是还没有备案，绑定失败；果断考虑更换平台。

这个时候才想起来，选用评论系统的时候，还没有细致地比对各个平台地优劣。好家伙，比对发现 DisqusJS 才是香饽饽，反向代理，还能保证稳定过墙，甚至【站点主题】的源作者也选了这玩意，~~前方道路已铺平~~只能有时间再开坑吧，先立个 Flag。

关于配置文件数据脱敏，网上查资料主要是两种解决方案：一种是不上传配置文件，在.gitignore中配置好过滤掉敏感文件，敏感文件不通过Github进行部署；另一种是对敏感文件进行数据脱敏，用本地变量替换所有敏感数据。

其实上述两种解决方案都不错，但是我懒，我打算走第三种：给敏感文件专门开一个git子项目，上传到Github的私有仓库（同本站的【博文仓库】Git子项目）。

可行性还没有确认；

暂时没时间精力弄；

最终决定，目前“咕”置。晚安

📖参看

主要参看📖

Hexo博客Next主题SEO优化方法 | hoxis' blog

主要参看📖（站内资源）

本站的搭建记录 | 夜与花海🖇

分类：解决问题✅

分类：工具🧰 | 查阅🔍

分类：其他（二度及以上关联☌）

怎么样让自己的博客被谷歌和百度收录！ - SegmentFault 思否

※参考和引用

^ 维基百科，自由的百科全书

夜与花海