白玻璃（whiteglass）：一个简约响应式的Jekyll主题教程-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00014/article/details/139035612

白玻璃（whiteglass）：一个简约响应式的Jekyll主题教程

whiteglass Minimal, responsive Jekyll theme for hackers 项目地址: https://gitcode.com/gh_mirrors/wh/whiteglass

白玻璃（whiteglass）是专为黑客设计的一个极简主义且响应式的Jekyll主题。它提供了一个干净的布局和易于定制的结构，非常适合个人博客或者小型项目站点。接下来，我们将详细介绍其核心结构、启动与配置环节。

1. 目录结构及介绍

白玻璃的主题结构设计清晰，便于开发者快速上手。以下是你在克隆仓库后大致会看到的目录结构：

.
├── _config.yml            # 主配置文件
├── _data                  # 包含数据文件，如i18n.yml用于国际化设置，navigation.yml定义导航菜单
├── _includes              # HTML片段，如页脚、头部等自定义代码
├── _layouts               # 布局模板，控制页面的整体架构
├── _posts                 # 博客文章存放地
├── _sass                  # SCSS样式文件，可以在此基础上进行CSS的定制
├── assets                 # 静态资源，包括图片、JavaScript文件等
│   └── main.scss          # 主样式表，可重写以定制外观
├── 404.md                 # 404错误页面
├── CHANGELOG.md           # 更新日志
├── Gemfile                # RubyGem依赖文件，用于管理Jekyll及其插件
├── LICENSE.txt            # 许可证文件
├── README.md              # 项目说明文档
├── Rakefile               # Rake任务，用于自动化一些操作
└── index.html             # 主页HTML模板

2. 启动文件介绍

白玻璃主题的启动核心在于正确配置 _config.yml 并运行Jekyll服务。虽然没有特定的“启动文件”，但整个流程通常始于编辑配置文件后执行Jekyll命令。

快速启动步骤：

在Jekyll项目根目录下，确保有正确的 Gemfile 和已安装所有必要的宝石。
编辑 _config.yml 文件来个性化你的网站，比如更改网站标题、作者信息等。
运行 bundle install 安装必要的依赖。
使用 bundle exec jekyll serve 来本地预览你的网站，访问 http://localhost:4000 查看结果。

3. 项目的配置文件介绍

_config.yml: 是白玻璃主题的心脏，几乎所有关于网站的基本设置都在此完成。一些关键配置项包括：

theme: 指定使用的Jekyll主题，对于whiteglass应设置为 "jekyll-whiteglass"。
plugins: 列出启用的插件，如 jekyll-archives, jekyll-paginate, jekyll-sitemap 等。
permalink: 设置文章的URL结构。
paginate: 分页功能的相关设置，如每页显示的文章数。
jekyll-archives: 如启用归档支持，可以设置展示类别和标签。
site.lang: 设置网站的主要语言，如 en-US 或其他ISO 639-1标准的语言代码。