Jekyll Whiteglass 主题使用教程

Jekyll Whiteglass 主题使用教程

whiteglassMinimal, responsive Jekyll theme for hackers项目地址:https://gitcode.com/gh_mirrors/wh/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 主题。如果有任何问题，请参考官方文档或社区支持。

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