README

#1 简介 本配置文件的主分支不再是从属配置文件 Lightning 配置文件。

主分支正在用于构建一个简化的 Drupal 9 配置文件，供我们自己的使用，该配置文件不会实现 Drupal 8 配置文件中当前提供的相同开箱即用功能，并且不依赖于 Lightning。

此配置文件的稳定 Drupal 8 版本仍可在分支 4.1.3、4.1.5 和 4.1.9 上找到，但在 2021 年 11 月，当 Lightning 达到生命周期的终点 时，以及 Drupal 8 达到生命周期的终点时，将终止支持。

#2 Drupal 9 配置文件的描述

此配置文件提供 composer.json / composer.lock 起始文件（位于 assets/scaffold/files/composer/），可以复制到新的项目文件夹中以构建该项目。针对这些 composer 文件运行 composer install 会完成以下操作：

• 在 docroot/ 下构建站点
• 创建 web/ 的符号链接到 docroot/
• 如果不存在，则创建 drupal_config/config/ 文件夹，并将此配置文件的起始配置复制到该文件夹
  • 此配置文件启用和配置的模块包括：
    • admin_toolbar
    • admin_toolbar_links_access_filter
    • admin_toolbar_tools
    • advagg
    • advagg_css_minify
    • advagg_js_minify
    • advagg_mod
    • advagg_validator
    • big_pipe
    • blazy
    • blazy_ui
    • block
    • bootstrap_layouts
    • breakpoint
    • captcha
    • ckeditor
    • config
    • contextual
    • crop
    • ctools
    • datetime
    • dblog
    • dynamic_page_cache
    • editor
    • embed
    • entity_browser
    • entity_embed
    • entity_reference_revisions
    • field
    • field_group
    • field_ui
    • file
    • file_mdm
    • filter
    • google_tag
    • help
    • honeypot
    • image
    • image_widget_crop
    • imagemagick
    • layout_builder
    • layout_discovery
    • link
    • media
    • media_library
    • memcache
    • memcache_admin
    • menu_link_content
    • menu_ui
    • metatag
    • node
    • options
    • page_cache
    • password_policy
    • password_policy_character_types
    • password_policy_characters
    • password_policy_history
    • password_policy_length
    • password_policy_username
    • path
    • path_alias
    • rdf
    • recaptcha
    • seckit
    • security_review
    • smtp
    • sophron
    • system
    • taxonomy
    • text
    • token
    • toolbar
    • update
    • user
    • username_enumeration_prevention
    • video_embed_field
    • video_embed_media
    • views_ui
    • webform
    • webform_ui
    • pathauto
    • views
    • paragraphs
    • opencommunications
• 调用 opencommunications 的构建，执行以下操作：
  • 将 assets/scaffold/files/ 中的起始 .gitignore、settings.php 文件和 ses_mailer 服务 yaml 复制到相应的项目位置。
  • Blazy模块（https://www.drupal.org/project/blazy）没有指定对Blazy库（https://github.com/dinbror/blazy）的依赖，因此Blazy库作为脚手架资产被包含。如果需要更新Blazy库，请将最新版本下载到assets/scaffold/files/blazy
  • 应用已知未解决的补丁到核心和包含的contrib模块

#3 使用方法

##3.1 从配置文件创建并安装新站点

• mkdir my_new_project
  
• cd my_new_project
  
• wget https://raw.githubusercontent.com/NREL/opencommunications/master/assets/scaffold/files/composer/composer.json
  
• wget https://raw.githubusercontent.com/NREL/opencommunications/master/assets/scaffold/files/composer/composer.lock
  
• 编辑composer.json，将new_project替换为my_new_project，将site_name替换为my_new_site_name
  
• composer install
  
• drush si opencommunications --existing-config --account-name=account-name --account-mail=account-mail --account-pass=account-pass --db-url=db-driver://db-su:db-su-pw@db-host:db-port/db-name -y
• drush cset system.site name "my_new_site_name" -y
  
• drush cset system.site mail no_reply@example.com -y
  
• 将现有设置.php文件末尾添加的数据库连接详情移动到settings.local.php

##3.2 可选

##3.2.1 reCaptcha

• 为网站创建recaptcha账户
  
• 设置reCaptcha网站和密钥
  
  • drush cset recaptcha.settings site_key new_site_key -y
    
  • drush cset recaptcha.settings secret_key new_secret_key -y
    
• drush cset captcha.settings enabled_default 1 -y
  

##3.2.2 Google Tag Manager

• 设置'default' GTM容器的id
  • drush cset google_tag.container.default container_id GTM-xxxxxx -y
    

##4 更新使用该配置文件现有的站点

• composer update nrel/opencommunications

#5 更新此配置文件

##5.1 更新一个包

• composer update vendor/package
• 添加、提交并推送更改

##5.2 更新模板composer.lock

• 创建一个虚拟项目
  • mkdir dummy_project
    
  • cd dummy_project
    
  • wget https://raw.githubusercontent.com/NREL/opencommunications/main/assets/scaffold/files/composer/composer.json
    
• 更新composer.lock
  • composer install
• 将composer.lock复制到NREL/opencommunications/master/assets/scaffold/files/composer/composer.lock
• 添加、提交并推送更改到composer.lock