准备好开始使用 Gantry 5 了吗?那太棒了!我们随时为您提供帮助。
在此页面上,您将获得一些快速提示,帮助您开始使用 Gantry 5。您可以通过单击每个部分底部的“了解更多”按钮找到每个提示的更详细文档。
我们希望您喜欢 Gantry 5,就像我们喜欢制作它一样。
Gantry的后端管理要求按优先顺序如下:
注意:不再支持 Internet Explorer
Gantry 5 是一个用于制作由 Gantry 驱动的主题的框架。为了使 Gantry 主题正常工作,您需要安装框架和主题。做到这一点并不困难。
您需要做的第一件事是下载最新版本的 Gantry 5 和 Hydrogen。您可以通过单击下面的链接或通过 GitHub 来完成此操作。
| 下载稳定版 | 下载 CI 构建 |
|---|
一旦获得最新的软件包,安装就很简单。我们在本文档的安装部分提供了分步指南。
了解更多
当您安装并激活 Gantry 框架和 Hydrogen 后,您可以通过多种不同的方式访问 Gantry 5 管理员。最简单的方法是从 Joomla 后端导航到“组件”>“Gantry 5 模板” 。
在这里,您将看到所有已安装的 Gantry 支持的主题的列表。您可以从此处预览主题,或选择“配置”直接转到Gantry 管理员,您可以在其中开始修改由 Gantry 驱动的站点。
Gantry 管理员有多个管理工具,您可以浏览它们来配置 Gantry 驱动的主题的外观和功能。以下是每个工具的快速细分,以及您可以使用它们做什么。
您会注意到 Gantry 5 Administrator 中的以下菜单项:
菜单编辑器:此管理面板使您能够通过更改样式、重新排列链接以及创建位于 CMS 集成菜单管理器之外的菜单项来增强平台的菜单。
关于:此页面为您提供有关当前访问主题的快速、一目了然的信息。这是一个一站式商店,提供有关主题的信息,包括:名称、版本号、创建者、支持链接、功能等。
平台设置:此按钮将带您进入 Gantry 5 的 CMS 设置页面。在 Joomla 中,这是权限配置页面。
清除缓存:此按钮清除与 Gantry 相关的缓存文件。这包括 CSS 和配置信息之外的所有临时文件。
大纲下拉菜单:此下拉菜单可以轻松地在大纲之间快速切换,而无需离开 Gantry 管理员。
样式:此管理面板使您可以访问与样式相关的轮廓设置。这包括主题颜色、字体、样式预设等。
设置:此管理面板使您能够配置主题的功能设置。这包括设置粒子的默认值,以及启用/禁用单个粒子。
布局:您可以在此管理面板中配置主题的布局。创建放置模块位置、粒子、间隔和非渲染脚本(例如 Google Analytics 代码)均在此面板中完成。
了解更多
由于 Gantry 5 与之前的任何版本的 Gantry 都有很大不同,因此我们提出了一些术语来帮助理解 Gantry 的新功能之间的关系。以下是与 Gantry 5 相关的常用术语的快速细分。
| 学期 | 定义 |
|---|---|
| 大纲 | 一种用于站点的一个或多个区域的可配置样式。它充当设置页面样式、设置和布局的容器。 |
| 粒子 | 前端使用的典型小数据块。它的行为很像一个小部件/模块,但可以在 Gantry 5 Administrator 中轻松配置。 |
| 原子 | 一种包含非渲染数据的粒子类型,例如自定义脚本(JS、CSS 等)或用于流量跟踪的分析脚本。 |
了解更多
我们已经使用 Gitter 设置了一个聊天室,您可以在其中与开发人员、贡献者和社区的其他成员讨论该项目。这是获取快速提示并与其他人讨论功能的最佳场所。
文档也是可用的,并且随着开发的进展不断添加。是不是少了什么东西?您可以通过 GitHub 为文档做出贡献。
为 Gantry 5 框架或其相关文档做出贡献很容易。这两个项目的开发都是通过 Github 进行的,您可以在其中提交问题来报告任何错误或提出改进建议,也可以提交您自己的Pull 请求来提交您自己的修复和添加。
我们建议在提交拉取请求之前通过 Gitter 与团队聊天,以避免重复修复已经待处理或可能被即将发生的更改覆盖的修复。
要使用 Git 版本的 Gantry,首先需要安装 Composer 依赖项。为此,请运行:
bin/composer-install
之后,您需要将 Gantry 正确符号链接到您的 CMS 安装中。
在我们的开发环境中,我们使用Gulp来捆绑JavaScript并编译带有watch功能的SCSS ,这样目标文件的任何更改都会自动触发重新编译。
如果您想在自己的开发环境中进行设置,可以按照这些简单的说明进行操作。
请注意,要使其工作,您需要有Gantry 5源代码而不是软件包。您可以克隆它或从 GitHub下载源代码。
您首先需要的是Node / NPM 。如果您还没有,您可以从 https://nodejs.org/download/ 获取适合您操作系统的安装程序。
下一步是安装所有 JS 模块依赖项。为此,请确保您位于 Gantry 5 项目的根目录,然后运行命令npm install 。
完成后,您可以安装Gulp 。我们建议全局安装 Gulp,以便您可以从任何文件夹使用该命令。以下是执行此操作的命令: sudo npm install gulp --global
Gantry 有不同的 JS 和 CSS 文件集,可以从根目录重新编译。第一次开始使用 Gantry,或者如果您需要重置并重新安装所有模块,您可以运行命令npm run build-assets 。此操作将删除所有node_modules文件夹并在所有项目文件夹中重新运行npm install 。这需要一段时间。
另一种不会删除所有node_modules文件夹的替代方法是通过gulp -up 。
除了
-up命令之外,您还可以使用-update、--update、-up、--up、-install、--install、-inst、--inst、-go、--go、-deps、--deps。哪个对你来说更容易记住。代码将自行了解是否需要首次安装或仅更新节点模块。请注意,这可能需要一些时间。
此时,您已拥有运行 Gulp 所需的一切。只需输入命令gulp ,您应该会看到 CSS 和 JS 被编译。
我们还提供了一些方便的任务:
$ gulp / $ gulp all :编译项目中的所有CSS和JS。$ gulp watch :以watch模式启动编译器。应用于目标JS或SCSS文件的任何更改都将触发自动重新编译。$ gulp watch --css / $ gulp watch --js :以watch模式启动编译器并仅侦听SCSS或JS更改。如果您只关注其中一个而不关注另一个,这很有用。$ gulp css / $ gulp js :编译所有 CSS 或 JS 文件,以防您只处理其中一个而不处理另一个。$ gulp —prod :在生产模式下编译每个 CSS 和 JS。编译的文件不会有源映射并且将被压缩(这通常比正常模式花费的时间稍长)。 Google Fonts JSON 文件可以按照https://developers.google.com/fonts/docs/developer_api上的指南生成,或者简单地使用https://www.googleapis.com/webfonts/v1/webfonts?key=YOUR-API-KEY网址。您需要启用 Google Fonts API 的使用,并提供您的 API 密钥来代替YOUR-API-KEY 。
Gantry Framework v5 或更高版本在双许可证系统(MIT 或 GPL 版本 2 或更高版本)下获得许可。这意味着您可以自由选择适合您需求的许可证(MIT 或 GPL 版本 2 或更高版本)。
| 更多详情 |
|---|