Using Github to update Timeshift text

Chat about Linux in general
Post Reply
QuesterLEJ2
Level 1
Level 1
Posts: 1
Joined: Fri Apr 05, 2019 5:39 am

Using Github to update Timeshift text

Post by QuesterLEJ2 » Fri Apr 05, 2019 5:59 am

Hello,

Relative newbie to Linux here contemplating a switch from Windows in the next year or two but not fully on board. Very technically inclined but unsure exactly how GitHub works, as well as the translation templates for apps, specifically Timeshift. I've noticed there are a few grammatically-incorrect or awkwardly-worded phrases here and there in the app, and I'd like to correct them. I'm a native English speaker but also speak fluent Spanish so I'd also like to check out the translation files for that language.

Having said that, can someone explain in step-by-step detail how I would edit the translation files for each language and propose commits for the changes? I'm familiar with the concepts, in that I know I'll have to create a repository with the relevant files, edit them, and then propose commits, but I'm not certain exactly how to do this. Help welcome. I want to get a feel for how contributing to projects works.

Luke

User avatar
catweazel
Level 19
Level 19
Posts: 9735
Joined: Fri Oct 12, 2012 9:44 pm
Location: Australian Antarctic Territory

Re: Using Github to update Timeshift text

Post by catweazel » Fri Apr 05, 2019 6:13 am

QuesterLEJ2 wrote:
Fri Apr 05, 2019 5:59 am
Having said that, can someone explain in step-by-step detail how I would edit the translation files for each language and propose commits for the changes?
That's highly unlikely. Every application that uses a different development environment will have its own way of dealing with translations. The methods for translating Qt C++ strings would be miles apart from translating something written in say, JavaScript. You would usually need to pick your application then research the programming language it's written in to determine the translation process, or go to GitHub and ask the developers themselves.

Not to be rude, and not to discourage you, but these are support forums, not tutorial forums. Go-ogle is a very good source of that kind of information.

https://guides.github.com/activities/hello-world/

The first link from go-ogle.
"There is, ultimately, only one truth -- cogito, ergo sum -- everything else is an assumption." - Me, my swansong.

User avatar
xenopeek
Level 24
Level 24
Posts: 24135
Joined: Wed Jul 06, 2011 3:58 am
Location: The Netherlands

Re: Using Github to update Timeshift text

Post by xenopeek » Fri Apr 05, 2019 6:35 am

Welcome to the Linux Mint forums!

We have a translation guide you can use for software developed by Linux Mint: https://linuxmint-translation-guide.rea ... en/latest/

However, Timeshift is not developed by Linux Mint but by Tony George (teejee2008 on GitHub). The developer answer similar question about translations here: https://github.com/teejee2008/timeshift/issues/329. So for translations you'd fork (clone) the GitHub repository, make a new branch for your changes, edit the .po file to improve translations and commit that change to your new branch and then do a PR (pull request) to the original GitHub repository so your changes from your branch can be merged back into the project. It's generally best to try and make smaller PRs so the project's developers can more easily review and merge the changes. So if you'd improve translations for multiple languages, do one PR per language (and each language in its own branch on your fork).

You can edit .po files with a text editor but using a tool like poedit (you can install it through Software Manager) is more convenient. See poedit website for some more info https://poedit.net/.

Getting the hang of working with GitHub can be a new challenge though for simple edits you can do everything through the GitHub website itself. They have good help and learning resources: https://help.github.com/en#dotcom. Especially check out https://help.github.com/en/articles/git ... -resources.

The first time you're contributing to some project may be a bit of a learning curve but once over that hurdle it's just a process you follow every time.
Image

Post Reply

Return to “Chat about Linux”