当前位置: 首页 > 文档资料 > Grav 入门教程 >

发展(Development)

优质
小牛编辑
133浏览
2023-12-01

您可以使用不同类型的Development来构建Grav,例如Grav CoreGrav PluginsGrav SkeletonGrav Themes

Grav核心

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

Grav插件

Plugin是一款提供增强功能的软件,最初并未由Grav的核心功能完成。 Grav存储库上有许多插件可以显示网站上的功能。

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

  • Grav本身就是super-lean ,只为您的网站添加了所需的插件。

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

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

格拉夫骷髅

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

格拉夫主题

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

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

主题/插件发布流程

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

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

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

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

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

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

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

ChangeLog格式

changelog format使用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开发