Treat Jekyll 模板使用教程

37 0 0

Treat Jekyll 模板使用教程

treat-jekyll-template:cake: Food/baking blog template for Jekyll项目地址:https://gitcode.com/gh_mirrors/tr/treat-jekyll-template

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

Treat Jekyll 模板是一个专为食品和烘焙博客设计的模板。以下是其基本的目录结构和各部分的简要介绍：

treat-jekyll-template/ ├── _config.yml ├── _data/ │ ├── footer.yml │ ├── navigation.yml │ └── sidebar.yml ├── _includes/ │ ├── disqus.html │ ├── footer.html │ ├── head.html │ ├── header.html │ ├── pagination.html │ └── sidebar.html ├── _layouts/ │ ├── default.html │ ├── page.html │ └── post.html ├── _posts/ │ └── YYYY-MM-DD-title.md ├── _sass/ │ └── main.scss ├── about/ │ └── index.html ├── assets/ │ ├── css/ │ ├── images/ │ └── js/ ├── categories/ │ └── index.html ├── feed.xml ├── index.html └── recipes/ └── index.html

_config.yml: 项目的配置文件。
_data/: 存储数据文件，如页脚、导航和侧边栏的配置。
_includes/: 包含可重用的HTML片段。
_layouts/: 定义页面布局的模板。
_posts/: 存储博客文章的目录。
_sass/: 存储SCSS文件，用于生成CSS。
about/: 关于页面的内容。
assets/: 存储CSS、图片和JavaScript文件。
categories/: 分类页面的内容。
feed.xml: RSS订阅文件。
index.html: 主页内容。
recipes/: 食谱页面的内容。

2. 项目的启动文件介绍

项目的启动文件是 index.html，这是网站的主页。它使用 _layouts/default.html 布局，并包含导航栏、侧边栏和主要内容区域。

3. 项目的配置文件介绍

项目的配置文件是 _config.yml，它包含了网站的基本配置信息，如站点名称、作者信息、Google Analytics 和 Disqus 的配置等。以下是一些关键配置项的示例：

title: Treat email: your-email@example.com description: >- # this means to ignore newlines until "baseurl:" Write an awesome description for your new site here. You can edit this line in _config.yml. It will appear in your document head meta (for Google search results) and in your feed.xml site description. baseurl: "" # the subpath of your site, e.g. /blog url: "http://example.com" # the base hostname & protocol for your site, e.g. http://example.com twitter_username: jekyllrb github_username: jekyll # Build settings markdown: kramdown theme: minima plugins: - jekyll-feed # Google Analytics google_analytics: UA-XXXXXXXX-X # Disqus disqus: shortname: your-disqus-shortname

title: 网站的标题。
email: 联系邮箱。
description: 网站的描述。
baseurl: 网站的子路径。
url: 网站的基本URL。
twitter_username: Twitter用户名。
github_username: GitHub用户名。
markdown: 使用的Markdown处理器。
theme: 使用的主题。
plugins: 使用的插件。
google_analytics: Google Analytics跟踪ID。
disqus: Disqus短名称。