Want to Help FreeCAD? Please vote for Crowdin (Translation) features that would benefit translating FC

[Kunda1]

HEADS UP: Thanks to all who voted in the 1st round. We got a feature implemented! You should now have 3 more votes again. Please use them on the remaining features below. Thank you!

FreeCAD uses a 3rd party translation service called Crowdin to crowd-source translation work for the project.
Currently there is a feature requests the community can vote on to that give the crowdin devs a sense of what is popular and in demand. If we vote as a community on a specific feature we could influence the crowdin devs to implement said feature. So...here are some features IMO think would be helpful making translating FC more efficient:

• Add to context source file info for .ts files <== Give this 3 stars Completed May 9, 2018 WooHoo! Thanks everyone!
• Context of translation string could link directly to Github filename+line number for true context <== Give this 1 star
• Glossary terms highlighted in colors (more visible) <== Give this 1 star
• filter translated not by user x <== Give this 1 star
• Declutter comments
• Timestamp of latest revision in the column headers
• Widget to show translation rates

To see more features you can check out https://crowdin.uservoice.com/forums/31 ... ilters/top

[yorik]

Many people on our crowdin project complain that they cant find where a certain string is located in the code... Our .ts files contain the file & line number, but this is apparently not used on crowdin, but i didn't find that issue in the list.

In any case, most complaints i get is from people who don't understand the exact meaning of a sentence. This is normal I think, many of the sentences that appear in the FreeCAD UI only make sense in a CAD context, and when they are pulled out of it, it's hard to make sure of what they mean.

Maybe that could be more an effort from our part, to go to crowdin and write better explanations where people are asking (there is always a comments section where additional info can be written)

[wmayer]

Many people on our crowdin project complain that they cant find where a certain string is located in the code... Our .ts files contain the file & line number, but this is apparently not used on crowdin, but i didn't find that issue in the list.

I wonder if people will really understand better if they knew the exact line or file. Besides this they can use the context string and search with that in the source code. It's maybe not very convenient but this way you can find everything you need.

In any case, most complaints i get is from people who don't understand the exact meaning of a sentence. This is normal I think, many of the sentences that appear in the FreeCAD UI only make sense in a CAD context, and when they are pulled out of it, it's hard to make sure of what they mean.

Qt allows it to add a special remark to the source code which will be picked up by lupdate: http://doc.qt.io/qt-5/i18n-source-trans ... r-comments
The next question is if crowdin supports this method.

[Kunda1]

Many people on our crowdin project complain that they cant find where a certain string is located in the code... Our .ts files contain the file & line number, but this is apparently not used on crowdin, but i didn't find that issue in the list.

Actually, they do have that feature. I don't think we are creating our .ts files correctly. Example in the code

Code: Select all

    <message>
        <location filename="../../Command.cpp" line="+97"/>
        <source>Image</source>
        <translation>Изображение</translation>
    </message>
    <message>
        <location line="+1"/>
        <source>Create image plane...</source>
        <translation>Создать плоскость изображения ...</translation>
</message>

Here is the crowdin link: https://crowdin.com/translate/freecad/560/en-ru

crowdin.png (26.07 KiB) Viewed 8686 times

We shouldn't be adding + or - to line numbers like: line="+97"

In any case, most complaints i get is from people who don't understand the exact meaning of a sentence. This is normal I think, many of the sentences that appear in the FreeCAD UI only make sense in a CAD context, and when they are pulled out of it, it's hard to make sure of what they mean.

Maybe that could be more an effort from our part, to go to crowdin and write better explanations where people are asking (there is always a comments section where additional info can be written)

Maybe we can add screenshots? https://support.crowdin.com/adding-screenshots/

[Kunda1]

In any case, most complaints i get is from people who don't understand the exact meaning of a sentence. This is normal I think, many of the sentences that appear in the FreeCAD UI only make sense in a CAD context, and when they are pulled out of it, it's hard to make sure of what they mean.

Qt allows it to add a special remark to the source code which will be picked up by lupdate: http://doc.qt.io/qt-5/i18n-source-trans ... r-comments
The next question is if crowdin supports this method.

I asked a crowdin specialist and they confirmed this:

As I was told be our devs, we support such kind of comments for QT: comment extracomment translatorcomment oldcomment

[wmayer]

Actually, they do have that feature. I don't think we are creating our .ts files correctly.

We don't create these files manually but use Qt stuff for it. And no, it's correct this way because the + indicates that the line numbers are relative. Sometimes there are also negative line numbers.

[Kunda1]

Actually, they do have that feature. I don't think we are creating our .ts files correctly.

We don't create these files manually but use Qt stuff for it. And no, it's correct this way because the + indicates that the line numbers are relative. Sometimes there are also negative line numbers.

Don't mean to disagree but I think the relative line numbers are the problem. Other projects I've seen don't use them:
Qgis: https://raw.githubusercontent.com/qgis/ ... qgis_en.ts
Scribus: https://raw.githubusercontent.com/scrib ... s.en_US.ts

EDIT: My mistake. I am somewhat used to Transifex who's interface and functionality is more sophisticated then Crowdin's. At this time Crowdin does not have the feature of displaying filename and line number. We need to vote for this feature exactly for the above reasons: Add to context source file info for .ts files

I'm still under the impression that using relative line numbers is not future friendly. Can we reconsider this?

[Kunda1]

Sorry for the confusion. I'm getting mixed messages + my own miscomprehension is occuring.
Crowdin says:

Yes, you're right. Currently, our system doesn't add context like described here:
https://crowdin.uservoice.com/forums/31 ... r-ts-files
As a possible workaround, you could add needed information with the

Code: Select all

<comment> node: ... <context> 
<name>AboutDlg</name> 
<message> 
<location filename="../aboutdlg.ui" line="14"/> 
<source>About Torrent File Editor</source> 
<translation>О программе Torrent File Editor</translation> 
<comment>../aboutdlg.ui:14 MainWindow</comment>
 </message> ...

Here is an example of a current workaround:

Code: Select all

<message> 
   <location filename="openscadprefs-base.ui" line="14"/> 
   <source>General settings</source> 
    <translation>Impostazioni generali</translation> 
   <comment>"openscadprefs-base.ui" line="14"</comment> 
</message>

Will produce:

screenshot-crowdin.com 2017-02-10 17-45-18.png (12.64 KiB) Viewed 8662 times

[Kunda1]

Actually, they do have that feature. I don't think we are creating our .ts files correctly.

We don't create these files manually but use Qt stuff for it. And no, it's correct this way because the + indicates that the line numbers are relative. Sometimes there are also negative line numbers.

Sorry for reposting, I wanted to make sure this is seen since I wanted to own up to my mistake. I am somewhat used to Transifex who's interface and functionality is more sophisticated then Crowdin's. At this time Crowdin does not have the feature of displaying filename and line number. We need to vote for this feature exactly for the above reasons: Add to context source file info for .ts files

I'm still under the impression that using relative line numbers iin translations are not future friendly. Can we reconsider this?

[yorik]

Qt allows it to add a special remark to the source code which will be picked up by lupdate: http://doc.qt.io/qt-5/i18n-source-trans ... r-comments
The next question is if crowdin supports this method.

I don't think so, but this is useful to know anyway.. Maybe in the future they will.

Can we reconsider this?

As Werner said, we don't do that manually nor intentionally. It's generated automatically by Qt. If Qt has a way to do it another way, certainly we can use that instead.