You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+11-11Lines changed: 11 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -47,18 +47,18 @@ The app has 3 commands, plus you can execute it with no arguments or with --help
47
47
48
48
### 1- TRANSLATE
49
49
50
-
This command performs the automatic translation using Google Translator. The idea here is to get a fast translation without the need for a translator. It is a good idea to either revise the translation or have someone revise for you. That's why you can your translation saved as a JSON or as a TSV.
50
+
This command performs the automatic translation using Google Translator. The idea here is to get a fast translation without the need for a translator. It is a good idea to either revise the translation or have someone revise for you. That's why you can have your translation saved as a JSON or as a TSV.
51
51
52
52
You'll need to pass 5 arguments as shown below, none are optional.
53
53
54
54
```sh
55
55
$ jsontrans translate ./myfile-pt.json pt en json
56
56
```
57
-
The first argument is the command translate, the second is a path that points to a JSON file with it's contents in your original language. From this file the translate command will generate a new file with the same structure as the one passed but with the contents translated into your language of choice.
57
+
The first argument is the command translate, the second is a path that points to a JSON file with it's contents in your original language. From this file the translate command will generate a new file with the translation.
58
58
59
-
The third argument is the ISO language code of the file passed in the previous argument and the forth is the language you wish your file translated into. Last but not least, the fifth argument is the output format. It can be either JSON or TSV.
59
+
The third argument is the ISO code of the language used in file passed in the previous argument and the forth is the language you wish your file translated into. Last but not least, the fifth argument is the output format. It can be either json or tsv.
60
60
61
-
If JSON is chosen, a JSON file with the translation is created. If TSV is chosen, a TSV file with columns for and identificator (internal use), the original language and the target language are created. This way you can provide a translator with a file that is already translated and need only a revision and possible corrections, making his/her job much easier.
61
+
If JSON format is chosen, a JSON file with the translation is created. This file will have same structure as the one passed but with the contents translated into your language of choice. If TSV format is chosen, a TSV file with columns for and ID (internal use), the original language and the target language are created. This way you can provide a translator with a file that is already translated and need only a revision and possible corrections, making his/her job much faster and easier, perhaps even cheaper.
62
62
63
63

64
64
@@ -79,19 +79,19 @@ This command prepares a JSON file to be manually translated by a human or system
79
79
$ jsontrans prepare ./myfile-pt.json pt en
80
80
```
81
81
82
-
The first argument is the command prepare, the second is a path that points to a JSON file with your original translation. The third argument is the ISO language code of the file passed in the previous argument and the forth is the language you wish your file translated into.
82
+
The first argument is the command prepare, the second is a path that points to a JSON file with your original translation. The third argument is the ISO code of the language used in file passed in the previous argument and the forth is the language you wish your file translated into.
83
83
84
84
This command will generate a TSV file in the same folder and with the same name as the one passed, but with a tsv extension. The file will have 3 columns as follows:
85
85
86
-
1- Dot notation of the field in the original JSON file.
87
-
2- The field's text in the original language
88
-
3- Empty column for the translation to be entered
86
+
-1- Dot notation of the field in the original JSON file.
87
+
-2- The field's text in the original language
88
+
-3- Empty column for the translation to be entered
89
89
90
90

91
91
92
92
*The TSV file looks like this*
93
93
94
-
The idea is to give this file to the translator and instruct him to type the translations in the third column. Needless to say that if someone tampers
94
+
The idea is to give this file to a translator and instruct him/her to type the translations in the third column. Needless to say that if someone tampers with the first column this app may not be able to reassemble the JSON file from the TSV file.
95
95
96
96
You'll need the original file to create a new JSON file with the translated text. That is done in the next command.
97
97
@@ -111,8 +111,8 @@ The 4 arguments are as follows. The first is the command transform, the second i
111
111
112
112
- The TSV extension indicates tab separated files, much like CSVs but instead of commas or semicolons TABs are used to separate cells.
113
113
- Existing files will be overwritten without warning.
114
-
- The TSV files generated by this app must not be changed. The translator must be instructed to make changes only to the third column with the appropriate translations and nothing else.
115
-
- The TSV files created by this app set the first line as a header. The first column is the Identificator, the second the original language and the third the target language.
114
+
- The translator must be instructed to make changes only to the third column with the appropriate translations and nothing else.
115
+
- The TSV files created by this app set the first line as a header. The first column is the Identificator (ID), the second the original language's ISO code and the third the target language.
116
116
- Transform command expects the TSV file's first line to be a header and will ignored it.
117
117
- You can open TSV files with a large number of applications, including Microsoft Excel (multiplatform) and OpenOffice Calc (multiplatform).
118
118
- You can upload [TSV files](https://docs.fileformat.com/spreadsheet/tsv) to Google Sheets to view, edit, save, and convert the files.
0 commit comments