安装和使用主题

🔗安装主题

安装主题最简单的方法是将其存储库克隆到themes 目录中：

$ cd themes
$ git clone <theme repository URL>

使用 Git 或其他 VCS 克隆存储库将使您可以轻松更新。或者，您可以手动下载文件并将它们放在一个文件夹中。

您可以在此处找到主题列表。

🔗使用主题

现在您的目录中有了主题themes，您需要通过theme在 配置文件中设置变量来告诉 Zola 使用它。主题名称必须是您在其中克隆主题的目录的名称。例如，如果您在 中克隆了一个主题themes/simple-blog，则在配置文件中使用的主题名称是simple-blog. 还要确保将变量放在层次结构的顶层 .toml，而不是像 [extra] 或 [markdown] 这样的字典之后。

🔗自定义主题

templates通过在您的或目录中创建具有相同路径和名称的文件，可以覆盖主题中的任何文件static 。这里有几个例子，假设主题名称是simple-blog：

templates/pages/post.html -> replace themes/simple-blog/templates/pages/post.html
templates/macros.html -> replace themes/simple-blog/templates/macros.html
static/js/site.js -> replace themes/simple-blog/static/js/site.js

如果主题通过扩展定义了一些块，您还可以选择仅覆盖页面的某些部分。如果我们只想更改post.html上面示例中页面的单个块，我们可以执行以下操作：

{% extends "simple-blog/templates/pages/post.html" %}

{% block some_block %}
Some custom data
{% endblock %}

大多数主题还将提供一些要被覆盖的变量。这发生在配置文件extra的部分。假设一个主题使用一个变量并将其设置为默认值。如果你想将它设置为，你可以这样更新你的：show_twitterfalsetrueconfig.toml

[extra]
show_twitter = true

您可以直接在目录中修改文件themes，但这会使更新主题变得更加困难，并且实时重新加载对这些文件不起作用。