README

Drupal 大坝

大坝的使命是让开发者能够创建出色的创作体验，并赋予编辑团队权力。

您会发现大坝初始时看起来非常简洁。这是有意为之。我们希望赋予编辑团队权力，并让开发者能够快速启动网站构建。这意味着开发者永远不需要撤销大坝所做的任何操作。因此，我们从一张白纸开始，并从那里为每个添加项进行辩护。

安装大坝

安装大坝的首选方式是使用我们的基于Composer的项目模板Composer-based project template。非常简单！

$ composer create-project nrel/communications-project MY_PROJECT

如果您不想使用Composer，您可以通过从我们的drupal.org项目页面下载tarball来以传统方式安装大坝。请注意，tarball不包含任何实验性功能。

您可以通过创建一个子配置文件，该配置文件使用Lightning作为其基本配置文件来自定义您的安装。Lightning包括一个Drupal Console命令（lightning:subprofile），该命令将为您生成一个子配置文件。

大坝的功能

通过自定义模块和配置，Lightning旨在针对四个功能区域

媒体

当前版本的媒体包括以下功能

预配置的文本格式（富文本）带有CKEditor WYSIWYG。
WYSIWYG中的媒体按钮（目前由星号表示），用于启动自定义媒体小部件。
将媒体放入文本区域并将其完全嵌入，使其在实时实体中显示。以下媒体类型目前受支持
- 推文
- Instagram帖子
- 视频（支持YouTube和Vimeo）
- 图片
拖放图片上传
通过媒体库（/media/add）创建新媒体的能力
通过粘贴视频URL将推文、Instagram和YouTube/Vimeo视频直接嵌入CKEditor的能力

扩展大坝媒体（贡献模块）

Drupal社区成员已贡献了几个模块，这些模块将大坝媒体与额外的第三方媒体服务集成。这些模块不包括在大坝中，也不是由Acquia维护的，但它们是稳定的，您可以在您的Dam网站上使用它们。

布局

Lightning包括Panelizer模块，允许您使用拖放界面（Panels IPE）配置任何内容类型的布局。Lightning还包括一个着陆页内容类型，您可以创建具有独特布局和内容的着陆页。

使用Panelizer的任何内容类型都将允许您为该内容类型的每个视图模式设置默认布局，您可以从中选择（或一次性覆盖）用于单个内容项。

Panel提供了八个布局，您可以根据需要创建自己的布局（请参阅Layout Plugin模块）或安装布局库，如Radix Layouts。

工作流

Lightning提供构建组织特定内容工作流程的工具。开箱即用，Lightning允许您以四种工作流程状态（草案、需审查、已发布和存档）之一管理内容。您可以根据需要创建任意多个附加状态，并定义它们之间的转换。还可以安排内容（单个节点或多个节点）在未来某个特定日期和时间过渡到不同状态。

预览（实验性）

工作空间预览系统（WPS）为网站建设者、编辑、作者和审阅者提供了通过编辑工作流程发送内容集合并在当前实时网站上下文中预览这些内容的能力。WPS是一组贡献的Drupal模块集合，具有额外的配置UX改进，所有这些都可以开箱即用。

请注意，工作空间预览系统是实验性的，目前不包括在Lightning的稳定版本中。如果您想使用它，请参阅下文中的“实验性功能”。

项目路线图

我们为每个补丁版本发布冲刺计划。您可以在Drupal.org上的[此元问题][meta_releases]中找到当前计划的链接。

实验性功能

Lightning的一些组件（如工作空间预览系统）目前处于实验性状态，直到它们稳定。实验性功能应被视为尖端技术，不适用于生产环境。

实验性功能保存在Lightning的8.x-2.x-experimental开发分支中。要使用实验性功能，您需要从该分支创建您的Lightning代码库。这只能使用基于Composer的项目模板完成 -- 请参阅那里以获取有关如何使用实验性功能的更多信息。

资源

您可以在每个Lightning "基础"模块的help目录中找到一般最佳实践文档。计划与高级帮助模块集成。

每个用户故事的演示视频可以在这里找到。

请使用Drupal.org问题队列获取最新信息，并请求功能或错误修复。

运行测试

这些说明假设您已使用Composer安装了Lightning。一旦安装并运行，请按照以下步骤执行Lightning的所有Behat测试

Behat

$ cd MYPROJECT
$ ./bin/drupal behat:init http://YOUR.LIGHTNING.SITE --merge=../tests/behat.yml
$ ./bin/drupal behat:include ../tests/features --with-subcontexts=../tests/features/bootstrap --with-subcontexts=../src/LightningExtension/Context
$ ./bin/behat --config ./docroot/sites/default/files/behat.yml

如果需要，您可以编辑docroot/sites/default/files/behat.yml以匹配您的环境，但通常您不需要这样做。

已知问题

媒体

如果您使用新图像浏览器将图像上传到图像字段，您可以在上传时设置图像的alt文本，但该文本不会复制到图像字段。这是由于实体浏览器API的限制。

工作流

Lightning工作流程基于Workbench Moderation，与Drupal核心8.3.0及以后的实验性内容审查模块不兼容，并服务于与Workbench Moderation相同的目的。我们计划在它稳定后无缝迁移Lightning工作流程到内容审查，最可能在Drupal 8.4.0。但到目前为止，与Lightning工作流程一起安装内容审查可能产生不可预测且危险的效果，最好避免。

nrel / dam

维护者

详细信息