innis-maggiore/silverstripe-amp

此软件包已被废弃,不再维护。未建议替代软件包。

模块,用于将 SilverStripe 页面转换为 Google AMP HTML

安装: 23

依赖项: 0

建议者: 0

安全: 0

星标: 0

关注者: 2

分支: 7

开放问题: 0

类型:silverstripe-module

1.9 2018-08-24 21:42 UTC

This package is auto-updated.

Last update: 2023-04-25 23:52:55 UTC


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 组件的可配置脚本