Jekyll Whiteglass 主题使用教程
1. 项目的目录结构及介绍
Jekyll Whiteglass 主题的目录结构遵循标准的 Jekyll 项目结构。以下是主要目录和文件的介绍:
whiteglass/
├── _config.yml
├── _data
│ └── navigation.yml
├── _includes
│ ├── footer.html
│ ├── head.html
│ ├── header.html
│ └── ...
├── _layouts
│ ├── default.html
│ ├── home.html
│ ├── page.html
│ └── post.html
├── _posts
│ └── 2023-01-01-welcome-to-jekyll.markdown
├── _sass
│ ├── _base.scss
│ ├── _layout.scss
│ └── ...
├── assets
│ ├── css
│ ├── images
│ └── js
├── Gemfile
├── index.html
└── ...
_config.yml
: 项目的配置文件。_data/navigation.yml
: 导航菜单的配置文件。_includes/
: 包含可重用的 HTML 片段。_layouts/
: 包含页面的布局模板。_posts/
: 存放博客文章的目录。_sass/
: 包含 SASS 样式文件。assets/
: 存放静态资源,如 CSS、图片和 JavaScript 文件。Gemfile
: 定义项目依赖的 Gem 文件。index.html
: 网站的首页。
2. 项目的启动文件介绍
Jekyll Whiteglass 主题的启动文件主要是 index.html
和 _config.yml
。
index.html
: 这是网站的首页文件,它使用home
布局来展示博客文章列表。
---
layout: home
---
_config.yml
: 这是 Jekyll 项目的主要配置文件,包含了网站的基本设置、插件配置、主题配置等。
title: 你的博客标题
email: 你的邮箱
description: 你的博客描述
baseurl: ""
url: "http://你的域名.com"
theme: jekyll-whiteglass
plugins:
- jekyll-archives
- jekyll-paginate
- jekyll-sitemap
permalink: /:year/:month/:day/:title/
paginate_path: /page:num/
3. 项目的配置文件介绍
Jekyll Whiteglass 主题的配置文件是 _config.yml
,它包含了多个配置选项,以下是一些关键配置的介绍:
title
: 网站的标题。email
: 联系邮箱。description
: 网站的描述。baseurl
: 网站的基本 URL(通常为空字符串)。url
: 网站的完整 URL。theme
: 使用的主题名称,这里是jekyll-whiteglass
。plugins
: 启用的 Jekyll 插件列表。permalink
: 文章的永久链接格式。paginate_path
: 分页路径格式。
通过编辑 _config.yml
文件,你可以自定义网站的外观和行为。例如,你可以添加社交媒体链接、修改导航菜单、配置归档页面等。
希望这份教程能帮助你更好地使用 Jekyll Whiteglass 主题。如果有任何问题,请参考官方文档或社区支持。