Kirby3 静态站点生成器使用教程
1. 项目的目录结构及介绍
kirby3-static-site-generator/
├── composer.json
├── composer.lock
├── index.php
├── kirby
├── site
│ ├── blueprints
│ ├── config
│ ├── controllers
│ ├── models
│ ├── snippets
│ ├── templates
│ └── plugins
│ └── static-generator
└── static
composer.json
和composer.lock
:Composer 依赖管理文件。index.php
:项目的入口文件。kirby
:Kirby CMS 的核心文件夹。site
:站点配置和内容文件夹。blueprints
:页面蓝图定义。config
:配置文件。controllers
:控制器文件。models
:模型文件。snippets
:可重用的代码片段。templates
:页面模板。plugins
:插件文件夹,包含static-generator
插件。
static
:生成的静态站点文件夹。
2. 项目的启动文件介绍
index.php
是项目的入口文件,负责初始化 Kirby CMS 并加载必要的配置和插件。
<?php
require __DIR__ . '/kirby/bootstrap.php';
echo (new Kirby)->render();
3. 项目的配置文件介绍
在 site/config
文件夹中,通常会有一个 config.php
文件,用于配置 Kirby CMS 和插件。
<?php
return [
'debug' => true,
'routes' => [
[
'pattern' => 'generate-static-site',
'action' => function () {
$generator = new \Bnomei\StaticSiteGenerator();
$generator->generate();
return 'Static site generated.';
}
]
],
'bnomei.statichtml.output' => 'static',
'bnomei.statichtml.exclude' => [
'pattern' => '(:all)/generate-static-site'
]
];
debug
:开启调试模式。routes
:定义路由,例如生成静态站点的路由。bnomei.statichtml.output
:指定生成的静态站点输出文件夹。bnomei.statichtml.exclude
:排除某些路由不生成静态页面。