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
@@ -11,34 +11,34 @@ import { ReviewAuthor } from '../shared/_ReviewAuthor';
11
11
Tolgee is a **localization platform** that allows you to translate your application into any language without modifying your code.
12
12
It is designed to be used with web applications, but it can be used also with mobile apps and desktop applications.
13
13
14
-
Tolgee is a developer-focused platform, so it is **easy to integrate** with your application.
14
+
Tolgee is a developer-focused Translation Management System (TMS) that helps with internationalization (i18n), and it is **easy to integrate** with your application.
15
15
No more looking for keys in your source code, no more editing localization files, and no more manual exporting data for translators.
16
16
17
-
## Features
17
+
<ReviewAuthor
18
+
author={{
19
+
imageURL: '/img/reviewers/thibaud.jpeg',
20
+
name: 'Thibaud C.',
21
+
title: 'Lead Developper',
22
+
}}
23
+
description="Tolgee is very easy to use and to integrate with i18n libraries. We like it a lot for its collaboration capabilities."
-**Developer-friendly** - Tolgee is designed to be easy to integrate with your application. There are integrations for web frameworks via the [Tolgee JS SDK](/js-sdk) and for native mobile apps via the [Tolgee iOS SDK](/ios-sdk) and [Tolgee Android SDK](/android-sdk).
20
30
-**Easy to use** - Tolgee is easy to use for developers, but also for translators, so you can easily involve your translators into your localization process.
21
31
-**Open-source** - Tolgee is open-source, you can contribute to the project on our [GitHub repository](https://github.com/tolgee/tolgee-platform). You can also [host your own instance](/platform/self_hosting/getting_started) of Tolgee, so you can have full control over your data.
22
32
-**Free** - Our **cloud version** includes Business plan with 10,000 keys is **free for any open-source projects**. For commercial projects, you can use Tolgee for free up to 500 keys. For more information, see [pricing](https://tolgee.io/pricing).
23
33
-**In-context editor** - Tolgee provides in-context editor, so translators can easily translate your application without leaving your application.
24
-
-**AI translator** — [AI Translator](/platform/translation_process/ai_translator) can make software localization much faster and more autonomous. It provides more accurate translations than general translators as it gathers context through Tolgee'snative JS SDKs, which provide in-context dialogs.
34
+
-**AI translator** — [AI Translator](/platform/translation_process/ai_translator) can make software localization much faster and more autonomous. It provides more accurate translations than general translators as it gathers context through Tolgee'snative JS SDKs, which provide in-context dialogs.
25
35
26
-
## Intrigued yet?
36
+
## Start using Tolgee
27
37
28
38
If you want to try Tolgee, you can [sign up](https://app.tolgee.io/sign_up) for free and start using it right away. After you sign up, you will be able to [create your first project](/platform/getting_started/creating_project) and start translating your application.
29
39
30
40
## Other Tolgee Docs
31
41
32
-
-[JavaScript SDK](/js-sdk)
42
+
-[Tolgee JavaScript SDKs](/js-sdk)
33
43
-[Tolgee CLI](/tolgee-cli)
34
-
-[REST API](/api)
35
-
36
-
<ReviewAuthor
37
-
author={{
38
-
imageURL: '/img/reviewers/thibaud.jpeg',
39
-
name: 'Thibaud C.',
40
-
title: 'Lead Developper',
41
-
}}
42
-
description="Tolgee is very easy to use and to integrate with i18n libraries. We like it a lot for its collaboration capabilities."
After logging in or clicking on Tolgee logo in left top corner, you will be redirected to the Projects list view.
11
11
12
+
## Tolgee Project Setup: A Tutorial Setting Up Base Language
13
+
12
14
To create a project, click the `+ Add` button in the upper right corner. Then fill the name of the project and select the languages (you can also create a custom language).
13
15
14
-
You need to select one of the languages as a **base language**– this language will be used as a source of translations. You can add more languages later in the [Languages settings](/platform/projects_and_organizations/languages#editing-languages).
16
+
You need to select one of the languages as a **base language**- this language will be used as a source of translations. You can add languages to a project later in the [Languages settings](/platform/projects_and_organizations/languages#edit-language-settings-and-properties).
Copy file name to clipboardExpand all lines: platform/getting_started/translation_content.mdx
+10-10Lines changed: 10 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,28 +1,28 @@
1
1
---
2
2
id: files_and_integrations
3
-
title: Translation Files and Integrations
4
-
sidebar_label: Translation Files and Integrations
3
+
title: Import and Export Translation Files
4
+
sidebar_label: Import and Export Files
5
5
description: Learn how you can import existing files into the project and use our JS SDK or Android SDK to seamlessly integrate your code with your Tolgee project.
6
6
image: /img/og-images/platform.png
7
7
---
8
8
9
9
After you have [created a project](creating_project), you can import existing files into the project, use our JS SDK or Android SDK to seamlessly integrate your code with your Tolgee project, or use our API to integrate your project with your own system.
10
10
11
-
## Importing files
11
+
## How to Import Translation Files into Tolgee
12
12
13
-
To import existing translation files into your project, open the created project and click on the `Import` menu item.
14
-
Then select what language and [namespace](/platform/translation_keys/namespaces) (not required) you want to import the files into and click the `Import` button.
13
+
To import existing translation files (or, in other words, localization files) into your project (like JSON translation files), open the created project and click on the `Import` menu item.
14
+
Then select what language and [namespace](/platform/translation_keys/namespaces) (not required) you want to import the files into and click the `Import` button. This way you can bulk import translations and save time on manually adding translations.
15
15
16
-
More information about importing files can be found in the [Import](/platform/projects_and_organizations/import) page.
16
+
More information about importing files and file format can be found in the [Import](/platform/projects_and_organizations/import) page.
17
17
18
-
## Exporting files
18
+
## How to Export Translation Files into Tolgee
19
19
20
20
To export the translations, open the project and click on the `Export` menu item.
21
21
Then select what languages, file formats and [namespaces](/platform/translation_keys/namespaces) you want to export and click the `Export` button.
22
22
23
23
More information about exporting files can be found in the [Export](/platform/projects_and_organizations/export) page.
24
24
25
-
## JS SDK
25
+
## JavaScript SDK Integration for Localization
26
26
27
27
Tolgee provides a [JS SDK](/js-sdk) that can be used to easily integrate your Tolgee project with your codebase.
28
28
This way, you can use the same translation keys in your code as you use in your Tolgee project.
@@ -31,11 +31,11 @@ In production mode, you should use data exported from the Tolgee platform.
31
31
To export the translation files, see [exporting translations](/platform/projects_and_organizations/export).
32
32
Then provide the data via Tolgee configuration options described in [Providing static data](/js-sdk/providing-static-data).
33
33
34
-
## iOS SDK
34
+
## iOS SDK for Localization
35
35
36
36
Tolgee provides a native [iOS SDK](/ios-sdk) with a great support for SwiftUI that integrates with your app and supports OTA updates of strings from a CDN.
37
37
38
-
## Android SDK
38
+
## Android SDK for Localization
39
39
40
40
Tolgee also provides an [Android SDK](/android-sdk) for native Android apps, including Jetpack Compose support. Follow the Android docs to:
Copy file name to clipboardExpand all lines: platform/projects_and_organizations/content_delivery.mdx
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
id: content_delivery
3
-
title: Content Delivery
4
-
sidebar_label: Content Delivery
3
+
title: Content Delivery (Deploy Files to Cloud)
4
+
sidebar_label: Content Delivery to Cloud
5
5
description: Content Delivery will deploy your localization files to reliable and fast cloud storage so you can confidently use them in your application.
6
6
image: /img/og-images/platform.png
7
7
---
@@ -71,7 +71,7 @@ Content delivery is made to be rapidly available all around the world, so we pri
71
71
72
72
> Read more about [providing Tolgee SDK with static data](/js-sdk/providing-static-data).
73
73
74
-
## Manual publishing
74
+
## Manual publishing of Localization Files
75
75
76
76
If you opted out of automatic publishing, you can do so manually in the list of content deliveries by `Publish` button.
Copy file name to clipboardExpand all lines: platform/projects_and_organizations/editing_translations.mdx
+8-8Lines changed: 8 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,14 +1,14 @@
1
1
---
2
2
id: editing_translations
3
-
title: Editing translations
4
-
sidebar_label: Editing translations
3
+
title: How to Edit Translations in Tolgee
4
+
sidebar_label: How to Edit Translations
5
5
image: /img/og-images/platform.png
6
6
---
7
7
8
8
For editing translation strings, Tolgee provides an editor, which helps translators translate strings in a
9
9
convenient way.
10
10
11
-
## The translations view
11
+
## How to Edit Translation Strings: The Translations View
12
12
The translations view enables you to access translation keys, the translation text in the target languages. It allows you to
13
13
add comments or see the history. When translating, you can also get the results from [machine translation](../translation_process/machine_translation.mdx) providers and
@@ -19,8 +19,8 @@ import { ScreenshotWrapper } from "../shared/_ScreenshotWrapper";
19
19
alt="Translations View" />
20
20
21
21
## Editing the translation
22
-
You can enter translation editing mode by clicking on the translation text. This will open the translation editor.
23
-
When editing translation, translation memory, machine translation, comments and history are displayed in the right panel.
22
+
You can edit translations by entering editing mode by clicking on the translation text. This will open the translation editor.
23
+
When using the localization editor, translation memory, automatic translation (machine translation and AI translation), comments and history are displayed in the right panel.
24
24
25
25
### Editing translation with placeholders
26
26
When translation text contains placeholders, their code is hidden by default. So you don't have to understand the actual
@@ -37,16 +37,16 @@ To add a new placeholder, you can just type the placeholder syntax into the tran
37
37
will be automatically visualized. Read more about [Tolgee Universal ICU placeholders here](/platform/translation_process/tolgee_universal_icu_placeholders)
38
38
to know about all the supported placeholder types and syntax.
39
39
40
-
### Editing placeholders as a code
41
-
Sometimes, you might want to edit the whole message as a code with placeholders and HTML tags. You can do that by switching
40
+
### Code Mode vs Visual Mode
41
+
Sometimes, you might want to edit the whole message as a code with placeholders and HTML tags instead of using translation editor. You can do that by switching
42
42
the editor to the code mode in top right of the current language translation editor above the translation input.
Copy file name to clipboardExpand all lines: platform/projects_and_organizations/export.mdx
+10-10Lines changed: 10 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
id: export
3
-
title: Export
4
-
sidebar_label: Export
3
+
title: Export Translation Files
4
+
sidebar_label: Export Translation Files
5
5
description: Translations can be exported from Tolgee. You can currently export translations in two formats (JSON and XLIFF)
6
6
image: /img/og-images/platform.png
7
7
---
@@ -10,35 +10,35 @@ import { ScreenshotWrapper } from '../shared/_ScreenshotWrapper';
10
10
11
11
Translations can be exported from Tolgee. You can currently export translations in [many different formats](/platform/supported_formats), and you can also export only specific translations, e.g., only the ones that are not translated yet.
12
12
13
-
## Exporting from Tolgee
13
+
## Export Translations from Tolgee Dashboard
14
14
15
15
To export translations from Tolgee, select project, and then choose the "Export" item from the sidebar.
-**States**– which translations should be exported. You can choose multiple states.
22
-
-**Languages**– which languages should be exported (all languages are exported by default).
23
-
-**Format**– select the format of the exported file. Currently, we support only JSON and XLIFF formats.
24
-
-**Namespaces**– which namespaces should be exported (all namespaces are exported by default). Learn more about namespaces in [this article](/platform/translation_keys/namespaces).
25
-
-**Nested structure**– whether the exported file should be structured as nested objects or not (based on the "." separator in key names). This option is available **only for JSON format**.
21
+
-**States**- which translations should be exported. You can choose multiple states.
22
+
-**Languages**- which languages should be exported (all languages are exported by default).
23
+
-**Format**- select the format of the exported file. Currently, we support only JSON and XLIFF formats.
24
+
-**Namespaces**- which namespaces should be exported (all namespaces are exported by default). Learn more about namespaces in [this article](/platform/translation_keys/namespaces).
25
+
-**Nested structure**- whether the exported file should be structured as nested objects or not (based on the "." separator in key names). This option is available **only for JSON format**.
26
26
27
27
When you are done, click the `Export` button and the file will be downloaded.
> If you want to specify exactly which keys need to be exported, you can go to [Batch operations](../translation_keys/batch_operations.mdx) and export from there.
32
32
33
-
## Exporting via CLI
33
+
## Export Translations via CLI
34
34
35
35
You can also export translations via [Tolgee CLI](/tolgee-cli). To do so, you need to have the Tolgee CLI installed. You can find the installation instructions [here](/tolgee-cli/installation).
36
36
37
37
Then you can use the [`tolgee pull`](/tolgee-cli/push-pull-strings#pulling-strings) command to export translations.
38
38
39
39
The command exports strings from the platform, and saves them in a folder of your choice. You can use this to download strings from Tolgee before bundling your app for production.
40
40
41
-
## Exporting via API
41
+
## Export Translations via REST API
42
42
43
43
You can also export translations via REST API, e.g., via the `curl` utility:
Copy file name to clipboardExpand all lines: platform/projects_and_organizations/import.mdx
+8-6Lines changed: 8 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,15 +1,17 @@
1
1
---
2
2
id: import
3
-
title: Import
4
-
sidebar_label: Import
5
-
image: /img/og-images/platform.png
3
+
title: Import Translation Files
4
+
sidebar_label: Import Translation Files
5
+
image: /img/og-images/platform.png
6
6
---
7
7
8
-
Tolgee supports importing existing translations from various formats. You can import translations from JSON, XLIFF, and PO files.
8
+
Tolgee supports importing existing translations from various formats. Here is the list of [Tolgee supported formats](/platform/supported_formats).
9
+
10
+
You can import translations from JSON, XLIFF, PHP, C/C++, Python, Apple Strings, Apple Stringsdict, Apple Strings Catalog, Apple XLIFF, Android XML, Compose Multiplatform XML, Flutter ARB, Ruby YAML, i18next, CSV, .NET RESX, and XLSX files.
To import translations to Tolgee, you need to have a project created. You can create a project in the [Projects](/platform/getting_started/creating_project) section.
15
17
After creating a project, you can import translations to it by navigating to the "Import" page.
@@ -26,7 +28,7 @@ When you are done, click the `Import` button and the file will be imported into
When you import a file, Tolgee will check if the imported strings already exist in the project. If there are some **conflicts** in the strings, you will be prompted to **resolve them**.
0 commit comments