Cyanide 主题配置与启动教程

2025-05-15 10:01:43作者：裴锟轩Denise

1. 项目目录结构及介绍

Cyanide 主题的目录结构如下所示：

cyanide-theme/
├── assets/          # 存放静态资源，如图片、CSS、JavaScript 文件等
│   ├── css/
│   ├── js/
│   └── img/
├── layout/          # 存放页面布局的文件
│   ├── _default/
│   ├── _includes/
│   └── index.html
├── content/         # 存放网站内容，如文章、页面等
├── data/            # 存放数据文件，如 JSON、CSV 等
├── static/          # 存放静态文件，如 CSS、JavaScript 等
├── themes/          # 存放主题文件
│   └── cyanide/
├── config.toml      # 配置文件
└── README.md        # 项目说明文件

assets/: 存放所有静态资源，如CSS、JavaScript和图片等。
layout/: 包含网站的布局文件，如默认布局、包含文件以及首页布局。
content/: 存放网站的内容，如博客文章和页面。
data/: 存放用于模板中的数据文件。
static/: 存放一些额外的静态文件。
themes/: 存放主题相关的文件。
config.toml: 网站的配置文件。
README.md: 项目的说明文件。

2. 项目的启动文件介绍

在 layout/ 目录下的 _default/ 文件夹中，包含了主题的基本布局文件，例如 index.html、single.html、list.html 等。这些文件定义了页面的基本结构和样式。

以 index.html 为例，它通常包含以下内容：

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <!-- ... -->
</head>
<body>
    <!-- 页面内容 -->
</body>
</html>

这些布局文件会使用 Go语言的HTML模板语法，根据 content/ 目录下的内容动态生成网页。

3. 项目的配置文件介绍

项目的配置文件是 config.toml，它位于项目根目录下。这个文件定义了网站的元数据、标题、主题设置等。

以下是一个基本的 config.toml 文件示例：

baseURL = "https://example.com/"
languageCode = "zh-CN"
title = "我的网站"

[params]
    description = "这是我的网站描述"

[menu]
  [[menu.main]]
    name = "首页"
    weight = 1
    identifier = "index"
    url = "/"

  [[menu.main]]
    name = "关于"
    weight = 2
    identifier = "about"
    url = "/about/"