Jekyll Travis 项目使用教程
1. 项目的目录结构及介绍
Jekyll Travis 项目的目录结构通常包含以下几个主要部分:
jekyll-travis/
├── _config.yml
├── _includes/
├── _layouts/
├── _posts/
├── _site/
├── .gitignore
├── .travis.yml
├── about.md
├── index.md
└── Gemfile
- _config.yml: Jekyll 的配置文件,包含网站的全局配置信息。
- _includes/: 存放可重用的代码片段,如头部、尾部等。
- _layouts/: 存放页面布局模板。
- _posts/: 存放博客文章,文件名格式为
YYYY-MM-DD-title.md
。 - _site/: Jekyll 生成的静态网站输出目录。
- .gitignore: 指定 Git 忽略的文件和目录。
- .travis.yml: Travis CI 的配置文件,用于持续集成。
- about.md: 关于页面的 Markdown 文件。
- index.md: 首页的 Markdown 文件。
- Gemfile: 定义项目所需的 Ruby 依赖。
2. 项目的启动文件介绍
Jekyll Travis 项目的启动文件主要是 index.md
和 about.md
。这两个文件分别对应网站的首页和关于页面。
- index.md: 首页内容,通常包含网站的主要介绍和导航链接。
- about.md: 关于页面内容,提供网站或作者的详细信息。
3. 项目的配置文件介绍
Jekyll Travis 项目的主要配置文件是 _config.yml
和 .travis.yml
。
_config.yml
_config.yml
是 Jekyll 的核心配置文件,包含以下关键配置项:
title: 你的网站标题
email: 你的邮箱
description: 网站描述
baseurl: "" # 网站的子路径,如 "/blog"
url: "http://你的域名.com" # 网站的完整 URL
github_username: 你的GitHub用户名
# 其他配置项...
.travis.yml
.travis.yml
是 Travis CI 的配置文件,用于自动化构建和测试 Jekyll 项目。以下是一个基本的配置示例:
language: ruby
rvm:
- 2.7.0
install:
- bundle install
script:
- bundle exec jekyll build
- bundle exec htmlproofer ./_site
- language: 指定项目使用的编程语言。
- rvm: 指定使用的 Ruby 版本。
- install: 安装项目依赖。
- script: 执行构建和测试命令。
通过以上配置,Travis CI 将自动构建并验证 Jekyll 生成的静态网站。