ibexa

Path

ez publish / technical manual / 4.x / features / multi-language / working with translations


Caution: This documentation is for eZ Publish legacy, from version 3.x to 5.x.

Working with translations

This part of the 4.x documentation is for eZ Publish 4.0, only reference section is common for all eZ Publish 4.x versions as well as eZ Publish 5.x "LegacyStack", please select the version you are using for the most up to date documentation!

You can use the translations window to view the languages that the object exists in. The following text reveals how you can create, edit and remove the object translations.

Editing a translation

All content editing is done through the object edit interface. This interface will automatically be displayed whenever you're editing existing or creating new objects. If an object exists in several languages then you can choose which translation to edit. The following text reveals how you can edit a translation using different approaches.

Using the translations window

  1. Use the administration interface to navigate to the object that you wish to edit. In other words, make sure that the object is being displayed.
  2. Enable the translations window and locate the language that you wish to edit. Click on the language's corresponding edit icon (on the right hand side). The system will bring up the edit interface.

Using the "Sub items" window

  1. Use the administration interface to navigate to the node/object which contains the one that you wish to edit. In other words, make sure that the parent node is being displayed.
  2. Look at the "Sub items" window and locate the node/object that you wish to edit. Click on the node's corresponding edit icon (on the right hand side). You will be taken to the language selection interface which is described below.
  3. Use the radio buttons located in the "Existing languages" frame to select the language that you wish to edit and click the "Edit" button. The system will bring up the edit interface.

The language selection interface

The language selection interface (full or reduced) appears when you have to choose which translation you wish to edit or create. The following screenshot shows the language selection interface for a folder that exists in English and French languages.

The language selection interface.

The language selection interface.

As you can see from the screenshot above, the language selection radio buttons are divided into two groups. The "Existing languages" group contains the languages that are already used by the object. This list makes it possible to select an existing translation for editing. The "New languages" group contains a list of the translation languages that are not used by the object. The latter makes it possible to translate the contents of the object into a language that it does not exist in yet. When adding a new translation, it is possible to choose which existing translation it should be based on. You can select one of the existing languages or "None". When a language is chosen instead of "None", the main part of the edit page will contain translation interface instead of the standard edit interface.

Using the tree menu and the context menu

  1. Use the tree menu on the left to locate the object that you wish to edit.
  2. Click on the object's icon in order to bring up the context menu.
  3. Access the "Edit in" submenu and select the language that you wish to edit as shown in the following screenshot.

    The context menu.

    The context menu.


    The screenshot above shows the content structure pop-up menu for a folder that exists in English and French. After selecting a language, the system will display the edit interface.

Using the "Edit" button

  1. Use the administration interface to navigate to the node (page) that you wish to edit. In other words, make sure that the node is being displayed.
  2. Use the drop-down list of languages located in the preview window to select the language that you wish to edit and click the "Edit" button (look at the next screenshot).

    Selecting the language for editing.


    The system will bring up the edit interface.

Using the bookmarks

  1. Make sure that your bookmarks are being displayed (use the "+" sign to open the window).
  2. Locate the object that you wish to edit and click on its icon to bring up the context menu.
  3. Access the "Edit in" submenu and select the language that you wish to edit. The system will bring up the edit interface.

Editing multiple languages

It is possible to edit two or more translations/languages of the same object. Internally the system actually edits two or more versions of the same object. A draft only contains object attribute data for one language. When the draft is published, the system will copy all other languages from the previously published version. The following screenshot shows how the draft list interface looks like when the user is editing three translations of the same article (this interface can be accessed by clicking the "My account" tab and selecting the "My drafts" link on the left).

The "My drafts" interface.

The "My drafts" interface.

The translations of the same object can be created and edited separately and simultaneously by multiple users (a user only edits one version and language at a time).

Adding a new translation

You can translate the objects into any of the translation languages using the administration interface. The following text reveals how you can translate an object using different approaches.

Using the "Sub items" window

  1. Use the administration interface to navigate to the node/object which contains the one that you wish to edit. In other words, make sure that the parent node is being displayed.
  2. Look at the "Sub items" window and locate the node/object that you wish to edit. Click on the node's corresponding edit icon (on the right hand side). You will be taken to the language selection interface. Select the desired parameters in the "New languages" frame and click the "Edit" button. The system will bring up the edit interface.

Using the tree menu and the context menu

  1. Use the tree menu on the left to locate the object that you wish to edit.
  2. Click on the object's icon in order to bring up the context menu.
  3. Access the "Edit in" submenu and select the "Another language" item. You will be taken to the reduced language selection interface. It contains a list of languages in which the object does not exist (look at the following screenshot) and a list of languages that the new translation can be based on.

    The reduced language selection interface.

    The reduced language selection interface.


    Select the language that you wish to add and optionally one of the existing languages to be used as original text during translation. After the "Edit" button is clicked, the system will bring up the edit interface.

Using the "Edit" button

  1. Use the administration interface to navigate to the object that you wish to edit. In other words, make sure that the object is being displayed.
  2. Select the "Another language" item from the drop-down list of languages which is located in the preview window and click the "Edit" button. The system will display the reduced language selection interface (described above). Select the desired parameters and click the "Edit" button. The system will bring up the edit interface.

Using the bookmarks

  1. Make sure that your bookmarks are being displayed (use the "+" sign to open the window).
  2. Locate the object that you wish to edit and click on its icon to bring up the context menu.
  3. Access the "Edit in" submenu and select the "Another language" item. The system will display the reduced language selection interface (described above). Select the desired parameters and click the "Edit" button. The system will bring up the edit interface.

Svitlana Shatokhina (21/07/2006 2:27 pm)

Ricardo Correia (17/04/2013 1:50 pm)

Svitlana Shatokhina, Balazs Halasy, Ole-Morten Halvorsen, Ricardo Correia


Comments

  • and in PHP?

    Hi!

    And is there anywhere some help on how to do that using PHP?

    Thanks!