Jekyll Now 开源项目教程

Jekyll Now 开源项目教程

jalammar.github.io Build a Jekyll blog in minutes, without touching the command line. 项目地址: https://gitcode.com/gh_mirrors/ja/jalammar.github.io

1. 项目的目录结构及介绍

Jekyll Now 是一个基于 Jekyll 的静态博客生成器，它可以帮助用户快速搭建一个响应式的博客网站。以下是项目的目录结构及其介绍：

.
├── _includes/            # 包含可以复用的文件，如页脚、头部等
├── _layouts/             # 包含布局文件，定义了页面结构
├── _posts/               # 存放博客文章的文件夹，文件按照 year-month-day-标题 格式命名
├── _sass/                # 存放 Sass 文件，用于生成 CSS
├── assets/               # 存放静态资源，如图片、CSS、JavaScript 等
├── bower_components/     # 通过 Bower 管理的前端依赖库
├── dist/                 # 打包生成的静态文件存放目录
├── css/                  # 存放编译后的 CSS 文件
├── data/                 # 存放数据文件，如 JSON 或 YAML
├── fonts/                # 存放字体文件
├── images/               # 存放图片文件
├── js/                   # 存放 JavaScript 文件
├── notebookes/           # 存放笔记本或实验性质的代码和文档
├── notebooks/            # 存放笔记本或实验性质的代码和文档
├── tests/                # 存放测试相关的代码和文件
├── .gitignore            # 指定 Git 忽略的文件和目录
├── 404.md                # 自定义的 404 页面
├── CNAME                 # 域名设置文件，用于自定义域名
├── LICENSE               # 项目许可证文件
├── README.md             # 项目说明文件
├── _config.yml           # Jekyll 配置文件
├── about.md              # 关于页面
└── index.html            # 网站的首页

2. 项目的启动文件介绍

在 Jekyll Now 项目中，并没有一个传统意义上的“启动文件”。项目的运行依赖于 Jekyll 引擎，通常通过以下命令在本地启动：

jekyll serve

执行该命令后，Jekyll 会将 _posts/ 目录下的 Markdown 文件转换为 HTML 页面，并通过内置的服务器在本地预览网站。

3. 项目的配置文件介绍

项目的配置主要通过 _config.yml 文件进行。以下是该文件的一些基本配置项：

# 基本信息配置
title: "你的博客标题"
description: "你的博客描述"
author: "你的名字"
repo: "你的 GitHub 仓库地址"

# 网站配置
url: "http://yourgithubusername.github.io" # 网站网址
baseurl: "" # 如果你的网站不是放在根目录，则需要设置这个相对路径
port: 4000 # 本地预览的端口
host: 0.0.0.0 # 本地预览的服务器地址

# Markdown 配置
markdown: kramdown
highlight: pygments # 代码高亮设置

# 插件配置
plugins:
  - jekyll-paginate
  - jekyll-gist
  - jekyll-bootstrapped

# 分页配置
paginate: 5 # 每页显示的文章数量
paginate_path: "page:num"

# 其他配置...

通过修改 _config.yml 文件，你可以定制博客的标题、描述、作者、网站网址等基本信息，以及其他高级设置，如分页、Markdown 渲染引擎、代码高亮等。

jalammar.github.io Build a Jekyll blog in minutes, without touching the command line. 项目地址: https://gitcode.com/gh_mirrors/ja/jalammar.github.io