Jekyll 中文网项目教程

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