innis-maggiore / silverstripe-amp
此软件包已被废弃,不再维护。未建议替代软件包。
模块,用于将 SilverStripe 页面转换为 Google AMP HTML
1.9
2018-08-24 21:42 UTC
Requires
- lullabot/amp: ^1.0.0
- silverstripe/cms: 3.7.*
- silverstripe/framework: 3.7.*
README
将页面转换为 Google Amp HTML。有关 AMP HTML 的更多信息,请参阅 Google AMP 项目主页。
要求
- SilverStripe 3.6.x
安装
Composer(推荐)
composer require innis-maggiore/silverstripe-amp
如果您愿意,也可以手动安装
- 从这里下载模块 LINK
- 将下载的存档解压缩到您的网站根目录,使得目标文件夹名为 silverstripe-amp,解压缩后的文件夹应包含根目录中的 _config.php 文件以及其他文件/文件夹
- 运行 dev/build?flush=all 以重新生成清单
使用
该模块会自动在您的 MetaTags 中添加一个链接,指向页面的 AMP HTML 版本 http://yousite.com/page-name/amp.html。
然后,一个自定义控制器使用页面的 AMP HTML 版本来渲染内容。在渲染之前,<img /> 标签会自动转换为 <amp-img />。
可以在 AMP 标签下的“设置”中设置一个标志。关于 AMP 标志尺寸的建议来自 这里
有三个基本的内容字段可以出现在每个页面上(除上述提到的标志外)
- 一张图片
- H1
- 正文副本
这些字段可以在“AMP内容”抽屉中手动设置在页面级别,或者在页面模型(扩展 SiteTree 的类,而不是控制器)中使用此方法指定模板
private static $amp_fields = [
'AmpImage' => 'MyImageFieldName',
'AmpHeader' => 'H1',
'AmpContent' => 'Content'
];
请注意,左边的字段用于 AMP 模板,而右边的字段是您的模板中的一个字段。
主题和自定义页面类型
基础页面类型是 Amp.ss,可以在您的主题中覆盖,就像任何 SilverStripe 模板一样。自定义页面类型可以使用您的主题中的 ClassName_amp.ss 来渲染。
文档 TODO
- 如何覆盖图标
待办事项
这是一个作为概念验证的初始提交
- 添加与 Simple 主题匹配的基本样式
- 创建模块化模式系统
- 添加常见 Amp 组件的可配置脚本