Parchment 项目教程
1. 项目的目录结构及介绍
Parchment 项目的目录结构如下:
parchment/
├── _drafts/
├── _includes/
├── _layouts/
├── _posts/
├── assets/
│ └── css/
├── .gitignore
├── 404.html
├── Gemfile
├── Gemfile.lock
├── LICENSE
├── README.md
├── _config.yml
├── about.md
├── index.html
└── tags.html
目录结构介绍
- _drafts/: 存放草稿文件的目录。
- _includes/: 存放可重用的模板片段的目录。
- _layouts/: 存放页面布局模板的目录。
- _posts/: 存放博客文章的目录,文章需遵循
yyyy-mm-dd-your-title-here.md
的命名格式。 - assets/: 存放静态资源的目录,如 CSS 文件。
- .gitignore: Git 忽略文件配置。
- 404.html: 404 错误页面文件。
- Gemfile: 项目依赖的 Ruby 包管理文件。
- Gemfile.lock: 依赖包的锁定文件。
- LICENSE: 项目许可证文件。
- README.md: 项目说明文件。
- _config.yml: 项目的配置文件。
- about.md: 关于页面的 Markdown 文件。
- index.html: 首页文件。
- tags.html: 标签页文件。
2. 项目的启动文件介绍
Parchment 项目的启动文件主要是 index.html
和 _config.yml
。
index.html
index.html
是项目的入口文件,包含了页面的基本结构和内容。它通常会引用 _layouts
目录中的布局模板,并通过 _config.yml
中的配置来动态生成内容。
_config.yml
_config.yml
是项目的配置文件,包含了项目的全局配置信息,如站点标题、描述、URL 等。它还定义了项目的插件、变量和其他设置。
3. 项目的配置文件介绍
Parchment 项目的主要配置文件是 _config.yml
。以下是该文件的一些关键配置项:
title: "Parchment"
description: "A clean, single column blog template built for Jekyll"
url: "https://rahulbothra.com/parchment"
# 其他配置项
plugins:
- jekyll-feed
- jekyll-sitemap
# 自定义变量
author: "Rahul Bothra"
配置项介绍
- title: 站点的标题。
- description: 站点的描述。
- url: 站点的 URL。
- plugins: 使用的 Jekyll 插件列表。
- author: 自定义变量,用于定义站点的作者。
通过修改 _config.yml
文件,可以自定义项目的各种设置,如站点标题、描述、URL 等。