Frisco Jekyll 模板使用教程
1. 项目的目录结构及介绍
Frisco Jekyll 模板的项目目录结构如下:
frisco-jekyll-template/
├── _config.yml
├── _data
│ └── staff.yml
├── _includes
│ ├── footer.html
│ ├── head.html
│ ├── header.html
│ └── social.html
├── _layouts
│ ├── default.html
│ ├── page.html
│ └── post.html
├── _posts
│ └── 2024-01-01-welcome-to-frisco.md
├── _sass
│ ├── base
│ │ └── _base.scss
│ ├── components
│ │ └── _footer.scss
│ └── main.scss
├── about.md
├── assets
│ ├── css
│ │ └── main.scss
│ ├── images
│ └── js
├── blog.md
├── contact.md
├── index.html
└── thumbnails
└── welcome-to-frisco.jpg
目录结构介绍:
_config.yml
: 项目的配置文件。_data/
: 存放数据文件,如staff.yml
包含团队成员信息。_includes/
: 包含可重用的 HTML 片段,如页眉、页脚等。_layouts/
: 包含页面布局模板。_posts/
: 存放博客文章。_sass/
: 包含 SASS 文件,用于生成 CSS。about.md
,blog.md
,contact.md
: 页面文件。assets/
: 存放静态资源,如 CSS、图片和 JavaScript 文件。index.html
: 项目的主页。thumbnails/
: 存放文章缩略图。
2. 项目的启动文件介绍
项目的启动文件是 index.html
,这是访问网站时默认加载的页面。它包含了页面的基本结构和内容,通过引用 _includes/
目录下的文件来构建页面的各个部分。
3. 项目的配置文件介绍
项目的配置文件是 _config.yml
,它包含了网站的基本配置信息,如网站标题、描述、作者信息等。以下是一些关键配置项的介绍:
title: "Frisco"
description: "App marketing template for Jekyll"
url: "https://example.com"
author: "CloudCannon"
# 其他配置项
google_analytics: "UA-XXXXX-Y"
disqus: "example"
# 路径配置
permalink: /:year/:month/:day/:title/
# 插件配置
plugins:
- jekyll-feed
- jekyll-seo-tag
配置项介绍:
title
: 网站的标题。description
: 网站的描述。url
: 网站的 URL。author
: 网站的作者。google_analytics
: Google Analytics 的跟踪 ID。disqus
: Disqus 评论系统的短名称。permalink
: 文章的永久链接格式。plugins
: 启用的 Jekyll 插件。
通过修改 _config.yml
文件,可以自定义网站的各种设置,以满足不同的需求。