Grav - 开发



您可以使用不同类型的开发来构建 Grav,例如Grav 核心Grav 插件Grav 骨架Grav 主题

Grav 核心

Grav 是一个现代化的 CMS,其中内容编写简单,页面构建更友好、更直观。Grav 核心特别讲述了控制 Grav 所有内容的系统文件夹,它代表了 Grav 工作流程和生命周期的特性。它主要关注以良好方式编写的页面。它专注于您的内容,并将您的内容转换为可导航的网站。

Grav 插件

插件是一段软件,它提供了 Grav 核心功能最初未完成的增强功能。Grav 代码库中提供了许多插件,这些插件展示了网站上的功能。

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

  • Grav 本身是极其精简的,只为您的网站添加必要的插件。

  • 无需等待添加您想要的功能。要实现此目的,只需创建一个插件来扩展 Grav。

  • 插件非常灵活且功能强大,可以显示站点地图、博客存档、搜索引擎,提供面包屑导航等。

Grav 骨架

Grav 骨架描述了一个示例网站,其中包含 Grav 核心、插件、页面、主题等所有内容。Grav 最初的想法是让网站构建非常容易。开发网站所需的一切都放在用户文件夹中。Grav 的骨架附带各种依赖项,例如插件、主题等,并存储在一个可以解压缩的包中。

Grav 主题

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

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

主题/插件发布流程

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

  • 这是一个开源项目,由MIT许可。

  • 它包含README.md文件,该文件指定项目的安装过程和配置。

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

  • 包含CHANGELOG.md文件,其中包含主题或插件的版本,并在每次更改文件时显示信息。

  • 创建发行版是在GitHub上放置已完成的主题或插件的更好方法。如果没有发行版,您将找不到您的插件或主题。

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

变更日志格式

变更日志格式使用 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是您将创建测试站点的地址。

Grav Development
广告