Skip to content

Latest commit

 

History

History
38 lines (30 loc) · 2.93 KB

TRANSLATING.md

File metadata and controls

38 lines (30 loc) · 2.93 KB

Welcome to the translation team!

I am glad to have you here and I hope you will enjoy your time helping LaserGRBL project by translating it into your language. I know this whole thing may seem a bit hard at first, there is definitely a bit of a learning curve, but below you can find a set of guidelines that should make this process a little bit easier.

Getting Started

There are some tools that you should definitly have to contribute with translation in a in an effective manner.

  • A Git client for interact with github (download source code and submit your translation)
  • A software for edit translation file

As Git client I suggest to download Github Desktop from here: https://desktop.github.com

To translate language files I suggest a good tool for editing resx files, called ResEx, which can be downloaded from here: ResEx 1.1

If you have already installed RegEx, please uninstall and use this version (which is able to handle .NET 4.0 resx file)

Clone and translate LaserGRBL

Note: These steps below assume you already downloaded the required/recommended programs.

  • Step 1: Login or register to GitHub (video tutorial)
  • Step 2: Create a fork of this repo Fork
  • Step 3: Clone your fork of this repo using GitHub DesktopClone
  • Step 4: Start ResExOpen
  • Step 5: Navigate to the folder where LaserGRBL was cloned to. (Usually ...\Documents\GitHub\LaserGRBL on Windows)
  • Step 6: Open the second LaserGRBL directory, then open a .resx file, without any suffiexes (like hu_HU etc...)Select folder In the example, we will open SettingsForm.resx with ResEx
  • Step 7: Once opened, change it to your localeLocale If your locale is not present, yo can create it this way: Locale2
  • Step 8: Once your locale is available, you can start translating! Just simply fill the empty spaces on the right in your language. The left side shows the components name, while in the middle there is the english description/text to help you.Translating
  • Step 9: Once done, you can open another .resx file without any suffixes (or if you use the filter method, any file showing up). When all is done, you can create a Pull Request (PR) on github.

Creating a Pull Request (PR)

(Assuming you already have a GitHub account, and done the prevoius steps)

  • Step 1: Open Github Desktop
  • Step 2: Review your changes, fill the summary, and click Commit to master Review
  • Step 3: Push your changes to your repo Push
  • Step 4: Create a PR from your repoCreatePRPR