Versions Compared

Old Version 32

changes.mady.by.user Harshitha Udayashankar (Inactive) (Deactivated)

Saved on

compared with

New Version Current

changes.mady.by.user Harshitha Udayashankar (Inactive) (Deactivated)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Image Removed


Warning

After careful consideration, Language Switch for Confluence will be retired and archived on the Atlassian Marketplace on August 25, 2023. Current customers and evaluators were informed of this change on May 25, 2023. Please contact our support team if you have any questions.



The Language Switch for Confluence helps  allows you to manage multiple versions of pages and spaces using with a single switch button.

Features (tick)

  • Use the new Language Switch Wizard (v3) to link or create
new page
  • pages with
related
  • similar content or structure
,
  • so that the app can
recognize
  • recognise and link the
equivalent
  • corresponding pages.
Or you
  • You can
use
  • also go the traditional
way using
  • route and use a page label to link to the
corresponding
  • appropriate page language.
  • The
switch buttons let you shift
  •  Switch Buttons make it easier to switch from one page/space version to another
more efficiently
  • . These can be freely
placed
  • positioned in
different
  • many predefined Confluence locations
of Confluence
  • or easily configured using CSS.
  • Avoid the hassle
of
  • of manually recreating similar Confluence pages/spaces and searching for its other related versions
by installing Language Switch
  • . The page label
informs you of
  • indicates which version of the page or space you are in and
allows
  • helps you to create or
find
  • locate sibling pages or related versions of the original page.

Get started

Concept

Language Switch operates on

2

two concepts:

  • The Switch buttons
that
  • will display all versions of a page or a space you have created and would like to manage.
  • The Language Switch
Wizard
  •  wizard (v3) or Confluence labels you attach to each page or space version that indicate both the relationship and
difference
  • differences amongst areas.

Label definition

Use the new Language Switch Wizard (v3) to link or create new pages which automatically creates page labels seamlessly.

The Language Switch is using Confluence labels to identify the language of the page and the related pages in other languages.

This example provides a simple How-To Guide to create 2 related Pages with 2 configured Languages.

First, we configure the space to support two languages, in this case English (en) and German (de).

Navigate to General configuration -> Section: Look and Feel -> Language Switch and create the Space Configuration as follows:

Image Removed

Then, for English (en) and German (de), we create or use two existing Spaces and configure the Default Language for each.

Navigate to Space → Space Tools → Section: Look and Feel → Langue Switch and configure the corresponding Language for the Space as follows:

Image Removed

The Language Switch can be found in the Header Toolbar if you navigate to any Pages in a Space.

Image Removed

You can customize the position of the buttons perfectly integrated into the Confluence look and feel.

Image Removed

Perform the following steps to create two related Pages with two different configured Languages:

  1. Set Default Global Space Configuration: To configure go to General configuration > Language Switch. For more information, see Configuration.

Image Added

       2. Set Default Configuration in Space Level: To configure go to Space Tools > Look and Feel > Language Switch. For more information, see Configuration.

Image Added

       3. Configure Pages for Language Switch.

Configure Pages for the Language Switch

Language Switch offers two methods for creating language pages:

  • To simplify and streamline the corresponding language pages, use the Language Switch
Wizard
  •  wizard, which was introduced in Version 3.0.
  • Using Page Labels:
this
  • This is the traditional method for linking the corresponding language to the page. This gives you complete control over the label naming.
For example, we will create Product Pages in both German and English.


Configure Pages Using Language Switch Wizard (v3)

First we prepare the English Page

Perform the following to configure pages using Language Switch wizard:

  1. Create the new
Page Products
  1. page in the English Space or you can choose existing page.
  • Open the Language Switch wizard.

    • Image Removed

    Then we use the Language Switch Wizard to create the German Draft Page based on the English Page Version

    1. Click the + button on the German row.
    2. Search for the Location in the German Space where the new Draft Page should be created.
    3. Click the Create button to create the new Draft Page based on the english Products Page. This will automatically open the confluence Editor.

    For the full functionality of the Language Switch Wizard, check out the Documentation.

    Image Removed

    Image Removed

    Using page Labels

    We will use as Page Identifier products.

    Perform the following to prepare an english Page:

    1. Create a new Page Products
    2. Add a Label page_products_en to mark this Page as Language English with Page Identifier products.

    Then, perform the following to create german Page:

    1. Create a new Page Produkte
    2. Add a Label page_products_de to mark this Page as Language German with Page Identifier products.

    Image Removed

    Image Removed

    Check-out more Use Cases

    Image Added

          2. Click …> Language Switch. The Corresponding Language Pages window is displayed.

    Info
    titleNote

    You need to configure the languages in the Global Configuration. For more information, see Configuration.

                               

    Image Added

          3. Click + icon and specify the Location of the draft page.

    Image Added

          4. Click the Create button. A new draft page is created and opened automatically.


    Using page Labels

    Perform the following to create label:

    1. Create a new page or to add label(s) to existing page go to Edit mode.

    Image Added.     2. Click the label icon.

          3. Type the name that you want to label the page. 

    Image Added

          4. (Optional) Click Add to add another label.

          5. Click Close.

    Info

    For example:

    To identify the pages with different language (English en, German de) with the name of the page as Products. The label can be specified as follows:

    • With Page Identifier products, add a Label page_products_en to mark this page as English.
    • With Page Identifier products, add a Label page_products_de to mark this page as language German.

    Check-out more Use Cases to better understand the power of Language Switch.

    Image Removed

    Image Added