gugler/ckeditor-language

文本部分语言功能允许您标记文本片段的语言。这样,浏览器和屏幕阅读器可以正确解释不同语言编写的部分。

安装: 537

依赖项: 0

建议者: 0

安全: 0

星星: 0

观察者: 1

分支: 0

开放性问题: 0

语言:JavaScript

类型:typo3-cms-extension

1.0.0 2024-03-13 12:16 UTC

This package is auto-updated.

Last update: 2024-09-13 13:32:45 UTC


README

Extension icon

CKEditor 5:单词断句插件(TYPO3扩展)

兼容性

TYPO3 12.4.0 - 12.4.99 CKEditor 5

此扩展做什么?

  • 文本部分语言功能允许您标记文本片段的语言。这样,浏览器和屏幕阅读器可以正确解释不同语言编写的部分。
  • 编辑器可以通过选择下拉框来更新语言

截图

TYPO3后端中的CKEditor:语言选择菜单

CKEditor in TYPO3 backend: Lanugage selection menu

语言可以在 "Resources/Public/JavaScript/textpartlanguageediting.js" 中配置,通过 @gugler/textpartlanguageediting 标记文本并选择语言将添加带有语言配置的 span 标签。

TYPO3后端中的CKEditor:HTML代码

CKEditor in TYPO3 backend: HTML code

安装

composer req gugler/ckeditor-language

此扩展需要像其他TYPO3 CMS扩展一样安装。

执行以下步骤

  1. 加载并安装扩展
  2. 扩展您的CKEditor配置(见下文)
  3. (可选) 如果您想覆盖选定的语言,请在您的扩展中设置要求(见下文)

CKEditor配置

editor:
  config:
    importModules:
      - "@ckeditor/ckeditor-language"

覆盖语言

在composer.json中设置gugler/ckeditor-language的要求。这是为了确保插件按正确的顺序加载。只有最后声明将被使用!

"require": {
    ...
    "gugler/ckeditor-language": "*",
    ...
  },

将 "Resources/Public/JavaScript/textpartlanguageediting.js" 复制到您自己的扩展,并按如下方式覆盖

...
constructor(editor) {
    super(editor);
    // Text part language options are only used to ensure that the feature works by default.
    // In the real usage it should be reconfigured by a developer. We are not providing
    // translations for `title` properties on purpose, as it's only an example configuration.
    editor.config.define("language", {
      textPartLanguage: [
        { title: "<insertLanguageName>", languageCode: "<isnertLanguageCode>" },
        { title: "Arabic", languageCode: "ar" },
      ],
    });
  }
  ...

然后您需要覆盖JavasScriptModules: 路径: Configuration/JavaScriptModules.php


<?php

return [
  "dependencies" => ["backend"],
  "tags" => ["backend.form"],
  "imports" => [
    "@gugler/textpartlanguageediting" => "EXT:<extension_name>/<extension_path>/textpartlanguageediting.js",
  ],
];