Apache APISIX 网站项目教程

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

Apache APISIX 网站项目的目录结构如下：

apisix-website/
├── README.md
├── docs
│   ├── en
│   │   ├── index.md
│   │   └── ...
│   └── zh
│       ├── index.md
│       └── ...
├── site
│   ├── assets
│   │   ├── css
│   │   ├── img
│   │   └── js
│   ├── _includes
│   ├── _layouts
│   ├── _posts
│   └── index.html
├── .gitignore
├── .github
│   └── workflows
├── _config.yml
└── Gemfile

目录介绍

• README.md: 项目介绍文件。
• docs: 存放文档的目录，包含英文 (en) 和中文 (zh) 两个子目录。
• site: 网站的静态资源和页面布局文件。
  • assets: 存放 CSS、图片和 JavaScript 文件。
  • _includes: 存放可重用的页面组件。
  • _layouts: 存放页面布局模板。
  • _posts: 存放博客文章。
  • index.html: 网站首页。
• .gitignore: Git 忽略文件配置。
• .github/workflows: GitHub Actions 工作流配置。
• _config.yml: Jekyll 配置文件。
• Gemfile: Ruby 依赖管理文件。

2. 项目的启动文件介绍

Apache APISIX 网站项目使用 Jekyll 作为静态网站生成器。启动文件主要是 _config.yml 和 Gemfile。

_config.yml

这是 Jekyll 的主要配置文件，包含网站的基本配置信息，如网站标题、描述、URL 等。

Gemfile

这是 Ruby 的依赖管理文件，定义了项目所需的 Ruby gems。

3. 项目的配置文件介绍

_config.yml

title: Apache APISIX
description: Apache APISIX 是一个动态、实时、高性能的 API 网关。
url: "https://apisix.apache.org"
baseurl: ""

• title: 网站标题。
• description: 网站描述。
• url: 网站的根 URL。
• baseurl: 网站的基路径（通常为空）。

Gemfile

source "https://rubygems.org"

gem "jekyll"
gem "minima"

• source: Ruby gems 的来源。
• gem "jekyll": Jekyll 静态网站生成器。
• gem "minima": Jekyll 的默认主题。

通过以上配置文件，可以启动和配置 Apache APISIX 网站项目。