Toto je starší verze dokumentu!
Translation of related content
Some posts have relations to other content, such as other posts, series and such.
These are connected using a multiselect field with searching capability:
IMPORTANT NOTE:
If you translate an article/post which has related content, it is possible that your localization will NOT HAVE all the related content translated into your language. Therefor this related content is shown in your language as empty as seen in the following image:
These empty lines cannot be removed.
How translation works
It is important to note that we differentiate between master localizations and other localizations. Please read the article about the differences to understand further references to master/other localizations.
Master localizations will try to keep the related content synchronized. If the content is missing in one of the master localizations, it will be connected after the localized version is created. This results in master localizations being ALWAYS IN SYNC as long as the content exists in that localization.
Other localizations will being IN SYNC, but if manually adjusted (something is added that is missing in Master localization or something is manuallt removed), these connections will become customized. Below is a table of use-case scenarios to better understand how this process works. Even then the related content will try to stay IN SYNC, but those connections that were manually adjusted will never synchronize in the future.
Missing content gets localized
Once one of the related posts is translated and becomes available in that localization, it will be automatically added to the related content. This is true for both MASTER and OTHER localizations.
Scenarios
Following examples define how the connection works when it is adjusted either from the master localization or other localizations.
Lets consider a case, where we have Article EN-1, Article EN-2, Article EN-3 and Article EN-4.
Two articles had been localized into Serbian as Article SR-1 and Article SR-3.
Article EN-1 has a relation to Article EN-2, Article EN-3 and Article EN-4
The current status of the related content is shown in the following table:
Article EN-1 | Article SR-1 | Synchronizing between localizations | |
---|---|---|---|
Connected to | Article EN-2 | ✅ | |
Connected to | Article EN-3 | Article SR-3 | ✅ |
Connected to | Article EN-4 | ✅ |
New connection is added in master localization
Article EN-1 is newly connected to 2 more articles: Article EN-5 and Article EN-6. Article EN-6 has existing localization in Serbian language as Article SR-6.
Status:
Article EN-1 | Article SR-1 | Synchronizing between localizations | |
---|---|---|---|
Connected to | Article EN-2 | ✅ | |
Connected to | Article EN-3 | Article SR-3 | ✅ |
Connected to | Article EN-4 | ✅ | |
Connected to | Article EN-5 | ✅ | |
Connected to | Article EN-6 | Article SR-6 | ✅ |
Existing connection is removed from master localization
Then we decide to remove Article EN-3 and Article EN-4 from the connection
Status:
Article EN-1 | Article SR-1 | Synchronizing between localizations | |
---|---|---|---|
Connected to | Article EN-2 | ✅ | |
Connected to | Article EN-5 | ✅ | |
Connected to | Article EN-6 | Article SR-6 | ✅ |
Connected article is translated in other localization
Serbian localization decides to translate Article EN-2 as Article SR-2
Status:
Article EN-1 | Article SR-1 | Synchronizing between localizations | |
---|---|---|---|
Connected to | Article EN-2 | Article SR-2 | ✅ |
Connected to | Article EN-5 | ✅ | |
Connected to | Article EN-6 | Article SR-6 | ✅ |
New connection is added in other localization
Serbian localization creates new Article that only exists in their localization called Article SR-ONLY and add it to connection. They also want to add Article SR-3 back, even though the master language removed it.
Status:
Article EN-1 | Article SR-1 | Synchronizing between localizations | |
---|---|---|---|
Connected to | Article EN-2 | Article SR-2 | ✅ |
Connected to | Article SR-3 | ❌ | |
Connected to | Article EN-5 | ✅ | |
Connected to | Article EN-6 | Article SR-6 | ✅ |
Connected to | Article SR-ONLY | ❌ |
IMPORTANT NOTE: Because the Serbian connections now become customized, they are partially disconnected from master localizations. Because Serbian version now added Article SR-3 as their choice, adding or removing Article EN-3 in the master localization will no longer have any effect.
Existing connection is removed in other localization
Serbian localization decides to remove one of the articles they have translated: Article SR-6.
Status:
Article EN-1 | Article SR-1 | Synchronizing between localizations | |
---|---|---|---|
Connected to | Article EN-2 | Article SR-2 | ✅ |
Connected to | Article SR-3 | ❌ | |
Connected to | Article EN-5 | ✅ | |
Connected to | Article EN-6 | ❌ | |
Connected to | Article SR-ONLY | ❌ |
IMPORTANT NOTE: Just as with the previous case, where Serbian localization added articles, ARTICLE SR-6 now also becomes customized. This means that any changes in master localization to Article EN-6 will no longer have any effect on Article SR-6.