Zola-Theme-Terminimal 使用教程

Zola-Theme-Terminimal 使用教程

zola-theme-terminimal A simple, minimal retro theme for Zola 项目地址: https://gitcode.com/gh_mirrors/zo/zola-theme-terminimal

1. 项目介绍

Zola-Theme-Terminimal 是一个为 Zola 静态站点生成器设计的简单、最小化复古主题。它基于 "Terminal" Hugo 主题，由 Radosław Kozieł 开发。Terminimal 主题提供了一系列自定义选项，包括颜色配置、菜单定制、文章描述显示等，使其成为一个高度可定制的主题。

2. 项目快速启动

在开始使用 Zola-Theme-Terminimal 之前，请确保你已经安装了 Zola。

克隆主题

你可以通过以下两种方式将主题克隆到你的 Zola 站点文件夹中：

# 方法一：直接克隆主题
git clone https://github.com/pawroman/zola-theme-terminimal.git themes/terminimal

# 方法二：作为 git submodule
git submodule add https://github.com/pawroman/zola-theme-terminimal.git themes/terminimal

配置主题

在你的 config.toml 文件中，设置以下内容来使用 Terminimal 主题：

theme = "terminimal"
compile_sass = true

启动 Zola 服务

配置完成后，启动 Zola 服务来预览你的站点：

zola serve

现在你应该能在浏览器中访问 http://localhost:8000 来查看你的站点。

3. 应用案例和最佳实践

自定义颜色

你可以在 config.toml 文件中通过 extra 部分来自定义主题颜色：

[extra]
accent_color = "green"
background_color = "dark"

配置菜单

在 config.toml 文件中配置菜单项：

[extra]
menu_items = [
    {name = "blog", url = "$BASE_URL"},
    {name = "tags", url = "$BASE_URL/tags"},
    {name = "archive", url = "$BASE_URL/archive"},
    {name = "about me", url = "$BASE_URL/about"},
    {name = "github", url = "url-to-your-github", newtab = true},
]

添加文章描述

在你的文章文件中，你可以添加 description 字段来在主页上显示描述而不是摘要：

+++
description = "test description"
[extra]
show_only_description = true
+++

4. 典型生态项目

目前没有明确的 "典型生态项目" 与 Zola-Theme-Terminimal 直接关联。不过，你可以探索 Zola 社区和其他使用 Terminimal 主题的站点来获取灵感。

请确保在实际部署前充分测试所有自定义设置，以确保主题按预期工作。

zola-theme-terminimal A simple, minimal retro theme for Zola 项目地址: https://gitcode.com/gh_mirrors/zo/zola-theme-terminimal