Grav - 开发

您可以使用不同类型的开发构建 Grav，例如Grav Core、Grav 插件、Grav Skeleton 和 Grav 主题。

Grav Core

Grav 是一个现代 CMS，其中编写内容很简单，构建页面更加友好和直观。Grav core 特别讨论了系统文件夹，它控制有关 Grav 的一切，并代表了 Grav 工作流和生命周期的质量。它主要关注可以以良好方式编写的页面。它专注于您的内容并将您的内容转变为可导航的网站。

Grav 插件

插件 是一种提供增强功能的软件，该功能最初并非由 Grav 的核心功能完成。 Grav 存储库中有许多插件可用，它们显示了站点上的功能。

考虑以下与 Grav 插件相关的要点 −

• Grav 本身超级精简，它只为您的网站添加所需的插件。

• 无需等待添加您想要的额外功能。要实现这一点，只需创建一个插件来扩展 Grav。

• 插件非常灵活和强大，可以显示站点地图、博客档案、搜索引擎、提供面包屑等。

Grav Skeletons

Grav Skeleton 描述了一个示例站点，其中包含 Grav Core、插件、页面、主题。Grav 的最初想法是轻松构建站点。开发网站所需的所有内容都放在 user 文件夹中。Grav 的骨架带有各种依赖项，例如插件、主题等，并存储在可以解压的包中。

Grav 主题

Grav 支持不同类型的 主题，这些主题是 Grav 网站的组成部分。当您在系统上安装 Grav 时，它会附带 Antimatter 主题。大多数主题都带有骨架包或示例页面。您可以在 user/pages 文件夹下看到示例页面，它提供与骨架包类似的体验。

已安装的主题需要适合您的页面的 twig 模板。主题是主题和内容的组合，相当于整个网站设计。您可以根据您的设计创建自己的 twig 模板引擎。

主题/插件发布流程

您可以注意到在 Grav 存储库中添加的创建主题或插件的一些要点。

• 它是一个由 MIT 许可的开源。

• 它具有 README.md 文件，该文件指定了项目的安装过程和配置。

• 它包含 blueprints.yaml 文件，该文件包含有关资源的信息，可以在每个插件和主题的根目录中找到。

• 包含 CHANGELOG.md 文件，该文件包含主题或插件的版本，并在对文件进行更改时显示信息。

• 创建发布版是放置完成的主题或插件在 GitHub 上。如果没有发布，那么您将找不到您的插件或主题。

• 添加有关您的插件或主题的详细信息，并进行测试以确保其正常工作。

ChangeLog 格式

changelog 格式以 Markdown 语法编写，将内容和视觉显示分开。它使用简单的 CSS，以以下格式显示。

# vX.Y.Z
## 01/01/2015
1. [](#new)
   * New features added
   * Another new feature
2. [](#improved)
   * Improvement made
   * Another improvement
3. [](#bugfix)
   * Bugfix implemented
   * Another bugfix
...repeat...

GitHub 设置

GitHub 是一个最大的开放社区，它与用户共享您的项目、获得反馈并为托管在 GitHub 上的存储库做出贡献。

将外部存储库的 URL 克隆到本地系统上的单个项目文件夹中。您可以按照以下步骤将外部 Git 存储库克隆到新存储库。

打开命令行并创建名为 "my_project" 的文件夹。

$ mkdir my_project
$ cd my_project
$ mkdir Grav
$ cd Grav
$ git clone https://github.com/getGrav/Grav.git
$ git clone https://github.com/Grav_project/Grav-plugin-error.git
$ git clone https://github.com/ Grav_project /Grav-plugin-problems.git
$ git clone https://github.com/ Grav_project /Grav-theme-antimatter.git

此处 Grav_project 是一个存储库，您将从中获得与此存储库相关的所有文件和文件夹，这些文件和文件夹将保存在 /my_project/Grav 文件夹中。Grav 包含依赖项，例如 error 插件、problems 插件和 Antimatter 主题。

您可以使用 bin/Grav new-project 命令为 Grav 设置测试站点。我们需要从 Web 根目录开发克隆的代码。因此，我们必须使用 -s 标志将相关部分符号链接到 bin/Grav new-project 命令。

在名为 .Grav/ 的新文件夹中创建一个配置文件，以使用该命令查找存储库，您需要在根目录下创建该文件。

$ cd
$ mkdir .Grav
$ vi .Grav/config

导航到您的 Grav 文件夹并使用 -s 标志设置符号链接的站点。

$ cd ~/Projects/Grav/Grav
$ bin/Grav my-project -s ~/www/Grav

这里，www 是根文件夹，Grav 是您要去的位置创建测试站点。