README

UMD Terp 是所有 UMD Drupal 8 项目的基主题。它将 UMD 审批的元素和功能结合到一个修改后的 Bootstrap 主题中。它最好与 UMD Terp Base 模块 一起使用，该模块提供了一套模块和配置，以使此主题按设计工作。它还被设计用于集成 UMD 全校性标题。

此主题可以单独使用，也可以作为自定义子主题进一步定制的基主题。

• UMD Terp 主题
• UMD Terp Base 模块
• UMD 全校性标题

需求

• Twig Tweak 模块
• UMD Terp Base 模块

安装

• 确保已启用 Twig Tweak 模块。
• 确保已启用 Twig Field Value 模块。
• 按通常安装任何 Drupal 8 主题的方式安装。

通过 Composer

• composer require umd_digital/umd_terp --prefer-dist
• drush en umd_terp 或通过管理界面启用

手动

• 将此存储库下载到 /themes/contrib/umd_terp
• drush en umd_terp 或通过管理界面启用

配置

• 确保已安装 UMD Terp Base 模块 并启用子模块。

主题选项

UMD Terp 标题设置

• 浅色标题样式：默认为深色标题/导航区域。此选项将其切换为浅色标题/导航区域。

UMD Terp 页脚设置

• 标志：部门/机构等的标志。
• 地址：部门/机构等的地址。
• 电话号码：部门/机构等的电话号码。
• 电子邮件：部门/机构等的电子邮件地址。

UMD Terp 社交媒体账号

• 推特链接：部门/机构等的推特链接。
• 脸书链接：部门/机构等的脸书链接。
• YouTube 链接：部门/机构等的 YouTube 链接。
• Instagram 链接：部门/机构等的 Instagram 链接。
• 领英链接：部门/机构等的领英链接。

UMD Terp 目录设置

• 返回目录文本：为个人资料页上的返回目录链接提供文本。
• 返回目录路径：为个人资料页上的返回目录链接提供路径。

UMD Terp 管理设置

• 资产路径：仅限开发使用。主题中任何静态图像等的资产路径，用于在 twig 主题中。

开发

版本控制

语义标记必须在 github 上进行，以便通过 composer 拉取更新。准备部署时，在 github 上创建一个标签，比上一个版本高一个版本，起始版本为 8.1.0。

• 次要版本（非破坏性更改）：8.1.1、8.1.2 等。
• 主要版本（破坏性更改）：8.2.0、8.3.0 等。

标签通过 Gitflow 处理。分支命名如下

• 生产发布分支：master
• 下一个发布开发分支：develop
• 功能分支前缀：f-
• 发布分支前缀：r-
• 热修复分支前缀：h-
• 支持分支前缀：s-

核心（基础）主题问题、补丁等

所有编辑、请求等应提交到UMD Terp Theme的GitHub仓库。请将问题添加到问题队列。补丁将根据质量及可用资源进行审查。

前端

所有CSS、JS等文件均基于static文件夹。本项目提供的开发体验与idfive组件库类似，但底层前端库使用Bootstrap 4。

UMD组件库包含Fractal用于组件化开发。您可以将自己的组件添加到src/components文件夹。静态资源如JavaScript、CSS和图片将从build文件夹提供，但也可以通过编辑fractal.js文件进行配置以满足特定需求。更多信息，请参阅fractal指南。

有关前端配置的更多信息，请参阅/static/README.md。

定制化

此主题绝对不应直接修改。相反，创建一个子主题，以便您仍能从此基础主题的将来版本中受益。一旦完成，您就可以在该子主题内覆盖CSS、模板和主题处理。有关更多信息，请参阅子主题。

关于定制化的注意事项

• 一些小部件包含“暗黑模式”。在重新设计厨房水槽小部件时，请考虑这一点。
• 别忘了考虑到UMD Schoolwide Header。

故障排除

• 请确保Twig Tweak Module已存在并已启用。