Initial commit - Typo3 11.5.41
This commit is contained in:
Matteo Gallo
@@ -0,0 +1,13 @@
|
||||
.. ==================================================
|
||||
.. FOR YOUR INFORMATION
|
||||
.. --------------------------------------------------
|
||||
.. -*- coding: utf-8 -*- with BOM.
|
||||
|
||||
Add Constant
|
||||
------------
|
||||
|
||||
This option serves for adding new constants to language files.
|
||||
The user needs to enter a new name and translations for chosen languages can also be entered right away.
|
||||
|
||||
.. figure:: ../../Images/MainMenuOptions/AddConstant/AddConstant.png
|
||||
:alt: AddConstant
|
||||
@@ -0,0 +1,12 @@
|
||||
.. ==================================================
|
||||
.. FOR YOUR INFORMATION
|
||||
.. --------------------------------------------------
|
||||
.. -*- coding: utf-8 -*- with BOM.
|
||||
|
||||
Delete Constant
|
||||
---------------
|
||||
|
||||
This option allows user to delete a selected constant. The constant will be deleted from all languages.
|
||||
|
||||
.. figure:: ../../Images/MainMenuOptions/DeleteConstant/DeleteConstant.png
|
||||
:alt: DeleteConstant
|
||||
@@ -0,0 +1,15 @@
|
||||
.. ==================================================
|
||||
.. FOR YOUR INFORMATION
|
||||
.. --------------------------------------------------
|
||||
.. -*- coding: utf-8 -*- with BOM.
|
||||
|
||||
.. _edit-constant-reference:
|
||||
|
||||
Edit Constant
|
||||
-------------
|
||||
|
||||
This option serves for translating a single constant in several languages.
|
||||
Available languages depend of user language privileges and of the configured "view languages".
|
||||
|
||||
.. figure:: ../../Images/MainMenuOptions/EditConstant/EditConstant.png
|
||||
:alt: EditConstant
|
||||
@@ -0,0 +1,24 @@
|
||||
.. ==================================================
|
||||
.. FOR YOUR INFORMATION
|
||||
.. --------------------------------------------------
|
||||
.. -*- coding: utf-8 -*- with BOM.
|
||||
|
||||
.. _edit-file-reference:
|
||||
|
||||
Edit File
|
||||
---------
|
||||
|
||||
This option allows editing of all constants in a language file and a selected language.
|
||||
Users can choose between translated, untranslated, unknown or all constants.
|
||||
This whole dialog is handled by a session. This means that a user can translate a whole page and doesn't need to
|
||||
save the changes before clicking on 'next' button to get the next page with language constants.
|
||||
If the translation process is finished or user just wants to make a break, the changes should be saved.
|
||||
|
||||
Parallel editing is nice feature which allows editing two languages at the same time.
|
||||
It is triggered by selecting languages in both language selection lists in section "Select up to two languages".
|
||||
Section "Select reference language" allows user to chose which language will be used as reference for translating.
|
||||
Reference language translations are shown beneath each text box.
|
||||
|
||||
|
||||
.. figure:: ../../Images/MainMenuOptions/EditFile/EditFile.png
|
||||
:alt: EditFile
|
||||
@@ -0,0 +1,27 @@
|
||||
.. ==================================================
|
||||
.. FOR YOUR INFORMATION
|
||||
.. --------------------------------------------------
|
||||
.. -*- coding: utf-8 -*- with BOM.
|
||||
|
||||
.. _general-reference:
|
||||
|
||||
General
|
||||
-------
|
||||
|
||||
This option displays general information about several languages.
|
||||
Displayed languages should be configured in the configuration section of LFEditor,
|
||||
because default behavior of LFEditor for administrators is to displays all existing translation languages of TYPO3.
|
||||
While non-admin users see only languages which they have permissions for.
|
||||
|
||||
Beside the language shortcut, there is state and origin of the related language file.
|
||||
Clicking any language shortcut redirects to :ref:`Edit File <edit-file-reference>` page for this language.
|
||||
Column ‘state‘ shows the state of translation and contains number of translated, unknown and untranslated language constants.
|
||||
Unknown constants are the ones which exist in the language, and don’t exist in default language.
|
||||
|
||||
At the bottom of this page there are options for converting and splitting language files.
|
||||
Those options are not displayed in override mode and it is not possible to merge XLF files.
|
||||
Splitting of language files increases the performance of backend and frontend.
|
||||
There is also a field set which allows editing of meta information of language files.
|
||||
|
||||
.. figure:: ../../Images/MainMenuOptions/General/General.png
|
||||
:alt: General
|
||||
@@ -0,0 +1,38 @@
|
||||
.. ==================================================
|
||||
.. FOR YOUR INFORMATION
|
||||
.. --------------------------------------------------
|
||||
.. -*- coding: utf-8 -*- with BOM.
|
||||
|
||||
Main Menu Options
|
||||
-----------------
|
||||
|
||||
Main navigation through LFEditor is done by selecting one of the options of drop down menu (main menu)
|
||||
on top-left part of the screen (frame).
|
||||
Main menu options are described in following sections of this chapter.
|
||||
|
||||
.. figure:: ../Images/MainMenuOptions/MainMenu.png
|
||||
:alt: MainMenu
|
||||
|
||||
Page of each main menu option (except backup option) contains selection list of all available language files in typo3 CMS,
|
||||
sorted by belonging extension. First time opening the extension might take few seconds to find all the language files,
|
||||
but after that, the file list is cached and loading goes fast.
|
||||
If language files are added or removed (not by LFEditor) from TYPO3 CMS, user should flush general caches,
|
||||
to force LFEditor to read new list of language files.
|
||||
|
||||
After each "Save" operation, LFEditor will automatically clear language cache, so the changes can be visible immediately
|
||||
when user opens the page which uses changed language file.
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 2
|
||||
:titlesonly:
|
||||
:glob:
|
||||
|
||||
General/Index
|
||||
EditFile/Index
|
||||
EditConstant/Index
|
||||
AddConstant/Index
|
||||
DeleteConstant/Index
|
||||
RenameConstant/Index
|
||||
SearchConstant/Index
|
||||
ViewTree/Index
|
||||
ManageBackups/Index
|
||||
@@ -0,0 +1,22 @@
|
||||
.. ==================================================
|
||||
.. FOR YOUR INFORMATION
|
||||
.. --------------------------------------------------
|
||||
.. -*- coding: utf-8 -*- with BOM.
|
||||
|
||||
Manage Backups
|
||||
--------------
|
||||
|
||||
The backup option displays all backups of the selected extension.
|
||||
It is possible to recover every backup, delete them or just have a look at the differences.
|
||||
User can revert splitting and merging of files too. Conversions of the file format are not revertible.
|
||||
If language file was converted to other format, there will be red warning in status of the backup table entry
|
||||
and that backup can only be deleted.
|
||||
|
||||
All changes since the backup are visible trough 'differences' functionality.
|
||||
Green color means that the constant was added and red that it was deleted since the backup was made.
|
||||
Example at the bottom of this section shows that user have made changes in value of 'button.cancel' constant,
|
||||
and old value of the constant is shown. If restore is executed, that old value will replace current value
|
||||
(which is not visible in difference view of backup).
|
||||
|
||||
.. figure:: ../../Images/MainMenuOptions/ManageBackups/ManageBackups.png
|
||||
:alt: Manage Backups
|
||||
@@ -0,0 +1,13 @@
|
||||
.. ==================================================
|
||||
.. FOR YOUR INFORMATION
|
||||
.. --------------------------------------------------
|
||||
.. -*- coding: utf-8 -*- with BOM.
|
||||
|
||||
Rename Constant
|
||||
---------------
|
||||
|
||||
This option serves for renaming the key of existing language constant.
|
||||
Constant to rename is chosen from select list, and then new name is entered in text field.
|
||||
|
||||
.. figure:: ../../Images/MainMenuOptions/RenameConstant/RenameConstant.png
|
||||
:alt: RenameConstant
|
||||
@@ -0,0 +1,26 @@
|
||||
.. ==================================================
|
||||
.. FOR YOUR INFORMATION
|
||||
.. --------------------------------------------------
|
||||
.. -*- coding: utf-8 -*- with BOM.
|
||||
|
||||
Search Constant
|
||||
---------------
|
||||
|
||||
This option allows a user to search for constants in selected language files.
|
||||
|
||||
- Finds constants which match the search string within key or value (translation).
|
||||
- The matching can be case sensitive or insensitive.
|
||||
- Supports regular expressions.
|
||||
- Looks only among subset of languages which is defined in LFEditor configuration.
|
||||
|
||||
Clicking on constant key of any search result, redirects to :ref:`Edit Constant <edit-constant-reference>` page.
|
||||
|
||||
.. figure:: ../../Images/MainMenuOptions/SearchConstant/SearchConstant.png
|
||||
:alt: SearchConstant
|
||||
|
||||
Picture illustrates case sensitive search for string 'Cancel'.
|
||||
The search has found the string in 2 language constants:
|
||||
|
||||
- as value of button.cancel constant in default language,
|
||||
- as part of constant key of function.langfile.confirmCancel constant in default and in 'de' languages,
|
||||
since there is no more languages that contain translation for this constant key in this example.
|
||||
@@ -0,0 +1,23 @@
|
||||
.. ==================================================
|
||||
.. FOR YOUR INFORMATION
|
||||
.. --------------------------------------------------
|
||||
.. -*- coding: utf-8 -*- with BOM.
|
||||
|
||||
View Tree
|
||||
---------
|
||||
|
||||
This option serves for overview and easier access to constants.
|
||||
It displays all constants of language file arranged in a tree.
|
||||
Constants are displayed as leafs of the tree, and they are colored in three colors which indicate translation state
|
||||
of each constant for selected language (language from first select box).
|
||||
The state is calculated in same way like on :ref:`General <general-reference>` page. Constants are compared to language from second select box,
|
||||
resulting in three states:
|
||||
|
||||
- green - normal constant (translated in both languages)
|
||||
- red - untranslated constant (translated only in second language)
|
||||
- blue - unknown constant (translated only in first language)
|
||||
|
||||
Clicking on tree leaf (last segment of constant key) redirects to :ref:`Edit Constant <edit-constant-reference>` page.
|
||||
|
||||
.. figure:: ../../Images/MainMenuOptions/ViewTree/ViewTree.png
|
||||
:alt: ViewTree
|
||||
Reference in New Issue
Block a user