Jekyll 主题 Persephone 使用教程

Jekyll 主题 Persephone 使用教程

1. 项目的目录结构及介绍

Persephone 主题的目录结构如下：

jekyll-theme-persephone/
├── _includes/
├── _layouts/
├── _sass/
├── assets/
├── Gemfile
├── Gemfile.lock
├── _config.yml
├── index.md
└── README.md

• _includes/：包含可重用的 HTML 片段。
• _layouts/：包含页面的布局模板。
• _sass/：包含 SASS 文件，用于生成 CSS 样式。
• assets/：包含静态资源，如图片、JavaScript 文件等。
• Gemfile 和 Gemfile.lock：定义项目依赖的 Ruby gems。
• _config.yml：Jekyll 的配置文件。
• index.md：网站的首页内容。
• README.md：项目的说明文档。

2. 项目的启动文件介绍

Persephone 主题的启动文件主要是 Gemfile 和 _config.yml。

Gemfile

Gemfile 定义了项目依赖的 Ruby gems，内容如下：

source "https://rubygems.org"

gem "jekyll", "~> 4.0"
gem "jekyll-theme-persephone"

_config.yml

_config.yml 是 Jekyll 的主要配置文件，内容如下：

title: 你的网站标题
description: 你的网站描述
baseurl: "" # 网站的子路径，如 "/blog"
url: "http://你的网站地址.com"

theme: jekyll-theme-persephone

# 其他配置项...

3. 项目的配置文件介绍

_config.yml

_config.yml 文件包含了网站的基本配置，如标题、描述、URL 等。以下是一些常用的配置项：

title: 你的网站标题
description: 你的网站描述
baseurl: "" # 网站的子路径，如 "/blog"
url: "http://你的网站地址.com"

theme: jekyll-theme-persephone

# 评论系统配置
comments:
  provider: "disqus"
  disqus:
    shortname: "你的disqus短名称"

# 分页配置
paginate: 5
paginate_path: "/page:num/"

# 其他配置项...

通过修改 _config.yml 文件，可以自定义网站的外观和行为。

---

以上是 Persephone 主题的基本使用教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望对你有所帮助！