nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

How do I manage pages with content in multiple languages?

Joachim Straub

Hello,

we use Confluence together with Refined.

We would like to

display the content of a page in multiple languages and
allow the user to change the language of the content by a click

Thus, I have installed the macro "Translations for Confluence". In Confluence, this works fine. However, Refined does not support this macro.

Is there any possibility to handle multiple language content without having to create a separate page for each language? I want to avoid this since this can get confusing.

Thanks for your help,
Joachim

Accepted answers

All comments

Kristian Klima_gtcuat

Hi @Joachim Straub and welcome to the Community.

When it comes to

displaying localized content
in a public documentation site
that's Confluence based
but doesn't look like Confluence

you have only one option as far as I know.

Using a suite of Confluence apps by K15t (they're based in Stuttgart).

Scroll Documents - it's a content management tool that allows you to manage your confluence pages and spaces in a much more detailed way. It also supports proper versioning, conditional content, etc.
Translations for Scroll Documents - it does what it says on the tin. It creates a localized versions of your Confluence pages, supports XLIFFs files and all the usual translation workflows.
Then you need Scroll Viewport to create a public website from your Confluence (via Scroll Documents) that allows for seamless switching between individual language versions.

Examples of the solution:

https://docs.pay-me.com/?l=en

Scroll down for language swicher. It works really well - when you're switching languages on a specific page, you will remain on that page. https://docs.pay-me.com/en/magento/v3.0.9/instalacion-y-activacion

Now... Viewport is a competitor of Refined. But unlike Refined, Viewport does not require you to enable anonymous access to your Confluence spaces and is designed to work with advanced features of other Scroll apps.

This is my company doc site built with VIewport. I used the Scroll Translations in the past so feel free to ask questions.

Disclaimer: I do not work for K15t.

Mattia _Elevatic_

Hello Joachim,

Thank you for using our Translations app.

Refined offers the option to display the pages as in native Confluence.

This view supports 3rd party apps' content. In the case of Translations, the last selected language in Confluence will also be used for the Refined content view. Unfortunately it is not possible for us to display the language switcher in this Refined view.

For your users this means, when they visit the content on Refined and they want to switch the language, they need to open the Confluence page (there is a direct access to the Confluence page in Refined interface) and switch the language.

This solution may not be ideal if your users actually have to change languages frequently.
If you have any questions about this, please contact our support team.

Kind regards,

Mattia

Joachim Straub

Thanks for your information, Kristian.

If I understand you correctly, I cannot use Translations for Scroll Documents together with Refined. Is this correct?

I do not know whether this option is feasible for me, since I cannot decide myself to do without Refined. This has to be discussed with other stakeholders.

Joachim Straub

Hi Mattia

Thank you very much for clarifying the available options.

We use Confluence + Refined for our customer support portal. The customers who log on to the portal do not know anything about Confluence. To them, it appears as normal web page. Thus, the solution to go to Confluence and switch the language does not work.

Mattia _Elevatic_

Thank you for getting back to me @Joachim Straub

For users who are not logged in or do not have Confluence permission, the rules are the same as for "Anonymous users" on Confluence. The only difference is that direct language change is also not possible. At best, the user would have to change the browser language.

An alternative would be manually creating separate spaces and pages for each language. Some apps in the marketplace create and translate individual pages per language if you do not want to do and maintain this manually.

Your Refined portal visitors can navigate to the corresponding space to access their preferred language or switch language.

Kind regards,

Mattia

Kristian Klima_gtcuat

That is correct, Joachim.

Refined can only work with content on the space level. Scroll Documents can, for the lack of better word, create virtual space-like entities. It can be a section of a space, sections of multiple spaces, versions of spaces, and... virtual translated spaces.

Refined cannot tap into these virtual spaces. Viewport is designed to work with them.

Joachim Straub

Hi Mattia,

thanks again.

When using the solution with separate spaces and pages for each language, I see the following issues:

Increase in number of pages

Currently, our content published in 2 languages, i.e., English and German., Thus, the number of pages should be manageable. However, if our content is translated into 4, 5 or more languages, the number of pages would increase very rapidly.

Missing option to control that source and translations are in synch

If you modify the source page, you are not informed that this modification has to be translated into the target languages (on separate pages in separate spaces). There is no connection between source content and translated content.

It is true that Confluence is no translation memory system.

However, if source and translations are on one single page, at least you are "visually" reminded not to forget the translations in case you modify the source.

So there is one bitter pill to swallow I guess ;-)

Best regards,

Joachim

Lotje Euser_nobmhc

hi Joachim,

Lotje here from Refined. I came across your issue and we do offer a multi-language site solution, which I'd love to share with you on a call.

Feel free to schedule a call with me here.

Best regards,
Lotje

Sussi Åström

Hi @Lotje Euser

If I am not mistaken, the multi-language site solution, is only available in DC?

Like Joachim we use Confluence with Refined and have had to create two separate spaces to enable documentation to our customers in Finnish & Swedish.

@Joachim Straub I've tried the Scroll Document apps that @Kristian Klima stated in his comment, and opted not to go down that route, as we would not have been able to keep the two separate spaces, and did not wish to go through the manual work of trying to combine into one. The other was that we also have Refined for JSM, which gives us both Confluence and JSM under one custom url. Scroll Viewport does not, or at least did not when I tried it.

Kristian Klima_gtcuat

Hi @Sussi Åström

Scroll Documents (Translations for Scroll Documents) only need one space.

Lotje Euser_nobmhc

hi @Sussi Åström ,

thanks for your question! This solution with Refined is also available on Cloud.

Kind regards,
Lotje

Welcome!

It looks like you're new here. Sign in or register to get started.

Quick Links

Find more posts tagged with

confluence

cloud

confluence-cloud