README

资源中心

催化剂资源中心是一个基于Drupal的发行版，旨在帮助中小型慈善机构向关键受众发布资源和指导材料。本文件主要面向想要在本地机器上测试产品或安装、部署和托管产品的开发者。

入门

系统要求

资源中心已设计为通过Composer安装，并且内置了对Lando的支持，因此以下描述的最直接设置将需要以下内容在您的系统上安装

• Composer 2
• Lando 3

快速入门：本地项目设置（测试用）

在安装了Composer和Lando后，您应该能够打开命令行并运行以下命令以获取本地版本的产品，以便进行测试或开发。您应该能够复制并粘贴以下所有行到命令行中。

composer create-project --stability dev --ignore-platform-reqs --no-install --remove-vcs openresources/resourcehub-project:^1.0 resourcehub;
cd resourcehub;
lando start; lando drush si resourcehub install_configure_form.install_demo=1 -y;

这将执行以下任务

1. 使用Composer安装所有代码和依赖项。
2. 启动Lando容器以运行代码
3. 运行Drupal站点安装并启用演示内容模块。
4. 提供管理员用户名和密码。

如果您然后在浏览器中导航到以下任一URL，您应该看到该站点

http://resourcehub.lndo.site:8000/

https://resourcehub.lndo.site/

快速入门：本地项目设置（开发者）

如果您在本地上进行开发，您可能希望保留.git版本控制文件夹以便于使用。

composer create-project --stability dev --ignore-platform-reqs --no-install openresources/resourcehub-project:^1.0 resourcehub
cd resourcehub
lando start; lando drush si resourcehub install_configure_form.install_demo=1 -y; lando drush uli;

这将执行以下任务

1. 使用Composer安装所有代码和依赖项。
2. 启动Lando容器以运行代码
3. 运行Drupal站点安装并启用演示内容模块。
4. 生成一次性登录链接并登录为总体管理员账户（用户1）。

本地安装Drupal

通过UI安装

1. 导航到https://resourcehub.lndo.site
2. 在“选择配置文件”步骤中选择“资源中心”
3. 完成Drupal配置步骤

通过命令行安装

1. 移动到项目目录
2. 运行lando drush si resourcehub

安装演示内容

如果您安装资源中心以测试它，可以选择自动创建一些演示内容，这可以通过在UI中勾选“安装演示内容”复选框或通过传递Drush的附加参数来完成。

lando drush si resourcehub install_configure_form.install_demo=1

如果您已经安装了资源中心，则可以简单地启用ResourceHub Demo Content模块。

运行测试

以下命令将运行安装配置文件提供的测试。

lando phpunit

代码分析

本项目包含PHPCS和PHPSTAN集成，允许开发者检查其代码与Drupal样式和标准兼容性。

lando sniff将检查安装配置文件与Drupal代码风格兼容性。使用lando phix，您可能能够通过PHPCBF自动修复这些问题。

lando stan将检查您的代码与Drupal标准的兼容性，包括对弃用API的使用。

前端工具

CSS工具基于Laravel Mix。

在themes/resourcehub_theme/scss中监视文件更改并运行browserSync，运行lando npx mix watch。