Stacey 3.0.0 技术文档

概述

Stacey 是一个无数据库的动态网站生成器，它通过读取 .yml 文件、图片文件以及目录结构来生成网站。通过查看 /content 和 /templates 文件夹，你可以大致了解其工作原理。

安装指南

1. 安装方式

将项目文件复制到服务器上，并执行以下命令：

chmod 777 app/_cache

2. 启用干净URL

如果你希望使用干净的URL，可以执行以下命令：

mv htaccess .htaccess

项目使用说明

1. 内容结构

Stacey 通过 /content 文件夹中的 .yml 文件和图片文件来生成网站内容。目录结构决定了网站的层次结构。

2. 模板使用

Stacey 使用 Twig 模板语言 来渲染页面。你可以在 /templates 文件夹中找到默认的模板文件。

3. 额外模板

除了默认模板外，你还可以使用以下两套额外模板：

• stacey-template2
• stacey-template3

项目API使用文档

1. Twig 模板语言

Stacey 使用 Twig 模板语言来生成动态内容。Twig 提供了丰富的语法和功能，允许你创建复杂的页面布局和动态内容。

2. 缓存机制

Stacey 使用 /app/_cache 文件夹来存储生成的页面缓存，以提高网站的加载速度。

项目安装方式

1. 服务器环境要求

• PHP 5.3 或更高版本
• 支持 .htaccess 文件的服务器（如 Apache）

2. 安装步骤

1. 将项目文件上传到服务器。
2. 设置缓存目录权限：

   chmod 777 app/_cache
   

3. 如果需要使用干净URL，重命名 .htaccess 文件：

   mv htaccess .htaccess
   

版权与许可

• 项目版权归 Anthony Kolber 所有，详细信息请查看 LICENSE 文件。
• 项目中使用的 PHP Markdown Extra 版权归 Michel Fortin 所有，详细信息请查看 /app/parsers/markdown-parser.inc.php。
• 项目中使用的 jsmin.php 版权归 Ryan Grove 所有，详细信息请查看 app/parsers/json-minifier.inc.php。