Rozdíly

Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.

Odkaz na výstup diff

Obě strany předchozí revize Předchozí verze
Následující verze
Předchozí verze
skoda-ep:skoda-storyboard:related-content-translation [31.05.2021 08:53]
Lukáš Čech [How translation works]
skoda-ep:skoda-storyboard:related-content-translation [31.05.2021 09:17] (aktuální)
Lukáš Čech [Caveats]
Řádek 20: Řádek 20:
 MASTER localizations will try to keep the related content synchronized between each other. 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**. MASTER localizations will try to keep the related content synchronized between each other. 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**.
  
-SECONDARY 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.+SECONDARY localizations will stay IN SYNC with MASTERunless ​manually adjusted (something is added that is missing in MASTER localization or something is removed ​that is present in MASTER localization). When manually adjustedrelation to the selected content ​will be marked as **customized**. Below is a table of use-case scenarios to better understand how this process works. Even if some connections are customized, ​the rest of the connections ​will try to stay IN SYNC; however the customized ​connections will never synchronize ​again.
  
-==== Missing content ​gets localized ====+==== Content ​gets localized ​- connects automatically ​====
  
-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 SECONDARY localizations.+Once one of the related posts is translated and becomes available in that localization,​ it will be automatically added to the related content ​of other articles that reference its origin translation. This is true for both MASTER and SECONDARY localizations. Refer to the tables below to better understand this process. In short: if you create a 3 new articles in english, connect them together and then translate these articles to czech/​slovak etc., all the articles will be connected between each other (unless you manually disconnect them).
  
  
Řádek 48: Řádek 48:
 ==== New connection is added in MASTER localization ==== ==== 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.+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; however Article EN-5 has no translation in Serbian.
  
 Status: Status:
Řádek 72: Řádek 72:
 ==== Connected article is translated in SECONDARY localization ==== ==== Connected article is translated in SECONDARY localization ====
  
-Serbian localization decides to translate Article EN-2 as Article SR-2+Serbian localization decides to translate Article EN-2 as Article SR-2. It is automatically connected from Article SR-1.
  
 Status: Status:
Řádek 83: Řádek 83:
 ==== New connection is added in SECONDARY localization ==== ==== New connection is added in SECONDARY 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.+Serbian localization creates new Article that only exists in their localization called Article SR-ONLY and adds it to connection. They also want to add Article SR-3 back, even though the MASTER language removed it.
  
 Status: Status:
Řádek 94: Řádek 94:
  
  
-**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.**+**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 ​on Serbian localization.**
  
 ==== Existing connection is removed in SECONDARY localization ==== ==== Existing connection is removed in SECONDARY localization ====
Řádek 110: Řádek 110:
 **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.** **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.**
  
 +===== Caveats =====
  
 +There are some edge-cases that are not covered by the functionality that include a combination of actions taken by editor that are problematic to solve.
  
 +One of the examples is the following scenario.
 +
 +User has a relation defined as follows:
 +
 +^  ^ Article English 1 ^ Article Serbian 1 ^ Synchronizing between localizations ^
 +^ Connected to | Article English 2 | Article Serbian 2 | ✅ |
 +
 +Then removes Serbian article 2:
 +
 +^  ^ Article English 1 ^ Article Serbian 1 ^ Synchronizing between localizations ^
 +^ Connected to | Article English 2 |  | ❌ |
 +
 +Then completely deletes Article Serbian 2 from the administration
 +
 +The connection now becomes synchronized again, because the removed post no longer exists:
 +
 +^  ^ Article English 1 ^ Article Serbian 1 ^ Synchronizing between localizations ^
 +^ Connected to | Article English 2 |  | ✅ |
 +
 +Then creates the localization of Article English 2 again:
 +^  ^ Article English 1 ^ Article Serbian 1 ^ Synchronizing between localizations ^
 +^ Connected to | Article English 2 | Article Serbian 2 | ✅ |