README

许可证: GNU GPL, 版本 2

仓库: https://gitlab.sgalinski.de/typo3/lfeditor

请在此处报告错误: https://gitlab.sgalinski.de/typo3/lfeditor

关于

lfeditor 是一个用于在 .xlf、.xml 和 .php 文件中添加、编辑和删除翻译的 GUI。

XML 和 PHP 文件可以转换为 .xlf 文件。

编辑器可以在 TYPO3 后端的 用户工具部分 中找到（点击顶部面板中的用户，然后选择 LFEditor）。

配置

扩展设置

在扩展管理器中，您可以配置 lfeditor 扩展的以下设置

查看语言

在扩展中将可用的语言的列表（以逗号分隔的国家代码，例如 en, de, fi）。

如果此设置为空，则将使用所有语言（警告：列表非常长！）默认语言始终包括在内。

默认语言

如果 en 不是 TYPO3 后端的默认语言，则必须在此处定义默认语言。如果此字段为空，则使用英语作为默认语言。

忽略扩展

可以用于通过扩展密钥排除扩展的正则表达式。

更改 XLF 日期

如果设置为 TRUE，LFEditor 将在每次更改时更改文件中的日期。

扩展设置

在编辑非管理员后端用户时，在 访问权限 选项卡的最底部有一个附加选项。现在您可以选择 用户可以直接将本地化更改保存到扩展中？。

未选中此复选框的默认后端用户将在覆盖模式下，并且他们不能切换到其他模式。

使用方法

菜单

通过选择屏幕左上角下拉菜单中的一个选项来通过 LFEditor 进行主要导航。

常规

此选项显示有关所有语言的一般信息。

显示的语言应在 LFEditor 的配置部分中进行配置，因为 LFEditor 管理员默认行为是显示 TYPO3 的所有现有翻译语言。而非管理员用户只能看到他们有权访问的语言。

除语言快捷方式外，还有相关语言文件的状态和来源。点击任何语言快捷方式将重定向到该语言的 编辑文件 <edit-file-reference> 页面。

“状态”列显示翻译状态，包含翻译、未知和未翻译的语言常量的数量。未知常量是在语言中存在但在默认语言中不存在的常量。

在页面底部，有一些转换和拆分语言文件的选项。这些选项在覆盖模式下不会显示，并且无法合并您的文件。拆分语言文件可以提高后端和前端的性能。还有一个字段集允许编辑语言文件中的元信息。

编辑文件

此选项允许编辑语言文件中选定语言的所有常量。用户可以在翻译、未翻译、未知或所有常量之间进行选择。

整个对话框由会话处理。这意味着用户可以翻译整个页面，在点击“下一步”按钮获取下一个包含语言常量的页面之前不需要保存更改。

编辑常量

此选项用于将单个常量翻译成多种语言。可用的语言取决于用户的语言权限和配置的“视图语言”。

添加常量

此选项用于向语言文件中添加新的常量。用户需要输入新名称，并可以直接输入所选语言的翻译。

删除常量

此选项允许用户删除所选常量。常量将从所有语言中删除。

重命名常量

此选项用于重命名现有语言常量的键。从选择列表中选择要重命名的常量，然后在文本字段中输入新名称。

搜索常量

此选项允许用户在所有语言文件中搜索常量。

• 在键或值（翻译）中查找与搜索字符串匹配的常量。
• 匹配可以是大小写敏感或不敏感。
• 支持正则表达式。
• 仅在“lfeditor”扩展配置中定义的语言子集中搜索。

点击任何搜索结果的常量键，将重定向到“编辑常量 <edit-constant-reference>”页面。

查看树

此选项用于更好地查看和访问常量。它显示按树形排列的语言文件中的所有常量。

常量作为树的叶子显示，并且它们用三种颜色表示所选语言（第一个选择框中的语言）的每个常量的翻译状态。

常量与第二个选择框中的语言进行比较，产生三种状态

• 绿色 - 正常常量（两种语言都翻译了）
• 红色 - 未翻译的常量（只翻译了第二种语言）
• 蓝色 - 未知常量（只翻译了第一种语言）

点击树叶（常量键的最后部分）将重定向到“编辑常量 <edit-constant-reference>”页面。

管理备份

备份选项显示所选扩展的所有备份。可以恢复每个备份、删除它们或仅查看差异。用户还可以撤销文件拆分和合并。

文件格式转换不可撤销.

如果语言文件已转换为其他格式，备份表条目中将有红色警告，并且该备份只能被删除。

通过“差异”功能可以查看自备份以来的所有更改。绿色表示常量已被添加，红色表示自备份以来已被删除。

编辑模式

有三个编辑模式

• 扩展模式
• l10n模式
• 覆盖模式

可以从屏幕顶部的最右侧选择菜单中选择它们。该选择菜单仅对管理员可见。

如果用户不是管理员，则默认选择覆盖模式。对于管理员，默认是扩展模式。

扩展模式

此模式对扩展开发者很有用，因为在此模式下，lfeditor直接编辑扩展文件。即使扩展文件在l10n文件夹中有副本或扩展文件被覆盖，lfeditor也只会编辑扩展文件。

l10n模式

此模式与扩展模式类似，唯一的区别是l10n目录比扩展目录具有更高的优先级。这意味着如果l10n文件夹（例如，de.locallang）中有语言文件的副本，则将编辑该副本而不是原始扩展文件。如果没有在l10n文件夹中找到对应的文件，则编辑原始文件。

以下是l10n模式的一些特征

• 文件不能移动到本地化文件夹。如果它们已经存在于本地化文件夹中，则可以编辑
• 在本地化模式下不允许合并/拆分
• 常量重命名将同时在主语言文件（例如ext/.../locallang）和所有子文件中的本地化文件夹（例如l10n/.../de.locallang）以及ext文件夹中进行重命名
• 删除和添加文件的工作方式与重命名类似

覆盖模式

此模式的目的在于使翻译不受扩展更改的影响（例如，当扩展更新时，翻译将被保留）。此模式对翻译人员很有用，并且是非管理员用户可用的唯一模式。

• 如果用户对语言文件进行任何更改，则仅更改的常量（或元数据）将保存在对应语言文件中的typo3confLFEditorOverrideFiles
• 读取语言文件时，LFEditor首先读取覆盖文件夹中的文件中的常量，然后读取本地化文件夹中的其余常量（如果本地化文件夹中有对应文件），然后从ext文件夹中读取（如果没有在本地化文件夹中找到文件）。

关于切换到typo3/cms-composer-installers v4的说明

如果您切换到新的composer安装程序，您必须将您的覆盖文件夹重命名为使用"-"代替"_"，因为命名方案不同。