It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Is there a good way to publish documentation in different languages?

Sleepy Dec 13, 2011

Hi,

we are considering Confluence as a tool for managing our end-user documentation. Today we use Word and that tends to get a bit inefficient. We want to devide the document into smaller subsections and our thought was that we would like to keep track if anything major was changed in the master documentation that should also be translated into the localized versions of the documnet.

Best Regards

Daniel

6 answers

1 accepted

2 votes
Answer accepted
Andrei [errno] Dec 13, 2011

Confluence would be the right tool then.
Few pointers:

  • create separate spaces per language
  • translators "watch" default langiage space for updates and when notified - update their language
  • have a separate space for inclusion library / images, etc - and source images from there, so changes are automatically replicated for all langiages
3 votes
_ bronoman May 09, 2012

Daniel:

I'm struggeling with the same question. Even though I like the thoughts behind webwesens answer, I'm not sure if this will fly with my users...

Furthermore, I could not find any mechanisms to synchronize pages and structures in multiple spaces...

So, here are a few thoughts on using multiple languages on a single wiki page:

  • horizontal split: use headers, sections and/or horizontal rules
  • vertical split: use sections/columns
  • vertical split: use tables
  • overlay: use decks and cards (a.k.a. tabs)
  • quick and dirty fix: let google do the work for you

Google translate button:

{html}
<div id="google_translate_element"></div><script>
function googleTranslateElementInit() {
  new google.translate.TranslateElement({
    pageLanguage: 'en'
  }, 'google_translate_element');
}
</script><script src="//translate.google.com/translate_a/element.js?cb=googleTranslateElementInit"></script>
{html}

regards,

bronoman

Joerg Bencke May 10, 2012

Hi bronoman,
1) synchronizing structures would mean
a) to use a "copy" plugin to copy subtrees, if that does not happen so often. You could use the "recent changes" function to follow up on that.
b) use a word file for the filestructures and import the wordfile into the various spaces.


2) You might want to rethink the "all languages in one page" thought. Imagine you hav 3 languages in a page and have noone who can do all of them. That will break usual editing-workflows in three ways :
a) Now, if you have people working on the article, they might work on the same page at the same time. They would have to "merge" changes all the time.
b) "watch notifications" wont work because all the time different people do different stuff in there.

c) reviewing, reediting, rereviewing, signing off ... for each language, will create extra traffic, versions and change-logs.

Now imagine you have more than three ....

Wilfrid (old) Nov 18, 2013
  • overlay: use decks and cards (a.k.a. tabs)

Hi bronoman,

How do you create tabs in Confluence?

3 votes

Hallo Daniel and all

There's a plugin called the "Language plugin" by BitVoodoo that will do what you want:

http://www.bitvoodoo.ch/plugins/confluence-language-plugin.html

https://plugins.atlassian.com/plugins/ch.bitvoodoo.confluence.plugins.language

I haven't used it, but I've heard good things about it. I hope this is helpful.

Cheers, Sarah

1 vote
Joerg Bencke May 10, 2012

Hi again, some "own" answers :)

for one approach for few languages - check out Jodie Miners blog about using builder-show functions to manage multiple contents. This way, you can keep multiple languages on one page and extract the correct language for each "output channel". (http://jodiem.com.au/2011/10/20/creating-word-documents-from-confluence/)

for another, how about the following structure

mainarticle (tag=lang_en)

+ childarticle "mainarticle_translations (tag=workpage)

+ translation1 (tag=lang_fr)

+ translation2 (tag=lang_fr)

+ translation3 (tag=lang_fr)

+ other children pages as sub-mainarticles (tag=lang_en)

This way, you have separate pages, but one hierarchy. Using the tag-filter, e.g. for scroll-office, you can still say "Give me the doc for "lang_de" - You will get the hierarchy of pages identical to all the rest, but only the german pages.

0 votes
Simeon Cheeseman Oct 24, 2018

We've had issues with Service Desk and Confluence Cloud support for multilanguage that can't be solved by any cloud add-on we could find. We have opened tickets about it linked below and would appreciate the support if you agree.

Server: https://jira.atlassian.com/browse/CONFSERVER-57384

Cloud: https://jira.atlassian.com/browse/CONFCLOUD-64788

Suggest an answer

Log in or Sign up to answer
This widget could not be displayed.
This widget could not be displayed.
Community showcase
Published in Confluence

Confluence CVEs and common questions

Two vulnerabilities have been published for Confluence Server and Data Center recently: March 20, 2019 CVE-2019-3395 / CVE-2019-3396 April 17, 2019 CVE-2019-3398 The goal of this article is...

970 views 0 19
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you