无强制 JavaScript (转译)
此主题不包含强制性的 JavaScript。可选地,它可以加载最小量的 JavaScript 以添加一些仅通过 HTML 和 CSS 无法实现的功能。
全局启用设置
搜索。通过设置默认语言和
build_search_index = true
在config.toml
的主部分上启用。(~23KB 的 JavaScript)通过在您的
config.toml
中的[extra]
部分设置theme_switcher = true
,可以启用亮/暗模式切换(约 1KB 的 JavaScript)。电子邮件解码(约 400 字节)。为了防止垃圾邮件机器人从您的网站抓取电子邮件,您可以设置
encode_plaintext_email = true
。如果您的网站在公共仓库上,为了额外的保护,请考虑将您的email
设置为直接编码为 base64 的字符串[1] 。
具有层次覆盖功能的设置
以下设置可以按照 page > section > config.toml
的层次结构为文章、章节和全局指定:
- KaTeX 支持。 通过设置
copy_button = true
启用。(~700 字节)。 - 一键复制代码块。 通过设置
copy_button = true
启用。(~700 字节) - 在代码块中显示源(路径或 URL). 通过设置
add_src_to_code_block = true
启用。(~300 字节)
指定这些设置:
- 全局: 将它们添加到您的
config.toml
文件中的[extra]
部分下。 - 对于局部: 将它们添加到该部分
_index.md
的前置中的[extra]
部分下。 - 对于单篇文章: 在文章的前置配置中的
[extra]
部分设置相应的变量。
设置可以全局或针对单个文章启用
- 评论。通过在您的
config.toml
正确部分设置enabled_for_all_posts = true
(即[extra.giscus]
、[extra.utterances]
、[extra.hyvortalk]
或[extra.isso]
),可以全局启用 giscus(2 KB)、utterances(1 KB)、Hyvor Talk(约 800 字节)或 Isso(1KB)。要在单个帖子中启用评论,请在文章的前置部分设置系统名称= true
(例如hyvortalk = true
)。
除此之外,这是一个快速的主题,使用 HTML 和 CSS,即使禁用 JavaScript 也能工作。正如(大多数)网页应该做到的那样 :-)
要将您的电子邮件编码为 base64,您可以使用在线工具,或者在终端运行:
printf '[email protected]' | base64
↩