Jekyll-Bootstrap 使用教程

Jekyll-Bootstrap 使用教程

jekyll-bootstrap The quickest way to start and publish your Jekyll powered blog. 100% compatible with GitHub pages. 项目地址: https://gitcode.com/gh_mirrors/je/jekyll-bootstrap

1. 项目目录结构及介绍

Jekyll-Bootstrap 是一个快速搭建基于 Jekyll 博客的框架，它完全兼容 GitHub Pages。以下是典型的项目目录结构及其简介：

.
├── _drafts                      # 草稿文件夹，存放未发布的文章草稿
├── _includes                    # 包含文件，例如页眉、页脚或常见的HTML片段
├── _layouts                     # 布局模板，定义页面的整体结构和样式
├── _plugins                     # 自定义插件，用于扩展 Jekyll 的功能
├── _posts                       # 文章目录，存放按日期命名的Markdown格式的文章
├── _site                        # 生成的静态网站存放目录，由Jekyll自动生成
├── assets/themes               # 主题相关的资产，如CSS和JavaScript文件
├── atom.xml                     # 订阅源文件，供RSS阅读器订阅
├── categories.html             # 分类页面的模板
├── changelog.md                # 项目更新日志
├── feeds                        # RSS和其他订阅源文件
│   └── atom.xml
├── gemfile                      # Ruby项目的依赖管理文件
├── index.md                     # 主页内容
├── license.md                   # 开源许可证文件
├── _config.yml                 # 系统配置文件
├── 404.html                     # 404错误页面
└── README.md                    # 项目说明文档

2. 项目的启动文件介绍

项目的核心启动不涉及单个“启动文件”，而是在初始化 Jekyll 时通过命令行操作完成。然而，从开发流程的角度来看，_config.yml 和 index.md 可以被视为关键文件。

• _config.yml：这是Jekyll的配置中心，包含了站点的元数据、博客设置、导航等信息。修改此文件可以定制你的博客，比如更改站点标题、作者信息、启用或禁用某些特性。
• index.md：主页内容文件，通常位于根目录下，用Markdown编写的，决定了你的博客首页显示什么内容。编辑这个文件可以更新你的博客首页。

3. 项目的配置文件介绍

_config.yml 配置文件详解

_config.yml 是 Jekyll 项目中最重要的配置文件，下面是一些基本配置项的例子及其解释：

# 基本站点配置
title: 我的博客
subtitle: 分享技术点滴
author: 你的名字
email: you@example.com
description: 这里简短描述你的博客主题。

# URL设置
url: "http://your-blog-url.com"    # 你的博客URL
base_url: ""                      # 如果博客不是在顶级域名下，这里填写子路径

# Markdown解析器和语法高亮设置
markdown: kramdown
highlighter: rouge

# 页面导航
navigation:
  - title: 关于
    url: /about/
    
# 其他自定义设置可以根据需要添加

在这个文件中，你可以定义站点的元数据、导航菜单、发布选项等等。Jekyll会读取这些设置来个性化你的博客构建过程。记得每次修改配置后，都要重新生成站点以使变动生效。

通过遵循上述指导，你将能够理解并开始使用 Jekyll-Bootstrap 来构建和自定义自己的博客了。记得利用Jekyll的强大和灵活性，根据个人需求调整目录结构和配置细节。

jekyll-bootstrap The quickest way to start and publish your Jekyll powered blog. 100% compatible with GitHub pages. 项目地址: https://gitcode.com/gh_mirrors/je/jekyll-bootstrap