Gojekyll 项目使用教程

Gojekyll 项目使用教程

gojekyllA fast Go implementation of the Jekyll blogging engine项目地址:https://gitcode.com/gh_mirrors/go/gojekyll

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

Gojekyll 是一个用 Go 语言实现的 Jekyll 静态站点生成器的部分兼容克隆。以下是其典型的目录结构：

gojekyll/
├── _config.yml
├── _drafts/
├── _includes/
├── _layouts/
│   ├── default.html
│   ├── post.html
├── _posts/
│   ├── 2023-01-01-example-post.md
├── _site/
├── .gitignore
├── Gemfile
├── index.html

目录介绍：

• _config.yml: 项目的配置文件。
• _drafts/: 存放未发布的草稿文章。
• _includes/: 存放可重用的模板片段。
• _layouts/: 存放页面布局模板。
• _posts/: 存放已发布的文章。
• _site/: 生成的静态站点输出目录。
• Gemfile: Ruby 依赖管理文件。
• index.html: 站点的主页。

2. 项目的启动文件介绍

Gojekyll 的启动文件主要是 gojekyll 可执行文件。你可以通过以下命令启动项目：

gojekyll serve

这条命令会启动一个本地服务器，并在 http://localhost:4000 上提供服务。当文件发生变化时，服务器会自动重新加载。

3. 项目的配置文件介绍

_config.yml 是 Gojekyll 的主要配置文件。以下是一个示例配置：

title: 我的博客
email: example@example.com
description: 这是一个用 Gojekyll 生成的博客。
baseurl: "" # 站点子路径，例如："/blog"
url: "http://example.com" # 站点的完整 URL
markdown: kramdown
theme: minima

配置项介绍：

• title: 站点的标题。
• email: 联系邮箱。
• description: 站点的描述。
• baseurl: 站点的子路径。
• url: 站点的完整 URL。
• markdown: 使用的 Markdown 解析器。
• theme: 使用的主题。

通过这些配置项，你可以自定义站点的基本信息和行为。

gojekyllA fast Go implementation of the Jekyll blogging engine项目地址:https://gitcode.com/gh_mirrors/go/gojekyll