Grav - 配置系统

---

---

本章我们将学习 Grav 管理面板中的配置系统。您可以通过配置页面直接配置站点系统的设置。此外，您还将看到服务器属性的简要说明，包括 PHP、服务器环境以及其他几个调节站点性能的组件。

“系统”选项卡允许您修改/user/config/system.yaml文件中的设置。这会影响 Grav 操作的许多主要系统相关功能。这些设置可以细分为不同的部分，向您展示 Grav 性能的不同方面。

以下是“系统”选项卡中显示的配置部分的详细列表：

内容

在本节中，您可以修复站点的内容处理的基本属性，如下所示。

• 主页 - 指定要为您的站点显示的主页。

• 默认主题 - 显示站点的默认主题。

• 处理方式 - 控制页面的处理方式。可以按页面设置，而不是全局设置。

• 时区 - 设置服务器的默认时区。

• 简短日期格式 - 显示简短日期格式。

• 长日期格式 - 显示长日期格式。

• 默认排序 - 使用此顺序在列表中显示页面。

• 默认排序方向 - 指定列表中页面的方向。

• 默认页面数 - 定义列表中的最大默认页面数。

• 基于日期的发布 - 它根据日期自动发布文章。

• 事件 - 指定启用或禁用事件。禁用会损坏插件。

• 重定向默认路由 - 定义默认路由并自动重定向到页面。

语言

您可以在此区域设置多语言功能，如下所示。

• 支持的语言 - 指定用逗号分隔的两位字母语言代码列表，例如：en, fr, de。

• 启用翻译 - 在 Grav、插件和扩展中启用翻译。

• 翻译回退 - 如果不存在活动语言，则指定替代支持的翻译。

• 区域中的活动语言 - 您可以将活动语言存储在此区域。

• 主页重定向包含语言 - 根据需要在主页重定向中包含语言 (/en)。

• 主页重定向包含路由 - 指定重定向管理员主页根目录。

• 从浏览器设置语言 - 从浏览器指定语言。

• 覆盖区域设置 - 指定覆盖区域设置。

HTTP 头

本节用于设置HTTP 头选项。此设置有助于基于浏览器的缓存和优化。

• 过期时间 - 定义过期时间并以秒为单位设置值。

• 上次修改时间 - 设置“上次修改”头，这有助于优化代理和浏览器缓存。

• ETag - 定义e tag 头以识别已修改的页面。

• Vary Accept Encoding - 您应该将 Vary: HTTP 头排列到 Accept。这将使代理上的缓存受益。

Markdown

在本节中，我们将学习 Grav 如何管理Markdown及其功能以启用 Markdown Extra。它帮助用户并构成了 Grav 页面内容的大部分。

• Markdown Extra - 指定对 Markdown Extra 的默认支持。

• 自动换行 - 指定 Markdown 中的换行符。

• 自动 URL 链接 - 指定将 URL 转换为 HTML 超链接。

• 转义标记 - 指定将标记标签转换为 HTML 对象。

缓存

在本节中，您可以配置站点的基本缓存功能。Grav 结合了缓存功能，这有助于为用户构建最快的平面文件 CMS 选项。

• 缓存 - 指定全局打开/关闭以启用/禁用 Grav 缓存。

• 缓存检查方法 - 这定义了文件、文件夹和无的缓存检查方法。

• 缓存驱动程序 - 这指定为用户选择缓存驱动程序。自动检测缓存驱动程序被认为是最好的。

• 缓存前缀 - 这指定 Grav 密钥一部分的标识符。仅在需要时更改它，否则不要更改它。

• 生命周期 - 这以秒为单位定义缓存生命周期，0=无限。

• Gzip 压缩 - 要提高性能，请启用 Grav 页面的 Gzip 压缩。

Twig 模板引擎

在本节中，Grav 突出显示其Twig 模板引擎功能。您可以在此处配置 Twig 缓存、调试和修改跟踪设置。

• Twig 缓存 - 这指定控制 Twig 缓存系统。启用时，它提供最佳性能。

• Twig 调试 - 此选项定义不加载 Twig 调试器扩展。

• 检测更改 - 对 Twig 模板所做的任何更改，这都将自动重新编译 Twig 缓存。

• 自动转义变量 - 所有变量都是自动转义的；这可能会损坏您的网站。

资源

本节用于处理资源，包括 CSS 和 JavaScript 资源，如下所示。

• CSS 管道 - 将多个 CSS 资源集成到单个文件中。

• CSS 压缩 - 在管道过程中压缩 CSS。

• CSS 压缩 Windows 覆盖 - 默认情况下设置为 False，它定义 Windows 平台的压缩覆盖。

• CSS 重写 - 在管道过程中重写 CSS 相对 URL。

• JavaScript 管道 - 将多个 JavaScript 资源集成到单个文件中。

• JavaScript 压缩 - 在管道过程中压缩 JS。

• 启用资源上的时间戳 - 启用资源上的时间戳。

• 集合 - 单独添加资源集合。

错误处理程序

在站点开发期间，本节对于管理 Grav 错误报告非常有用。

• 显示错误 - 显示完整的回溯样式错误页面。

• 记录错误 - 将错误记录到/logs文件夹中。

调试器

这类似于错误处理，调试工具集成在 Grav 中以查找和排除错误。

• 调试器 - 启用调试器及其设置。

• 调试 Twig - 启用 Twig 模板调试器。

• 关闭连接 - 在调用onShutdown()之前，需要关闭连接。

媒体

本节用于管理 Grav 的媒体内容。您可以在此处配置图像质量、文件上传大小以及许多媒体处理选项。

• 默认图像质量 - 在缓存或重新采样图像时使用默认图像质量。

• 缓存所有图像 - 所有图像都通过 Grav 的缓存系统运行，即使它不包含媒体处理。

• 图像调试水印 - 在显示图像叠加层时，您可以指示图像的像素深度，例如：使用视网膜显示。

• 文件上传限制 - 定义以字节为单位的最大上传大小（0 表示无限）。

• 启用媒体上的时间戳 - 根据上次修改日期为每个媒体项添加时间戳。

会话

下面提到的功能可帮助您启用会话支持。

• 启用 - 指定 Grav 中的会话支持。

• 超时 - 指定以秒为单位的会话超时。

• 名称 - 指定会话 cookie 的名称，由标识符开发和应用。

高级

在本节中，您将看到高级系统选项。

• 绝对 URL - 指定base_url的绝对或相对 URL。

• 参数分隔符 - 您可以使用参数分隔符来更改 Windows 上的 Apache。