Grav - Development

您可以使用不同类型的开发构建Grav,例如 Grav Core Grav插件 Grav Skeleton Grav主题.

Grav Core

Grav是一个现代化的CMS,其中写作内容简单,构建页面是更友好和直观. Grav核心专门讨论了控制Grav一切的系统文件夹,并代表了Grav工作流程和生命周期的质量.它主要关注可以良好编写的页面.它专注于您的内容,并将您的内容转换为可导航的网站.

Grav插件

插件是一个软件它提供了增强的功能,这些功能最初并非由Grav的核心功能完成. Grav存储库中有许多插件可以显示网站上的功能.

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

  • Grav本身是超级精简,它只为您的网站添加了所需的插件.

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

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

Grav Skeletons

Grav骨架描述了一个样本包含Grav Core,插件,页面,主题的网站. Grav背后的最初想法是非常容易地构建网站.开发网站所需的全部内容都放在用户文件夹中. Grav的骨架带有各种依赖项,如插件,主题等,并存储在一个可以解压缩的包中.

Grav主题

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

已安装的主题需要相应的 twig templates 为您的网页.主题是主题和内容的组合,等同于整个网站设计.您可以根据您的设计创建自己的树枝模板引擎.

主题/插件发布流程

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

  • 这是一个开源,由麻省理工学院授权.

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

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

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

  • 创建版本是将完成的主题或插件放在 GitHub 上的更好方法.如果没有发布,那么您将找不到您的插件或主题.

  • 添加有关插件或主题的详细信息并进行测试以确保其工作功能.

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包含依赖项,例如错误插件,问题插件和反物质主题.

您可以设置使用 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