Kiko Now 项目教程
1. 项目的目录结构及介绍
Kiko Now 是一个基于 Jekyll 的静态博客主题,其目录结构如下:
kiko-now/
├── _includes/
├── _layouts/
├── _posts/
├── _sass/
├── archive/
├── images/
├── tags/
├── .gitignore
├── 404.md
├── CNAME
├── Gemfile
├── Gemfile.lock
├── LICENSE
├── README.ko.md
├── README.md
├── _config.yml
├── about.md
├── index.html
└── style.scss
目录结构介绍:
- _includes/:包含 Jekyll 模板中使用的部分文件。
- _layouts/:包含 Jekyll 模板中使用的布局文件。
- _posts/:存放博客文章的目录。
- _sass/:包含 SASS 样式文件。
- archive/:存放归档页面的目录。
- images/:存放图片资源的目录。
- tags/:存放标签页面的目录。
- .gitignore:Git 忽略文件配置。
- 404.md:404 错误页面文件。
- CNAME:自定义域名配置文件。
- Gemfile:Ruby 依赖管理文件。
- Gemfile.lock:Gemfile 的锁定文件。
- LICENSE:项目许可证文件。
- README.ko.md:韩文版的 README 文件。
- README.md:英文版的 README 文件。
- _config.yml:Jekyll 配置文件。
- about.md:关于页面的 Markdown 文件。
- index.html:首页的 HTML 文件。
- style.scss:主样式文件。
2. 项目的启动文件介绍
Kiko Now 项目的启动文件是 index.html
。这个文件是博客的首页,包含了博客的基本结构和内容。启动项目时,Jekyll 会根据这个文件生成静态网站的首页。
3. 项目的配置文件介绍
Kiko Now 项目的主要配置文件是 _config.yml
。这个文件包含了 Jekyll 博客的所有配置选项,例如网站的标题、描述、作者信息、导航菜单、插件配置等。
_config.yml
配置文件示例:
title: Kiko Now
description: A Jekyll theme based on Jekyll Now
author: aweekj
email: your-email@example.com
baseurl: ""
url: "https://aweekj.github.io/kiko-now"
# 导航菜单
navigation:
- title: Home
url: /
- title: About
url: /about/
- title: Archive
url: /archive/
- title: Tags
url: /tags/
# 插件配置
plugins:
- jekyll-paginate
- jekyll-sitemap
# 其他配置
markdown: kramdown
kramdown:
input: GFM
配置文件介绍:
- title:网站的标题。
- description:网站的描述。
- author:网站的作者。
- email:作者的邮箱。
- baseurl:网站的基本 URL。
- url:网站的完整 URL。
- navigation:导航菜单配置。
- plugins:Jekyll 插件配置。
- markdown:Markdown 解析器配置。
- kramdown:kramdown 解析器的配置。
通过修改 _config.yml
文件,可以自定义博客的各种设置,以满足个人需求。