Drupal9.2.4自定义主题的配置安装与开发查看

    在Drupal9.2.4环境下,按照drupal8的规范《Drupal8.7.6自定义主题、安装及其查看》配置开发环境,前端页面会弹出“未知错误”的提示,同时网站前端页面是无法打开的。
 
    这说明Drupal9.2.4更新后,添加了drupal8所没有的特性。根据Drupal9.2.4的规范配置相应文件即可顺利进入开发环境。
 
    依据这个思路,参考开发经验,白龙网尝试了把Drupal9.2.4中默认主题/core/themes/bartik复制到自定义主题目录/themes/下,刷新前端页后仍然无法正常显示;修改相关/themes/bartik文件及其子目录相关内容,重建缓存刷新页面还是前端页面还是提示“未知错误”无法显示。说明这个尝试是无效的。也测试了把系统自带的其它主题如classy、stable等作为自定义主题来用,也没有成功。
 
    可能是系统自带的主题依赖太多没有配置到位或者某些地方有冲突,导致系统自带的主题修改后无法作为自定义主题使用。
 
    然后,从drupal官网下载了一个兼容drupal9和drupal8的自定义主题包“Danland”,解压后放到/themes/目录,设置其为默认主题并修改相关配置文件、模板文件,重建缓存后刷新前面页面,前端页面可以显示修改后的模板内容,这说明我们可以参考drupal9官网上的自定义主题的配置方式来减少配置相关文件,提升开发效率。下面白龙网为大家分享下drupal9.2.4自定义主题开发的操作流程。
 
    一、下载样板主题
 
    进入drupal官网,找到并下载同时兼容drupal9和drupal8的自定义主题“danland”:https://www.drupal.org/project/danland。
 
    二、解压主题文件
 
    1.解压自定义主题“danland”压缩包至自定义主题目录/themes/下;
 
    2.在“管理->外观”中安装并设置danland主题为默认主题,然后保存;
 
    3.刷新后,在前端页面可以看到正常展示的danland主题。
 
    三、修改文件信息
 
    从官网下载的自定义主题可能很多功能信息并不是我们想要的,此时修改相应文件即可,例如我们把danland主题相关信息修改成白龙网(bailong)主题相关信息:
 
    1.把/themes/danland文件夹名称修改为/themes/bailong;此处的bailong将作为路径之一输出到前端,可根据网站域名、命名习惯自定义文件名称;
 
    2.把/themes/danland/danland.info.yml配置文件夹名称修改为/themes/bailong/bailong.info.yml;另外,要把danland.info.yml文件内的name、project等字段属性修改为bailong,建议用ctr+h查找到danland后全部统一替换为bailong,以减少出错概率,提高开发效率;
 
    3.把/themes/danland/danland.libraries.yml库文件夹名称修改为/themes/bailong/bailong.libraries.yml;库文件danland.libraries.yml中如果有danland,同样建议用ctr+h查找到danland后全部统一替换为bailong。
 
    4.把/themes/danland/danland.theme主题文件夹名称修改为/themes/bailong/bailong.theme;很多时候,大家会忽略这个文件名的修改,导致站点出现未知错误。因此,一定要修改;
 
    5.清空/themes/danland/目录下css、js、templates文件夹内所有内容,放入自己的css、js、templates内容。
 
    上述5步,总结来说就是要把所有自定义主题中出现的所有danland修改为bailong(或者其它名称,根据需求命名),然后再用自己的css、js、templates内容替换原主题中的css、js、templates内容。
 
    四、查看修改主题
 
    在“管理->外观”中刷新后,会发现danland主题名称、版本、描述等修改过的相关信息已经变成bailong主题的相关信息。
 
    五、重建缓存刷新
 
    重建缓存并刷新前端页面后,前端的danland页面已经被bailong主题页面所替代。
 
    基于drupal9.2.4自定义主题的开发模式,我们可以借鉴之,然后把它应用到drupal8.9升级到drupal9.2.4需求中。