StarryNights
每一个你所后悔的现在，都有一个不够努力的曾经
:D 一言 - 链接记忆, 走过时光, 正在获取中...
这是一篇用于个人查阅的 Hexo Shoka 主题使用手册占位文章。目前正文只有引言和 Todo 标记，具体配置、使用方法与操作步骤尚未展开。
本文是 Hexo 主题 Shoka 使用手册的引言部分，主要面向个人使用场景，目的在于整理和查阅该主题的相关说明与待办事项。内容以手册形式呈现，帮助使用者快速定位 Shoka 主题的使用要点、配置方法和后续维护方向，并作为个人查找 Todo 的参考文档。整体起到导航与索引作用，强调实用性和便捷性，便于后续按需补充和更新具体教程内容。
Hexo 主题 Shoka 使用手册，主要供个人使用时快速查阅。手册介绍了该主题的安装与配置方法，包括站点配置、主题配置、页面生成、评论系统、音乐播放器、图片展示等功能的使用说明，并涵盖自定义样式、插件依赖等进阶内容，帮助用户快速上手并个性化博客外观与功能。
Hexo 主题 Shoka 使用手册, 用于个人使用查找
Todo -----
读到此处，不妨再看看那些相关的篇章
文章介绍为 Shoka 增加文章时效性提示：根据最后更新时间与当前时间的间隔，在超过配置天数后，于正文顶部展示发布和更新距今的时间。实现涉及主题开关、多语言模板、前端配置及 PJAX 刷新调用，同时允许通过 Front-matter 为单篇文章关闭检查，并给出完整修改位置。
本文介绍为 Shoka 主题添加文章时效性提示的方法。通过修改 _config.yml、多语言文件、layout.njk、global.js、pjax.js 和 script.js，配置启用开关、超时天数、提示模板与多语言文本；再由脚本计算文章发布及最后更新距今时间，超过设定天数后在正文顶部插入警告。文章还可通过 Front-matter 的 isOutdated: false 单独关闭提示。
文章介绍了如何为 Hexo 的 Shoka 主题添加文章实效性提示功能：当文章最后一次更新距今超过设定天数（默认 30 天）时，在正文顶部显示警告提示，告知读者部分内容可能已过时。实现方式包括：在 _config.yml 中添加启用开关和天数配置；在五种语言文件中添加多语言提示模板；在 global.js 中编写计算发布与更新时间差并插入提示的函数；并在 pjax.js、script.js 和 layout.njk 中分别注册调用、注入配置和本地化变量。此外支持通过文章 Front-matter 设置 isOutdated: false 单独关闭检测。
为 主题添加文章实效性提示——文章发表时间过久，部分内容实际上可能以及过时，需要在显眼处给出浏览者实效性提示。 需要修改的文件列表如下，相对于 主题根目录 添加相关控制变量 添加实效性对应文本串，引入格式串文本，多语言适配 默认文章实效性检查是启用的，对于不想启用文章实效性的文章 可以在文章头部的 信息强制指定关闭实效性检测 或者您看到本文时，本文正文顶部已经出现了实效性提示。
文章借用 Shoka 归档页的时间轴样式展示文章修订历史。通过 Front-matter 的 changelogs 保存每次修改的概述和可选明细，在模板中逆序解析为可折叠的时间轴，并补充语言文本和日夜模式配色。文中给出样式、配置与模板代码，使后续维护只需填写更新记录。
文章介绍如何在Hexo主题中为文章添加修订记录时间轴。灵感来自归档时间轴，通过在文章Front-matter中配置changelogs记录更新摘要与明细，渲染时解析生成对应HTML，并复制修改归档样式，新增颜色变量和语言包键值，在post.njk模板中插入可折叠的时间轴代码。发布后即可在文章头部展示更新记录，实现优雅的历史版本展示。
这篇文章介绍了在 Hexo 的 Shoka 主题中，为文章添加“更新记录”时间轴效果的实现方法。作者受主题归档页时间轴启发，先复制归档样式新建 historytimeline.styl 并适当修改，同时在主题颜色变量文件中新增日间与夜间模式的文字及悬浮前景色，再在 post.styl 中引入。数据方面，利用文章 Front-matter 以 YAML 格式定义 changelogs 配置，包含 summary（修改概括）和 list（明细条目）。最后在文章框架模板 post.njk 中添加解析代码，将配置渲染为可折叠的时间轴 HTML，并在语言包中新增标题文案。完成后只需在文章头部写好配置，执行 Hexo 构建即可自动生成更新记录时间轴。
灵感来源于主题文章 归档 的时间轴效果，用同样时间轴的方式对文章修订记录进行展示 时间轴的实现，采用集成到主题的方式，使用文章 记录历史信息，在 渲染时，读取信息，解析成时间轴对应的 文本段 直接 主题的归档样式。 f12 查看样式，找到主题对应的归档时间轴样式在文件 内。 同级目录 下新建一个 文件，直接粘贴样式，进行简单修改即可，修改后的完整代码如下 其中的几个代表 颜色 的变量，定义在了主题文件 中，分别对应 日间和夜间 模式 时间轴 文字颜色和鼠标悬浮的前景颜色 最后在 最后面引入自定义样式 事实上有了上面的样式后，我们在文章的头部其实手撸 就能够写出历史时间轴了，但这样总归不够 优雅，和直接写页面有什么区别 于是我盯上了 …
文章介绍用 hexo-blog-encrypt 为 Hexo 文章设置密码，涵盖单篇配置、按标签统一加密，以及通过 Front-matter 豁免或覆盖密码。随后说明旧 Shoka 主题的适配方式，包括从原始正文生成目录、解锁前隐藏目录和添加加密标记，并指出单纯隐藏目录仍可在页面源码中看到其内容。
作者重启Hexo静态博客后，为保护隐私文章，采用hexo-blog-encrypt插件实现文章加密。文章介绍了插件安装、Front-matter配置、基于tag的全局加密，以及利用优先级实现单篇豁免或自定义密码。随后针对Shoka主题，通过修改模板解决解密后目录不显示的问题，并添加加密图标提示。整体分享了Hexo文章加密的完整实践与主题适配经验。
作者介绍了在 Hexo 静态博客中实现文章加密的方法。通过安装 hexo-blog-encrypt 插件，可在文章 Front-matter 中设置 password 加密，也可在 _config.yml 中按 tag 做全局加密配置。利用“文章配置优先于全局配置”的特性，可将 password 设为空字符串以豁免某篇文章的加密，或设置自定义密码。针对 Shoka 主题的适配，作者解决了加密文章解密后目录不显示的问题（改用 page.origin 生成目录），并通过折中方案实现解密前隐藏目录、解密后显示的效果，还为文章元数据添加了加密图标显示。
终于又重启博客了，平时开发折腾过程中遇到的一些问题，感觉不错的会发布到博客中。 但是有些文章如果存在隐私内容，或者不打算公开的话，就不能放在博客中了，但是一些文章挂在网页上又可以方便自己查看，于是折腾了下 的文章加密 以前用 的时候，也折腾过类似的需求，由于是 动态网站，所以其实还是比较方便的，这一次使用了 这个 静态博客 框架，说实话我都怀疑有没有可行的方案🤣🤣🤣 不过好在还是找到了一个 插件 能够实现文章加密的需求 使用如下命令安装 该插件的使用也很方便，使用时只需要在文章的 添加 即可。 下面展开讲一些比较实用的设置，更详细的可以查看官方文档。 D0n9X1n/hexo-blog-encrypt: Yet, just anot…
文章介绍为 Shoka 文章添加转载标记的方法，使用 Front-matter 的 reprintlink 字段记录来源，并以双竖线分隔显示文字和链接。模板在主页元信息及正文头部展示转载说明，无法追溯的网址则显示提示文本。文中列出语言字段和模板的修改位置，并给出不同配置的展示示例。
文章介绍为 Shoka 主题添加文章转载标记的方法。借由文章 Front-matter 中的 reprintlink 字段记录转载信息，以“||”分隔链接文本与网址；若只写一部分则两者共用，非 http 链接会提示原文出处暂无处追寻。实现上需修改 zh-CN.yml 增加多语言文案，并调整 postmeta.njk 与 post.njk，在主页缩略信息头部和正文头部展示转载标识与来源链接。
文章介绍了如何为 Hexo 的 Shoka 主题添加文章转载标记功能。作者通过在文章 Front-matter 中定义 reprintlink 字段标记转载信息，约定以"||"分割为链接文本和网址两部分；若网址非 http 开头则视为无法追溯原文，显示预设提示文本。具体实现需修改三个文件：在 zh-CN.yml 中添加转载相关多语言文本，在 postmeta.njk 中为主页文章缩略信息头部添加“转载”标签，在 post.njk 中于正文顶部解析 Front-matter 并生成带超链接的转载提示信息。
尊重原创，为 主题添加文章转载标记——在主页文章缩略信息头部 和 正文头部添加转载信息 主要利用 文章 标记转载信息，在生成发布文章时进行解析添加相关转载信息 关于 标记的约定 以 作为分割，分为左右两部分 第一部分：代表链接显示的文本内容已经指向超链接时显示的文本内容 第二部分：代表链接网址 注意：可以只有第一部分，那么链接文本和网址均使用这一部分的内容，如果链接网址非 开头，默认转载链接不可追溯，使用 代指的文本串做文本提示(添加到 等文本中的字符码)，一些案列如下 🚀 本文转载自：互联网『原文出处暂无处追寻』 🚀 本文转载自：https://www.baidu.com 🚀 本文转载自：百度 需要修改的文件列表如下，相对于 主题…
有什么想法，欢迎留下评论。