neues-studio / hyphen-dictionary
使用词典在服务器端为文本添加连字符。
1.0.1
2024-03-08 08:42 UTC
Requires
- php: ^7.4 || ^8.0
- typo3/cms-core: ^10.4 || ^11.5 || ^12.4
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.9
- saschaegerer/phpstan-typo3: ^1.8
- sbuerk/typo3-cmscomposerinstallers-testingframework-bridge: ^0.1
- typo3/testing-framework: ^6.16.8 || ^7.0
Replaces
- typo3-ter/hyphen-dictionary: 1.0.1
README
1 动机
在过去几年中,我们创建了许多带有移动版本的TYPO3网站。根据设计,移动版本通常具有相当大的字体大小的标题。使用长单词会导致标题被截断或因为浏览器决定在哪里断词而出现奇怪的断词。为了支持定义可选的标题字段断词(),我们创建了此扩展。
2 功能介绍
此扩展允许编辑器定义单词词典以及每个单词的可选断词。
使用流体模板中的ViewHelper替换给定输入为词典中定义的单词。
3 使用方法
使用以下命令安装此扩展:
composer req neues-studio/hyphen-dictionary
3.1 创建词典
在TYPO3后端创建一个sys文件夹,并将带有可选断词的单词添加到其中。要设置可选断词,请在单词应该断开的位置使用[-]
。
请注意,定义的单词是大小写敏感的。
3.2 使用ViewHelper
要向给定的字符串(例如标题)添加可选断词,请使用HyphenateViewHelper
。
示例
<html data-namespace-typo3-fluid="true"
xmlns:f="http://typo3.org/ns/TYPO3/CMS/Fluid/ViewHelpers"
xmlns:h="http://typo3.org/ns/NeuesStudio/HyphenDictionary/ViewHelpers">
<h:format.hyphenate content="{data.header}" />
or
<h:format.hyphenate>{data.header}</h:format.hyphenate>
or
{data.header -> h:format.hyphenate()}
</html>
您可以使用minWordLength
参数定义只有长度等于该参数的单词才进行连字符化。