Translating whole Wiki pages in a CAT tool outside the Wiki

Discussions about the wiki documentation of FreeCAD and its translation.
Forum rules
Be nice to others! Respect the FreeCAD code of conduct!
User avatar
JoeKundlak
Posts: 54
Joined: Mon Oct 11, 2021 11:35 am

Translating whole Wiki pages in a CAT tool outside the Wiki

Post by JoeKundlak »

Hi folks,

as an avid CAT tool user I was wondering if any of the Wiki translators use a CAT tool for this process?

I mean for a given Wiki page extracting its whole english source code, pasting it into a file and loading it into a CAT tool, translating it and then pasting it by paragraphs back into the Wiki page (into the given language version).

The Wiki translation plugin is very bare-bones compared to a full-fledged CAT tool (like Crowdin, which we use for the FreeCAD app translation) and as the terminology is the same across the app and the Wiki, at least a Glossary would help keep the translations consistent across the whole environment. And by using a Translation Memory you could also reuse previous translations/sentences/phrases and save time.

I am not aware of any interface between a Wiki and a CAT tool, so I guess this would be manual work only... but I am planning to try it for the Slovak translation of the Wiki.
Joe
---------------------------------------------------
translating into SK: https://wiki.freecadweb.org
User avatar
Roy_043
Veteran
Posts: 8456
Joined: Thu Dec 27, 2018 12:28 pm

Re: Translating whole Wiki pages in a CAT tool outside the Wiki

Post by Roy_043 »

JoeKundlak wrote: Tue Nov 16, 2021 10:51 am Translation Memory
The Wiki software has that as well.
User avatar
JoeKundlak
Posts: 54
Joined: Mon Oct 11, 2021 11:35 am

Re: Translating whole Wiki pages in a CAT tool outside the Wiki

Post by JoeKundlak »

Perhaps internal yes, but does it have the ability to import an external TM?

As such the TMs for Crowdin and the Wiki exist separately, which introduces its own set of problems in terms of consistency.
Joe
---------------------------------------------------
translating into SK: https://wiki.freecadweb.org
User avatar
Roy_043
Veteran
Posts: 8456
Joined: Thu Dec 27, 2018 12:28 pm

Re: Translating whole Wiki pages in a CAT tool outside the Wiki

Post by Roy_043 »

JoeKundlak wrote: Tue Nov 16, 2021 11:11 amPerhaps
No, not 'perhaps', it is there.

JoeKundlak wrote: Tue Nov 16, 2021 11:11 am the ability to import
Don't know. Nobody currently involved with FreeCAD documentation seems to have an in-depth understanding of the Wiki software.

JoeKundlak wrote: Tue Nov 16, 2021 11:11 am consistency
That is a big problem in the Wiki. People are not good at consistency. And when you point out inconsistencies in their work, or ask them to follow the GuiCommand_model for the sake of Wiki consistency, they can be less than receptive (to put it mildly :mrgreen:).
User avatar
JoeKundlak
Posts: 54
Joined: Mon Oct 11, 2021 11:35 am

Re: Translating whole Wiki pages in a CAT tool outside the Wiki

Post by JoeKundlak »

Yeah... such an effort requires a dark overlord to manage and whip uncooperative people around 8-) A good example is the Slovak translation on Crowdin - there was nearly no Glossary established so far (and it will take some time still to fill it up) and thus even the word Sketcher had two translations throughout the text, used interchangeably.

Me not being a CAD-user I had to search for local terminology translations/dictionaries (luckily there is a Czech CAD forum with an extensive Glossary for AutoCAD, which is useful) and will slowly work on the base phrases for FreeCAD in Slovak.

I will check online some more reg. the Wiki Translate plugin, though I have a feeling its functionality is pretty much what I see while translating on the wiki itself...
Joe
---------------------------------------------------
translating into SK: https://wiki.freecadweb.org
User avatar
Roy_043
Veteran
Posts: 8456
Joined: Thu Dec 27, 2018 12:28 pm

Re: Translating whole Wiki pages in a CAT tool outside the Wiki

Post by Roy_043 »

Note I do not propose that layout is more important than content. But to those who think that the GuiCommand_model is a hindrance I would say that the opposite applies: organizing content in a similar manner actually helps authors, editors, and last but not least, the readers.
User avatar
JoeKundlak
Posts: 54
Joined: Mon Oct 11, 2021 11:35 am

Re: Translating whole Wiki pages in a CAT tool outside the Wiki

Post by JoeKundlak »

Indeed, I like the presentation on the Wiki very much! Keeps it clear and any image is a thousand words, so...
Joe
---------------------------------------------------
translating into SK: https://wiki.freecadweb.org
User avatar
JoeKundlak
Posts: 54
Joined: Mon Oct 11, 2021 11:35 am

Re: Translating whole Wiki pages in a CAT tool outside the Wiki

Post by JoeKundlak »

Is there a way to export the Slovak-English Glossary from Crowdin? I think only a Project owner/manager can do it...
Joe
---------------------------------------------------
translating into SK: https://wiki.freecadweb.org
User avatar
Roy_043
Veteran
Posts: 8456
Joined: Thu Dec 27, 2018 12:28 pm

Re: Translating whole Wiki pages in a CAT tool outside the Wiki

Post by Roy_043 »

JoeKundlak wrote: Tue Nov 16, 2021 11:11 am the ability to import
Not sure if this is helpful:
https://wiki.freecadweb.org/Special:Spe ... ranslation
User avatar
JoeKundlak
Posts: 54
Joined: Mon Oct 11, 2021 11:35 am

Re: Translating whole Wiki pages in a CAT tool outside the Wiki

Post by JoeKundlak »

Nope, there is no Import, just an Export... never mind, I am doing the translations in the CAT I am reglarly using, simply by saving the english original text for a Page as TXT (to "fool" the CAT and not process the Wiki Tags with an XML file, as it makes more harm than good) and importing it to the CAT. Works so far 8-)
Joe
---------------------------------------------------
translating into SK: https://wiki.freecadweb.org
Post Reply