Jekyll 主题 YAT 深入指南

Jekyll 主题 YAT 深入指南

jekyll-theme-yat🎨 Yet another theme for elegant writers with modern flat style and beautiful night/dark mode.项目地址:https://gitcode.com/gh_mirrors/je/jekyll-theme-yat

1. 项目目录结构及介绍

YAT 主题的目录结构如下：

.
├── _data                # 存放数据文件
├── _includes            # 包含部分（用于模板重用）
├── _layouts             # 页面布局定义
├── _posts               # 博客文章源文件
├── _sass                # SCSS 样式文件
├── assets               # 资产文件，如 CSS, JS, 图片等
├── _config.yml          # 网站全局配置文件
├── about.html           # 关于页面
├── archives.html        # 归档页面
├── categories.html      # 分类页面
├── index.html           # 主页
├── jekyll-theme-yat.gemspec # 主题 gem 规范文件
├── README.md            # 项目说明文件
└── ...

• _data: 存储 YAML 或 JSON 格式的数据文件，可在 Liquid 模板中使用。
• _includes: 用于存放可复用的 HTML 片断，可以通过 {{% include %}} 引入。
• _layouts: 包含不同类型的页面模板，比如主页、文章、标签页等。
• _posts: 存放博客文章的 Markdown 文件，遵循特定命名规则。
• _sass: 使用 SCSS 编写的样式表。
• assets: 静态资源文件夹，包括 CSS、JS 和图片等。
• _config.yml: 网站的全局配置文件，定义站点的属性和行为。
• about.html, archives.html, categories.html: 自定义的静态页面示例。
• index.html: 网站首页模板。
• jekyll-theme-yat.gemspec: 描述主题 gem 的元数据。

2. 项目的启动文件介绍

对于 Jekyll 网站，启动文件通常是 _config.yml。这个文件包含了网站的配置选项，例如站点标题、作者、URL 等。此外，还可以设置页面布局、启用插件、自定义导航菜单和各种其他高级配置。例如：

title: 我的博客
description: 这是关于我的个人博客
author: 张三
baseurl: "/" # 你的 GitHub Pages 站点前缀
url: "http://example.com" # 网站的域名
theme: yat # 指定使用 YAT 主题

# 更多配置...

3. 项目的配置文件介绍

_config.yml 文件是 Jekyll 网站的核心配置文件。以下是一些关键的配置项说明：

• title 和 description：分别表示网站标题和描述。
• author：网站作者的名字。
• baseurl：用于定位静态文件的根路径，通常在使用 GitHub Pages 时设置。
• url：完整的网站 URL，用于生成绝对链接。
• theme: 设置使用的 Jekyll 主题，这里设置为 YAT。

除此之外，YAT 主题还支持更多的特性配置，如启用夜色模式、自定义导航菜单、Google Analytics ID、社交网络链接等。在 _config.yml 中查找这些配置并按需设置即可。

记得在修改配置文件后运行 jekyll serve 来本地预览效果，或提交更改到 GitHub 以更新 GitHub Pages 网站。

jekyll-theme-yat🎨 Yet another theme for elegant writers with modern flat style and beautiful night/dark mode.项目地址:https://gitcode.com/gh_mirrors/je/jekyll-theme-yat