Jekyll TeXt 主题项目教程

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

Jekyll TeXt 主题的目录结构如下：

├── 404.html
├── Gemfile
├── _config.yml
├── _data
│   └── locale.yml
├── _includes
├── _layouts
├── _posts
├── _sass
├── assets
├── docker
├── docs
├── screenshots
├── test
├── tools
├── about.md
├── archive.html
└── index.html

目录结构介绍

• 404.html: 自定义的404错误页面。
• Gemfile: 定义了项目所需的Ruby gem依赖。
• _config.yml: Jekyll 的配置文件，包含站点配置、主题配置等。
• _data: 存放站点数据文件，如 locale.yml 用于国际化配置。
• _includes: 存放可重用的HTML片段，如页眉、页脚等。
• _layouts: 存放页面布局模板。
• _posts: 存放博客文章，文件名格式为 YYYY-MM-DD-title.md。
• _sass: 存放Sass样式文件。
• assets: 存放静态资源文件，如CSS、JavaScript、图片等。
• docker: 存放Docker相关文件，用于容器化部署。
• docs: 存放项目文档。
• screenshots: 存放项目截图。
• test: 存放测试文件。
• tools: 存放工具脚本。
• about.md: 关于页面的Markdown文件。
• archive.html: 归档页面的HTML文件。
• index.html: 首页的HTML文件。

2. 项目的启动文件介绍

Jekyll TeXt 主题的启动文件主要是 index.html 和 _config.yml。

index.html

index.html 是站点的首页文件，通常包含站点的基本结构和内容。它使用了 _layouts 目录中的布局模板来渲染页面。

_config.yml

_config.yml 是 Jekyll 的配置文件，包含了站点的全局配置、主题配置、插件配置等。以下是一些常见的配置项：

title: 我的博客
description: 这是一个使用 Jekyll TeXt 主题的博客。
url: "https://example.com"
baseurl: ""

theme: jekyll-text-theme

plugins:
  - jekyll-feed
  - jekyll-seo-tag

markdown: kramdown
kramdown:
  input: GFM

3. 项目的配置文件介绍

Jekyll TeXt 主题的配置文件主要是 _config.yml，它包含了站点的各种配置选项。以下是一些常见的配置项及其作用：

基本配置

• title: 站点的标题。
• description: 站点的描述。
• url: 站点的URL。
• baseurl: 站点的基本路径（通常为空）。

主题配置

• theme: 使用的主题名称，这里是 jekyll-text-theme。

插件配置

• plugins: 定义了站点使用的Jekyll插件，如 jekyll-feed 用于生成RSS订阅，jekyll-seo-tag 用于SEO优化。

Markdown 配置

• markdown: 使用的Markdown解析器，这里是 kramdown。
• kramdown: 配置 kramdown 解析器的选项，如 input: GFM 表示使用GitHub Flavored Markdown。

通过这些配置，可以灵活地定制站点的外观和功能。