Jekyll-Clean 主题使用教程

1. 项目目录结构及介绍

Jekyll-Clean 是一个基于 Jekyll 的简洁主题，适用于构建个人博客。以下是项目的目录结构及文件介绍：

jekyll-clean/
├── _config.yml       # 配置文件
├── _includes/        # 包含的文件，如导航栏、页脚等
├── _layouts/         # 页面布局文件
├── _posts/           # 博客文章
├── css/              # 样式文件
├── images/           # 图片资源
├── js/               # JavaScript 文件
├── .gitignore        # Git 忽略文件
├── .gitlab-ci.yml    # GitLab CI 配置文件
├── LICENSE           # 许可证文件
├── README.md         # 项目说明文件
├── about.html        # 关于页面
├── archive.html      # 归档页面
├── feed.xml          # RSS 订阅文件
├── index.html        # 首页
├── links.html        # 链接页面

2. 项目的启动文件介绍

启动文件是 _config.yml，它是 Jekyll 项目的核心配置文件。以下是主要配置项的介绍：

• baseurl: 设置网站的基路径，如果是根域名，则留空。
• title: 网站标题。
• description: 网站描述。
• author: 作者信息。
• markdown: 设置 Markdown 渲染引擎。
• highlight: 设置代码高亮。
• disqus: 设置 Disqus 评论系统短名。
• isso: 设置 Isso 评论系统 URL。
• comments: 是否开启评论功能。
• google_analytics: Google 分析跟踪 ID。

3. 项目的配置文件介绍

配置文件 _config.yml 是 Jekyll 项目的核心，以下是一些重要配置项的详细说明：

• baseurl: 如果你的网站是部署在子目录中，需要设置基路径。例如，如果你的网站 URL 是 http://example.com/blog，则 baseurl 应设置为 /blog。
• title 和 description: 这些是网站的基本信息，将显示在网页的标题和元描述标签中。
• author: 提供作者的名字和联系信息。
• markdown: Jekyll 支持 Kramdown 作为 Markdown 渲染器。你可以在这里配置不同的渲染选项。
• highlight: 代码高亮设置，可以指定语言和样式。
• disqus 和 isso: 如果启用评论功能，需要配置这两项之一。Disqus 是一个第三方评论系统，而 Isso 是一个开源的自托管评论系统。
• comments: 设置为 true 以启用评论功能。
• google_analytics: 如果使用 Google 分析跟踪网站访问情况，需要提供跟踪 ID。

通过修改 _config.yml 文件，你可以自定义 Jekyll-Clean 主题，以适应你的需求。