Jekyll 中文网项目教程
jekyllcnJekyll 的中文翻译网站项目地址:https://gitcode.com/gh_mirrors/je/jekyllcn
1. 项目的目录结构及介绍
Jekyll 项目的目录结构通常包含以下几个主要部分:
jekyllcn/
├── _config.yml
├── _data
│ └── members.yml
├── _drafts
│ ├── begin-with-the-crazy-ideas.md
│ └── on-simplicity-in-technology.md
├── _includes
│ ├── footer.html
│ └── header.html
├── _layouts
│ ├── default.html
│ └── post.html
├── _posts
│ ├── 2007-10-29-why-every-developer-should-have-a-blog.md
│ └── 2009-04-26-barcamp-boston-4-roundup.md
├── _sass
│ ├── _base.scss
│ └── _layout.scss
├── _site
├── .jekyll-metadata
└── index.html
目录结构介绍
- _config.yml: 项目的配置文件。
- _data: 存储数据文件,如
members.yml
。 - _drafts: 存放未发布的草稿文章。
- _includes: 可重用的模板片段,如页眉和页脚。
- _layouts: 文章和页面的模板布局。
- _posts: 已发布的文章,文件名格式为
YYYY-MM-DD-title.md
。 - _sass: SASS 样式文件。
- _site: Jekyll 生成的静态网站输出目录。
- .jekyll-metadata: Jekyll 用于跟踪未修改文件的元数据。
- index.html: 网站的主页。
2. 项目的启动文件介绍
Jekyll 项目的启动文件主要是 index.html
和 _config.yml
。
index.html
index.html
是网站的主页,通常包含网站的基本结构和内容。以下是一个简单的示例:
---
layout: default
title: 首页
---
<div class="home">
<h1 class="page-heading">文章</h1>
{{ content }}
<ul class="post-list">
{% for post in site.posts %}
<li>
<span class="post-meta">{{ post.date | date: "%b %-d, %Y" }}</span>
<h2>
<a class="post-link" href="{{ post.url | relative_url }}">{{ post.title | escape }}</a>
</h2>
</li>
{% endfor %}
</ul>
</div>
_config.yml
_config.yml
是 Jekyll 的主要配置文件,用于设置网站的各种参数。以下是一个简单的示例:
title: 我的博客
email: your-email@example.com
description: >- # 这是对网站的描述
欢迎来到我的博客,这里记录了我的技术探索和日常思考。
baseurl: "" # 网站的子路径,如 "/blog"
url: "http://example.com" # 网站的根 URL
twitter_username: jekyllrb
github_username: jekyll
# 构建设置
markdown: kramdown
theme: minima
plugins:
- jekyll-feed
3. 项目的配置文件介绍
_config.yml
是 Jekyll 项目的核心配置文件,包含了网站的各种设置。以下是一些常见的配置项:
基本设置
title: 我的博客
email: your-email@example.com
description: >-
欢迎来到我的博客,这里记录了我的技术探索和日常思考。
baseurl: "" # 网站的子路径,如 "/blog"
url: "http://example.com" # 网站的根 URL
社交账号
twitter_username: jekyllrb
github_username: jekyll
构建设置
markdown: kramdown
theme: minima
plugins:
- jekyll-feed
其他设置
# 自定义变量
author:
name: "John Doe"
avatar: "/path/to/avatar.jpg"
jekyllcnJekyll 的中文翻译网站项目地址:https://gitcode.com/gh_mirrors/je/jekyllcn