README

此主题旨在为使用模块包的 Tripal 网站开发特定项目或研究小组的定制主题提供基础。我们请求您不要直接使用此主题，而是将其作为开发项目或小组独特外观的基础。至少您需要为您的网站选择一种独特的颜色、一个标志和一个头部图像。

安装

首先通过 composer 安装此主题

composer require tripalcultivate/trpcultivatetheme

然后，将主题的模块部分符号链接到模块目录中

cd web/modules/contrib
ln -s [pathToDrupalRoot]/themes/TripalCultivate-Theme/trpcultivatetheme_companion

现在您可以首先启用模块，然后启用主题。

定制此主题

您可以使用以下 drush 命令设置主要基本颜色，将 #f54278 替换为您想要的任何十六进制代码。

drush config:set trpcultivatetheme.settings base_primary_color '#f54278'

开发

Docker

如您所注意到的，此存储库中有一个 Dockerfile。向此主题贡献的最佳方式与核心开发的建议相同：请使用 Docker :-)

git clone https://github.com/TripalCultivate/TripalCultivate-Theme trpcultivatetheme
cd trpcultivatetheme
docker build --build-arg drupalversion=10.2.x-dev --build-arg phpversion=8.3 --tag=trpcultivate-theme:4x ./
docker run --publish=80:80 -tid --name=theme4x \
  --volume=$(pwd)/trpcultivatetheme:/var/www/drupal/web/themes/trpcultivatetheme \
  --volume=$(pwd)/trpcultivatetheme_companion:/var/www/drupal/web/modules/contrib/trpcultivatetheme_companion \
  trpcultivate-theme:4x
docker exec theme4x service postgresql restart

此 Docker 图像/容器将包含一个完全功能的基于 TripalDocker 的 Tripal 4 网站，使用指定的 Drupal 和 PHP 版本构建。有关 TripalDocker 的更多信息，请参阅官方文档[链接]。

Twig 调试

Dockerfile 设置了开发环境，并开启了 twig 调试。这将在每个页面的 HTML 注释中添加模板建议，并在检测到文件更改时刷新 twig 模板缓存。您仍然需要使用 drush cr 来查看 CSS 和模板更改，但在此设置下会更可靠。

Olivero 作为基础主题

此主题使用核心 Olivero 主题作为基础主题。截至 2024 年 2 月，这并不是技术上的推荐做法，因为 Olivero 的标记尚未固定。有关在 Drupal Issue #3190946 - [META] Subtheming Olivero 中使用 Oliverio 作为子主题的当前状态/建议，请参阅。

正如您在 该问题的评论 #19 中所看到的，我们决定尽管不建议使用 Olivero 作为基础主题，但我们仍然决定使用它。这是因为我们认为将此主题与 Olivero 中的任何标记更改更新所付出的努力可能比我们考虑的其他选项要少。如果我们像建议的那样复制 Oliverio 并将其重命名为我们自己的目的，那么重新合并 Olivero 在核心中进行的任何更新/修复将是一项大量工作。这是因为所有文件名称都已更改，我们无法直接比较文件或 git merge。截至 2024 年初，主题景观仍然非常稀疏，因此我们无法简单地使用更稳定的主题作为基础。有几种 Bootstrap 基础主题可供选择，但社区已经相当分裂，这使得长期可持续性变得令人困惑。此外，我们不喜欢这些基础主题提供的基础主题。