Kirby3 静态站点生成器使用教程

Kirby3 静态站点生成器使用教程

kirby3-static-site-generatorStatic site generator plugin for Kirby 3+. With this plugin you can create a directory with assets, media and static html files generated from your pages. The result is an even faster site with less potential vulnerabilities.项目地址:https://gitcode.com/gh_mirrors/ki/kirby3-static-site-generator

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：排除某些路由不生成静态页面。

kirby3-static-site-generatorStatic site generator plugin for Kirby 3+. With this plugin you can create a directory with assets, media and static html files generated from your pages. The result is an even faster site with less potential vulnerabilities.项目地址:https://gitcode.com/gh_mirrors/ki/kirby3-static-site-generator