无强制 JavaScript (转译)

  • 更新于 1 7月 2024

此主题不包含强制性的 JavaScript。可选地,它可以加载最小量的 JavaScript 以添加一些仅通过 HTML 和 CSS 无法实现的功能。

全局启用设置

  • 搜索。通过设置默认语言和 build_search_index = trueconfig.toml 的主部分上启用。(~23KB 的 JavaScript)

  • 通过在您的 config.toml 中的 [extra] 部分设置 theme_switcher = true,可以启用亮/暗模式切换(约 1KB 的 JavaScript)。

  • 电子邮件解码(约 400 字节)。为了防止垃圾邮件机器人从您的网站抓取电子邮件,您可以设置 encode_plaintext_email = true。如果您的网站在公共仓库上,为了额外的保护,请考虑将您的 email 设置为直接编码为 base64 的字符串[1]

具有层次覆盖功能的设置

以下设置可以按照 page > section > config.toml 的层次结构为文章、章节和全局指定:

指定这些设置:

  • 全局: 将它们添加到您的 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 也能工作。正如(大多数)网页应该做到的那样 :-)


  1. 要将您的电子邮件编码为 base64,您可以使用在线工具,或者在终端运行:printf '[email protected]' | base64