TYPO3中自定义RTE YAML文件的存放位置及注册方法

一、配置文件存放位置 #

你有两种合规的存放路径可选，完全不会触碰vendor目录：

• 自定义扩展内：将自定义YAML文件放在扩展的Configuration/RTE/目录下，示例路径：
  typo3conf/ext/your_extension_key/Configuration/RTE/CustomRTE.yaml
• 站点包内：如果使用站点包（Site Package）架构，也可以放在站点包的Configuration/RTE/目录下，示例路径：
  typo3conf/sitepackages/your_sitepackage/Configuration/RTE/CustomRTE.yaml

二、在ext_localconf.php中注册配置 #

在对应扩展（或站点包）的ext_localconf.php文件中，使用ExtensionManagementUtility的addRTEConfig方法注册自定义配置：

// 替换your_extension_key为你的扩展/站点包的扩展名
\TYPO3\CMS\Core\Utility\ExtensionManagementUtility::addRTEConfig(
    'custom_rte', // 自定义配置的唯一标识符，可自行命名
    'EXT:your_extension_key/Configuration/RTE/CustomRTE.yaml'
);

• 第一个参数是配置的标识符，后续在后端配置RTE字段时会用到这个名称
• 第二个参数是配置文件的EXT路径，需和实际存放路径完全匹配

三、配置文件编写提示 #

可以直接复制vendor/typo3/cms-rte-ckeditor/configuration/RTE/Default.yaml的内容到自定义文件中，再根据需求修改工具栏布局、插件启用状态、格式规则等配置项，这样能保证基础功能正常运行。

内容的提问来源于stack exchange，提问作者tg22a