mirror of
https://github.com/freeCodeCamp/freeCodeCamp.git
synced 2026-09-24 23:01:18 +08:00
chore(i18n,docs): processed translations (#50946)
This commit is contained in:
camperbot
@@ -1,14 +1,36 @@
|
||||
# Deploying New Languages on `/learn`
|
||||
|
||||
Before you can release a new language, you will need to allow the languages to download from Crowdin.
|
||||
To enable a new language on `/learn` (curriculum), you need to complete the following steps:
|
||||
|
||||
- Complete translating and approving the first 3 certifications on Crowdin. (New Responsive Web Design, JavaScript Algorithms and Data Structures, and Front End Development Libraries)
|
||||
- Complete translating and approving all strings in Learn UI project on Crowdin.
|
||||
- Update Crowdin settings to add a custom language code for the new language.
|
||||
- Open the 1st PR to configure GitHub Actions. You need to update 2 files:
|
||||
- `crowdin-download.client-ui.yml`
|
||||
- `crowdin-download.curriculum.yml`
|
||||
- Open the 2nd PR to add other configurations. You need to update/add the following files:
|
||||
- Update `i18n.ts`
|
||||
- Update `superblocks.ts`
|
||||
- Update `algolia-locale-setup.ts`
|
||||
- Add `links.json`
|
||||
- Add `meta-tags.json`
|
||||
- Add `motivation.json`
|
||||
- Ask infrastructure team to spin up the VM for the new language.
|
||||
- Once the VM is ready, open the 3rd PR to show the new language in the navigation menu.
|
||||
|
||||
We will explain each step in the following sections.
|
||||
|
||||
## Updating Crowdin Settings
|
||||
|
||||
In the `Curriculum` and `Learn UI` projects, you will need to select `Project Settings` from the sidebar. Then scroll down to `Language Mapping`, where you will see an option to add custom language codes. Add a new entry for the language you are releasing, selecting `language` as the `Placeholder` value, and entering a URL-friendly lower-case spelling of your language's name for the `Custom code`. If you aren't sure what to use, reach out in our contributor chat and we will assist you.
|
||||
Before you can release a new language, you will need to allow the languages to download from Crowdin. To configure that, you need to add a custom language code for your language.
|
||||
|
||||
## Updating Workflows
|
||||
In the `Curriculum` and `Learn UI` projects on Crowdin, you will need to select `Settings` > `Languages` from the sidebar. Then scroll down to `Language Mapping`, where you will see an option to add custom language codes. Add a new entry for the language you are releasing, selecting `language` as the `Placeholder` value, and entering a URL-friendly lower-case spelling of your language's name for the `Custom code`. If you aren't sure what to use, or you don't have an admin role and can't see the settings, reach out in our contributor chat and we will assist you.
|
||||
|
||||
You will need to add a step to the `crowdin-download.client-ui.yml` and `crowdin-download.curriculum.yml`. The step for these will be the same. For example, if you want to enable Dothraki downloads:
|
||||
## Updating Workflows for GitHub Actions
|
||||
|
||||
Then you need to configure the syncing between Crowdin and GitHub.
|
||||
|
||||
You will need to add a step to the [`crowdin-download.client-ui.yml`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/.github/workflows/crowdin-download.client-ui.yml) and [`crowdin-download.curriculum.yml`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/.github/workflows/crowdin-download.curriculum.yml). The step for these will be the same. For example, if you want to enable Dothraki downloads:
|
||||
|
||||
```yml
|
||||
##### Download Dothraki #####
|
||||
@@ -49,14 +71,14 @@ Note that the `download_language` key needs to be set to the language code displ
|
||||
|
||||
There are a few steps to take in order to allow the codebase to build in your desired language.
|
||||
|
||||
First, visit the `config/i18n.ts` file to add the language to the list of available languages and configure the values. There are several objects here.
|
||||
First, visit the [`config/i18n.ts`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/config/i18n.ts) file to add the language to the list of available languages and configure the values. There are several objects here.
|
||||
|
||||
- `Languages`: Add the new language to `Languages` enum, similar to the others. The string value here will be used in the `.env` file to set a build language later.
|
||||
- `availableLangs`: Add the new property from the `Languages` enum to both the `client` and `curriculum` arrays.
|
||||
- `i18nextCodes`：這些是每種語言的 ISO 語言代碼。 You will need to add the appropriate ISO code for the language you are enabling. These do need to be unique for each language.
|
||||
- `LangNames`: These are the display names for the language selector in the navigation menu.
|
||||
- `LangCodes`: These are the language codes used for formatting dates and numbers. These should be Unicode CLDR codes instead of ISO codes.
|
||||
- `hiddenLangs`: These languages will not be displayed in the navigation menu. This is used for languages that are not yet ready for release.
|
||||
- `hiddenLangs`: These languages will not be displayed in the navigation menu. This is used for languages that are not yet ready for release. Include your language in this array in the first PR and ask staff team to prepare the VM instance for your language. When the VM is ready, make another PR to remove it from the array.
|
||||
- `rtlLangs`: These are languages that read from right to left.
|
||||
|
||||
As an example, if you wanted to enable Dothraki as a language, your `i18n.ts` objects should look like this:
|
||||
@@ -116,7 +138,7 @@ export const hiddenLangs = ['dothraki'];
|
||||
export const rtlLangs = [''];
|
||||
```
|
||||
|
||||
> [!NOTE] When a language has been set up in the deployment pipeline AND has a public `/news` instance live, it can be removed from the `hiddenLangs` array and be made available to the public.
|
||||
> [!NOTE] When a language has been set up in the deployment pipeline AND has a public `/learn` instance live, it can be removed from the `hiddenLangs` array and be made available to the public.
|
||||
|
||||
### Set Translated SuperBlocks
|
||||
|
||||
@@ -149,7 +171,7 @@ See the `SuperBlocks` enum at the beginning of the same file for the full list o
|
||||
|
||||
### Configure Search
|
||||
|
||||
Next, open the `client/src/utils/algolia-locale-setup.ts` file. This data is used for the search bar that loads `/news` articles. While it is unlikely that you are going to test this functionality, missing the data for your language can lead to errors when attempting to build the codebase locally.
|
||||
Next, open the [`client/src/utils/algolia-locale-setup.ts`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/client/src/utils/algolia-locale-setup.ts) file. This data is used for the search bar that loads `/news` articles. While it is unlikely that you are going to test this functionality, missing the data for your language can lead to errors when attempting to build the codebase locally.
|
||||
|
||||
Add an object for your language to the `algoliaIndices` object. You should use the the same values as the `english` object for local testing, replacing the `english` key with your language's `availableLangs` value.
|
||||
|
||||
@@ -179,12 +201,52 @@ const algoliaIndices = {
|
||||
name: 'news',
|
||||
searchPage: 'https://www.freecodecamp.org/news/search/'
|
||||
}
|
||||
|
||||
// If we already have /news in the target language up and running, you can update the values like this:
|
||||
// dothraki: {
|
||||
// name: 'news-mis',
|
||||
// searchPage: 'https://www.freecodecamp.org/dothraki/news/search/'
|
||||
// }
|
||||
};
|
||||
```
|
||||
|
||||
### Client UI
|
||||
|
||||
You will need to take an additional step to handle the client UI translations.
|
||||
|
||||
The Crowdin workflows will automatically pull down _some_ of the UI translations, but there are a couple of files that need to be moved manually.
|
||||
|
||||
You will want to copy the following files from [`/client/i18n/locales/english`](https://github.com/freeCodeCamp/freeCodeCamp/tree/main/client/i18n/locales/english) to `/client/i18n/locales/<your-language>`, and apply translations as needed:
|
||||
|
||||
- `links.json`
|
||||
- `meta-tags.json`
|
||||
- `motivation.json`
|
||||
|
||||
You don't have to have everything in these 3 files translated at first. It's possible to translate only the relevant parts and make adjustments later.
|
||||
|
||||
#### `links.json`
|
||||
|
||||
You can replace any URLs that you have corresponding pages ready in your language.
|
||||
|
||||
For example, if you have the publication in your language, you can replace the URL for `"news"`. If you want to translate articles listed in the footer links, see [How to Translate Articles in the Footer Links](language-lead-handbook.md#how-to-translate-articles-in-the-footer-links).
|
||||
|
||||
#### `meta-tags.json`
|
||||
|
||||
This file contains metadata for the web page of `/learn` in your language. You can translate the values for `"title"`, `"description"`, and `"social-description"`. The value for `"youre-unsubscribed"` is used when someone unsubscribes from Quincy's weekly email.
|
||||
|
||||
Also, you can translate or add relevant keywords in your language to the `"keywords"` array.
|
||||
|
||||
#### `motivation.json`
|
||||
|
||||
This file contains the compliments that will be displayed to campers when they complete a challenge, and motivational quotes that are displayed on the top page of `/learn`.
|
||||
|
||||
You can translate them, or even replace them with relevant compliments/quotes of your choice in your language.
|
||||
|
||||
### Enabling Localized Videos
|
||||
|
||||
For the video challenges, you need to change a few things. First, add the new locale to the GraphQL query in the `client/src/templates/Challenges/video/Show.tsx` file. For example, adding Dothraki to the query:
|
||||
This section is applicable only if you have localized videos in the challenges. Otherwise, you can skip this section.
|
||||
|
||||
For the video challenges, you need to change a few things. First, add the new locale to the GraphQL query in the [`client/src/templates/Challenges/video/Show.tsx`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/client/src/templates/Challenges/video/show.tsx) file. For example, adding Dothraki to the query:
|
||||
|
||||
```tsx
|
||||
query VideoChallenge($slug: String!) {
|
||||
@@ -236,18 +298,6 @@ videoLocaleIds: Joi.when('challengeType', {
|
||||
}),
|
||||
```
|
||||
|
||||
## Client UI
|
||||
|
||||
You will need to take an additional step to handle the client UI translations.
|
||||
|
||||
The Crowdin workflows will automatically pull down _some_ of the UI translations, but there are a couple of files that need to be moved manually.
|
||||
|
||||
You will want to copy the following files from `/client/i18n/locales/english` to `/client/i18n/locales/<your-language>`, and apply translations as needed:
|
||||
|
||||
- `links.json`
|
||||
- `meta-tags.json`
|
||||
- `motivation.json`
|
||||
|
||||
## Testing Translations Locally
|
||||
|
||||
If you would like to test translations locally, before adding them to our main repository - skip the Crowdin workflow changes. Follow the steps for enabling a language, then download the translations from Crowdin and load them into your local code.
|
||||
@@ -264,6 +314,18 @@ Once these are in place, you should be able to run `pnpm run develop` to view yo
|
||||
|
||||
> [!ATTENTION] While you may perform translations locally for the purpose of testing, we remind everyone that translations should _not_ be submitted through GitHub and should only be done through Crowdin. Be sure to reset your local codebase after you are done testing.
|
||||
|
||||
## Show the language in the navigation menu
|
||||
|
||||
When your prior PR is merged and the VM for your language is ready, make another PR to show your language in the navigation menu.
|
||||
|
||||
In [`config/i18n.ts`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/config/i18n.ts) file, you have included your language in `hiddenLangs` array in the prior PR. Remove it from the array now.
|
||||
|
||||
```js
|
||||
export const hiddenLangs = []; // Remove your language from the array
|
||||
```
|
||||
|
||||
When this PR is merged and gets deployed, the curriculum in your language will be live.
|
||||
|
||||
# Deploying New Languages on `/news`
|
||||
|
||||
To deploy News for a new language, you'll need to create two PRs. One PR will be to the [CDN repo](https://github.com/freeCodeCamp/cdn), and the other will be to the [News repo](https://github.com/freeCodeCamp/news).
|
||||
|
||||
@@ -1,14 +1,36 @@
|
||||
# Deploying New Languages on `/learn`
|
||||
|
||||
Before you can release a new language, you will need to allow the languages to download from Crowdin.
|
||||
To enable a new language on `/learn` (curriculum), you need to complete the following steps:
|
||||
|
||||
- Complete translating and approving the first 3 certifications on Crowdin. (New Responsive Web Design, JavaScript Algorithms and Data Structures, and Front End Development Libraries)
|
||||
- Complete translating and approving all strings in Learn UI project on Crowdin.
|
||||
- Update Crowdin settings to add a custom language code for the new language.
|
||||
- Open the 1st PR to configure GitHub Actions. You need to update 2 files:
|
||||
- `crowdin-download.client-ui.yml`
|
||||
- `crowdin-download.curriculum.yml`
|
||||
- Open the 2nd PR to add other configurations. You need to update/add the following files:
|
||||
- Update `i18n.ts`
|
||||
- Update `superblocks.ts`
|
||||
- Update `algolia-locale-setup.ts`
|
||||
- Add `links.json`
|
||||
- Add `meta-tags.json`
|
||||
- Add `motivation.json`
|
||||
- Ask infrastructure team to spin up the VM for the new language.
|
||||
- Once the VM is ready, open the 3rd PR to show the new language in the navigation menu.
|
||||
|
||||
We will explain each step in the following sections.
|
||||
|
||||
## Updating Crowdin Settings
|
||||
|
||||
In the `Curriculum` and `Learn UI` projects, you will need to select `Project Settings` from the sidebar. Then scroll down to `Language Mapping`, where you will see an option to add custom language codes. Add a new entry for the language you are releasing, selecting `language` as the `Placeholder` value, and entering a URL-friendly lower-case spelling of your language's name for the `Custom code`. If you aren't sure what to use, reach out in our contributor chat and we will assist you.
|
||||
Before you can release a new language, you will need to allow the languages to download from Crowdin. To configure that, you need to add a custom language code for your language.
|
||||
|
||||
## Updating Workflows
|
||||
In the `Curriculum` and `Learn UI` projects on Crowdin, you will need to select `Settings` > `Languages` from the sidebar. Then scroll down to `Language Mapping`, where you will see an option to add custom language codes. Add a new entry for the language you are releasing, selecting `language` as the `Placeholder` value, and entering a URL-friendly lower-case spelling of your language's name for the `Custom code`. If you aren't sure what to use, or you don't have an admin role and can't see the settings, reach out in our contributor chat and we will assist you.
|
||||
|
||||
You will need to add a step to the `crowdin-download.client-ui.yml` and `crowdin-download.curriculum.yml`. The step for these will be the same. For example, if you want to enable Dothraki downloads:
|
||||
## Updating Workflows for GitHub Actions
|
||||
|
||||
Then you need to configure the syncing between Crowdin and GitHub.
|
||||
|
||||
You will need to add a step to the [`crowdin-download.client-ui.yml`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/.github/workflows/crowdin-download.client-ui.yml) and [`crowdin-download.curriculum.yml`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/.github/workflows/crowdin-download.curriculum.yml). The step for these will be the same. For example, if you want to enable Dothraki downloads:
|
||||
|
||||
```yml
|
||||
##### Download Dothraki #####
|
||||
@@ -49,14 +71,14 @@ Note that the `download_language` key needs to be set to the language code displ
|
||||
|
||||
There are a few steps to take in order to allow the codebase to build in your desired language.
|
||||
|
||||
First, visit the `config/i18n.ts` file to add the language to the list of available languages and configure the values. There are several objects here.
|
||||
First, visit the [`config/i18n.ts`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/config/i18n.ts) file to add the language to the list of available languages and configure the values. There are several objects here.
|
||||
|
||||
- `Languages`: Add the new language to `Languages` enum, similar to the others. The string value here will be used in the `.env` file to set a build language later.
|
||||
- `availableLangs`: Add the new property from the `Languages` enum to both the `client` and `curriculum` arrays.
|
||||
- `i18nextCodes`：这些是每种语言的 ISO 语言代码。 You will need to add the appropriate ISO code for the language you are enabling. These do need to be unique for each language.
|
||||
- `LangNames`: These are the display names for the language selector in the navigation menu.
|
||||
- `LangCodes`: These are the language codes used for formatting dates and numbers. These should be Unicode CLDR codes instead of ISO codes.
|
||||
- `hiddenLangs`: These languages will not be displayed in the navigation menu. This is used for languages that are not yet ready for release.
|
||||
- `hiddenLangs`: These languages will not be displayed in the navigation menu. This is used for languages that are not yet ready for release. Include your language in this array in the first PR and ask staff team to prepare the VM instance for your language. When the VM is ready, make another PR to remove it from the array.
|
||||
- `rtlLangs`: These are languages that read from right to left.
|
||||
|
||||
As an example, if you wanted to enable Dothraki as a language, your `i18n.ts` objects should look like this:
|
||||
@@ -116,7 +138,7 @@ export const hiddenLangs = ['dothraki'];
|
||||
export const rtlLangs = [''];
|
||||
```
|
||||
|
||||
> [!NOTE] When a language has been set up in the deployment pipeline AND has a public `/news` instance live, it can be removed from the `hiddenLangs` array and be made available to the public.
|
||||
> [!NOTE] When a language has been set up in the deployment pipeline AND has a public `/learn` instance live, it can be removed from the `hiddenLangs` array and be made available to the public.
|
||||
|
||||
### Set Translated SuperBlocks
|
||||
|
||||
@@ -149,7 +171,7 @@ See the `SuperBlocks` enum at the beginning of the same file for the full list o
|
||||
|
||||
### Configure Search
|
||||
|
||||
Next, open the `client/src/utils/algolia-locale-setup.ts` file. This data is used for the search bar that loads `/news` articles. While it is unlikely that you are going to test this functionality, missing the data for your language can lead to errors when attempting to build the codebase locally.
|
||||
Next, open the [`client/src/utils/algolia-locale-setup.ts`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/client/src/utils/algolia-locale-setup.ts) file. This data is used for the search bar that loads `/news` articles. While it is unlikely that you are going to test this functionality, missing the data for your language can lead to errors when attempting to build the codebase locally.
|
||||
|
||||
Add an object for your language to the `algoliaIndices` object. You should use the the same values as the `english` object for local testing, replacing the `english` key with your language's `availableLangs` value.
|
||||
|
||||
@@ -179,12 +201,52 @@ const algoliaIndices = {
|
||||
name: 'news',
|
||||
searchPage: 'https://www.freecodecamp.org/news/search/'
|
||||
}
|
||||
|
||||
// If we already have /news in the target language up and running, you can update the values like this:
|
||||
// dothraki: {
|
||||
// name: 'news-mis',
|
||||
// searchPage: 'https://www.freecodecamp.org/dothraki/news/search/'
|
||||
// }
|
||||
};
|
||||
```
|
||||
|
||||
### Client UI
|
||||
|
||||
You will need to take an additional step to handle the client UI translations.
|
||||
|
||||
The Crowdin workflows will automatically pull down _some_ of the UI translations, but there are a couple of files that need to be moved manually.
|
||||
|
||||
You will want to copy the following files from [`/client/i18n/locales/english`](https://github.com/freeCodeCamp/freeCodeCamp/tree/main/client/i18n/locales/english) to `/client/i18n/locales/<your-language>`, and apply translations as needed:
|
||||
|
||||
- `links.json`
|
||||
- `meta-tags.json`
|
||||
- `motivation.json`
|
||||
|
||||
You don't have to have everything in these 3 files translated at first. It's possible to translate only the relevant parts and make adjustments later.
|
||||
|
||||
#### `links.json`
|
||||
|
||||
You can replace any URLs that you have corresponding pages ready in your language.
|
||||
|
||||
For example, if you have the publication in your language, you can replace the URL for `"news"`. If you want to translate articles listed in the footer links, see [How to Translate Articles in the Footer Links](language-lead-handbook.md#how-to-translate-articles-in-the-footer-links).
|
||||
|
||||
#### `meta-tags.json`
|
||||
|
||||
This file contains metadata for the web page of `/learn` in your language. You can translate the values for `"title"`, `"description"`, and `"social-description"`. The value for `"youre-unsubscribed"` is used when someone unsubscribes from Quincy's weekly email.
|
||||
|
||||
Also, you can translate or add relevant keywords in your language to the `"keywords"` array.
|
||||
|
||||
#### `motivation.json`
|
||||
|
||||
This file contains the compliments that will be displayed to campers when they complete a challenge, and motivational quotes that are displayed on the top page of `/learn`.
|
||||
|
||||
You can translate them, or even replace them with relevant compliments/quotes of your choice in your language.
|
||||
|
||||
### Enabling Localized Videos
|
||||
|
||||
For the video challenges, you need to change a few things. First, add the new locale to the GraphQL query in the `client/src/templates/Challenges/video/Show.tsx` file. For example, adding Dothraki to the query:
|
||||
This section is applicable only if you have localized videos in the challenges. Otherwise, you can skip this section.
|
||||
|
||||
For the video challenges, you need to change a few things. First, add the new locale to the GraphQL query in the [`client/src/templates/Challenges/video/Show.tsx`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/client/src/templates/Challenges/video/show.tsx) file. For example, adding Dothraki to the query:
|
||||
|
||||
```tsx
|
||||
query VideoChallenge($slug: String!) {
|
||||
@@ -236,18 +298,6 @@ videoLocaleIds: Joi.when('challengeType', {
|
||||
}),
|
||||
```
|
||||
|
||||
## Client UI
|
||||
|
||||
You will need to take an additional step to handle the client UI translations.
|
||||
|
||||
The Crowdin workflows will automatically pull down _some_ of the UI translations, but there are a couple of files that need to be moved manually.
|
||||
|
||||
You will want to copy the following files from `/client/i18n/locales/english` to `/client/i18n/locales/<your-language>`, and apply translations as needed:
|
||||
|
||||
- `links.json`
|
||||
- `meta-tags.json`
|
||||
- `motivation.json`
|
||||
|
||||
## Testing Translations Locally
|
||||
|
||||
If you would like to test translations locally, before adding them to our main repository - skip the Crowdin workflow changes. Follow the steps for enabling a language, then download the translations from Crowdin and load them into your local code.
|
||||
@@ -264,6 +314,18 @@ Once these are in place, you should be able to run `pnpm run develop` to view yo
|
||||
|
||||
> [!ATTENTION] While you may perform translations locally for the purpose of testing, we remind everyone that translations should _not_ be submitted through GitHub and should only be done through Crowdin. Be sure to reset your local codebase after you are done testing.
|
||||
|
||||
## Show the language in the navigation menu
|
||||
|
||||
When your prior PR is merged and the VM for your language is ready, make another PR to show your language in the navigation menu.
|
||||
|
||||
In [`config/i18n.ts`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/config/i18n.ts) file, you have included your language in `hiddenLangs` array in the prior PR. Remove it from the array now.
|
||||
|
||||
```js
|
||||
export const hiddenLangs = []; // Remove your language from the array
|
||||
```
|
||||
|
||||
When this PR is merged and gets deployed, the curriculum in your language will be live.
|
||||
|
||||
# Deploying New Languages on `/news`
|
||||
|
||||
To deploy News for a new language, you'll need to create two PRs. One PR will be to the [CDN repo](https://github.com/freeCodeCamp/cdn), and the other will be to the [News repo](https://github.com/freeCodeCamp/news).
|
||||
|
||||
@@ -1,14 +1,36 @@
|
||||
# Implementando nuevos idiomas en `/learn`
|
||||
|
||||
Antes de poder publicar un nuevo idioma, tendrás que permitir que los idiomas se descarguen de Crowdin.
|
||||
To enable a new language on `/learn` (curriculum), you need to complete the following steps:
|
||||
|
||||
- Complete translating and approving the first 3 certifications on Crowdin. (New Responsive Web Design, JavaScript Algorithms and Data Structures, and Front End Development Libraries)
|
||||
- Complete translating and approving all strings in Learn UI project on Crowdin.
|
||||
- Update Crowdin settings to add a custom language code for the new language.
|
||||
- Open the 1st PR to configure GitHub Actions. You need to update 2 files:
|
||||
- `crowdin-download.client-ui.yml`
|
||||
- `crowdin-download.curriculum.yml`
|
||||
- Open the 2nd PR to add other configurations. You need to update/add the following files:
|
||||
- Update `i18n.ts`
|
||||
- Update `superblocks.ts`
|
||||
- Update `algolia-locale-setup.ts`
|
||||
- Add `links.json`
|
||||
- Add `meta-tags.json`
|
||||
- Add `motivation.json`
|
||||
- Ask infrastructure team to spin up the VM for the new language.
|
||||
- Once the VM is ready, open the 3rd PR to show the new language in the navigation menu.
|
||||
|
||||
We will explain each step in the following sections.
|
||||
|
||||
## Actualizando los ajustes de Crowdin
|
||||
|
||||
En los proyectos `Curriculum` y `Learn UI`, necesitarás seleccionar `Project Settings` en la barra lateral. Luego, busca la opción `Language Mapping`, donde encontrarás la opción de añadir códigos personalizados para los idiomas. Añade una nueva entrada para el idioma que publicarás: seleccionando `language` como el valor de `Placeholder` e ingresando el nombre del idioma en minúsculas para el valor de `Custom code`. Si estás inseguro sobre qué nombre usar, contáctanos en nuestro chat para colaboradores y te ayudaremos.
|
||||
Antes de poder publicar un nuevo idioma, tendrás que permitir que los idiomas se descarguen de Crowdin. To configure that, you need to add a custom language code for your language.
|
||||
|
||||
## Actualizando Workflows
|
||||
In the `Curriculum` and `Learn UI` projects on Crowdin, you will need to select `Settings` > `Languages` from the sidebar. Luego, busca la opción `Language Mapping`, donde encontrarás la opción de añadir códigos personalizados para los idiomas. Añade una nueva entrada para el idioma que publicarás: seleccionando `language` como el valor de `Placeholder` e ingresando el nombre del idioma en minúsculas para el valor de `Custom code`. If you aren't sure what to use, or you don't have an admin role and can't see the settings, reach out in our contributor chat and we will assist you.
|
||||
|
||||
Necesitarás añadir una instrucción al documento `crowdin-download.client-ui.yml` y al documento `crowdin-download.curriculum.yml`. Los pasos a seguir en los dos casos son iguales. Por ejemplo, si quisieras habilitar las descargas de Dothraki, la instrucción a añadir en los dos documentos sería:
|
||||
## Updating Workflows for GitHub Actions
|
||||
|
||||
Then you need to configure the syncing between Crowdin and GitHub.
|
||||
|
||||
You will need to add a step to the [`crowdin-download.client-ui.yml`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/.github/workflows/crowdin-download.client-ui.yml) and [`crowdin-download.curriculum.yml`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/.github/workflows/crowdin-download.curriculum.yml). Los pasos a seguir en los dos casos son iguales. Por ejemplo, si quisieras habilitar las descargas de Dothraki, la instrucción a añadir en los dos documentos sería:
|
||||
|
||||
```yml
|
||||
##### Download Dothraki #####
|
||||
@@ -49,14 +71,14 @@ Ten en cuenta que la opción `download_language` deberá corresponder al código
|
||||
|
||||
Hay algunos pasos a seguir para permitirle a la base de código compilarse a tu idioma de preferencia.
|
||||
|
||||
First, visit the `config/i18n.ts` file to add the language to the list of available languages and configure the values. Aquí hay varios objetos.
|
||||
First, visit the [`config/i18n.ts`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/config/i18n.ts) file to add the language to the list of available languages and configure the values. Aquí hay varios objetos.
|
||||
|
||||
- `Languages`: Add the new language to `Languages` enum, similar to the others. The string value here will be used in the `.env` file to set a build language later.
|
||||
- `availableLangs`: Add the new property from the `Languages` enum to both the `client` and `curriculum` arrays.
|
||||
- `i18nextCodes`: Estos son los códigos de idioma ISO para cada lenguaje. Necesitarás añadir el código ISO correspondiente para el idioma que estás activando. Estos deben ser únicos para cada lenguaje.
|
||||
- `LangNames`: Estos son los nombres mostrados para el selector de idiomas en el menú de navegación.
|
||||
- `LangCodes`: Estos son los códigos de idiomas usados para formatear fechas y números. Estos deben ser códigos Unicode CLDR en vez de los códigos ISO.
|
||||
- `hiddenLangs`: Estos idiomas no se mostrarán en el menú de navegación. Esto es usado para los idiomas que todavía no están listos para su lanzamiento.
|
||||
- `hiddenLangs`: Estos idiomas no se mostrarán en el menú de navegación. Esto es usado para los idiomas que todavía no están listos para su lanzamiento. Include your language in this array in the first PR and ask staff team to prepare the VM instance for your language. When the VM is ready, make another PR to remove it from the array.
|
||||
- `rtlLangs`: These are languages that read from right to left.
|
||||
|
||||
As an example, if you wanted to enable Dothraki as a language, your `i18n.ts` objects should look like this:
|
||||
@@ -116,7 +138,7 @@ export const hiddenLangs = ['dothraki'];
|
||||
export const rtlLangs = [''];
|
||||
```
|
||||
|
||||
> [!NOTE] Cuando un lenguage ha sido configurado en el pipeline de despliegue Y se ha publicado como `/news`, puede ser quitado del arreglo `hiddenLangs` y puede ser disponible para el público.
|
||||
> [!NOTE] When a language has been set up in the deployment pipeline AND has a public `/learn` instance live, it can be removed from the `hiddenLangs` array and be made available to the public.
|
||||
|
||||
### Set Translated SuperBlocks
|
||||
|
||||
@@ -149,7 +171,7 @@ See the `SuperBlocks` enum at the beginning of the same file for the full list o
|
||||
|
||||
### Configure Search
|
||||
|
||||
A continuación, abre el archivo: `client/src/utils/algolia-locale-setup.ts`. Estos datos son utilizados por la barra de búsqueda que carga artículos de `/news`. Si bien es poco probable que vayas a probar esta funcionalidad, lea falta de datos para tu lenguaje puede llevarle a errores al intentar construir el código base localmente.
|
||||
Next, open the [`client/src/utils/algolia-locale-setup.ts`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/client/src/utils/algolia-locale-setup.ts) file. Estos datos son utilizados por la barra de búsqueda que carga artículos de `/news`. Si bien es poco probable que vayas a probar esta funcionalidad, lea falta de datos para tu lenguaje puede llevarle a errores al intentar construir el código base localmente.
|
||||
|
||||
Agrega un objeto para al objeto `algoliaIndices`. Deberñias usar los mismos valores del objeto `english` para pruebas locales, remplazando la clave `english` con el valor `avalaibleLangs` para tu idioma.
|
||||
|
||||
@@ -179,12 +201,52 @@ const algoliaIndices = {
|
||||
name: 'news',
|
||||
searchPage: 'https://www.freecodecamp.org/news/search/'
|
||||
}
|
||||
|
||||
// If we already have /news in the target language up and running, you can update the values like this:
|
||||
// dothraki: {
|
||||
// name: 'news-mis',
|
||||
// searchPage: 'https://www.freecodecamp.org/dothraki/news/search/'
|
||||
// }
|
||||
};
|
||||
```
|
||||
|
||||
### Client UI
|
||||
|
||||
Necesitará dar un paso adicional para manejar las traducciones de la interfaz de usuario del cliente.
|
||||
|
||||
Los flujos de trabajo de Crowdin bajarán automáticamente _algunas_ traducciones de la interfaz de usuario, pero hay un par de ficheros que necesitan ser movidos manualmente.
|
||||
|
||||
You will want to copy the following files from [`/client/i18n/locales/english`](https://github.com/freeCodeCamp/freeCodeCamp/tree/main/client/i18n/locales/english) to `/client/i18n/locales/<your-language>`, and apply translations as needed:
|
||||
|
||||
- `links.json`
|
||||
- `meta-tags.json`
|
||||
- `motivation.json`
|
||||
|
||||
You don't have to have everything in these 3 files translated at first. It's possible to translate only the relevant parts and make adjustments later.
|
||||
|
||||
#### `links.json`
|
||||
|
||||
You can replace any URLs that you have corresponding pages ready in your language.
|
||||
|
||||
For example, if you have the publication in your language, you can replace the URL for `"news"`. If you want to translate articles listed in the footer links, see [How to Translate Articles in the Footer Links](language-lead-handbook.md#how-to-translate-articles-in-the-footer-links).
|
||||
|
||||
#### `meta-tags.json`
|
||||
|
||||
This file contains metadata for the web page of `/learn` in your language. You can translate the values for `"title"`, `"description"`, and `"social-description"`. The value for `"youre-unsubscribed"` is used when someone unsubscribes from Quincy's weekly email.
|
||||
|
||||
Also, you can translate or add relevant keywords in your language to the `"keywords"` array.
|
||||
|
||||
#### `motivation.json`
|
||||
|
||||
This file contains the compliments that will be displayed to campers when they complete a challenge, and motivational quotes that are displayed on the top page of `/learn`.
|
||||
|
||||
You can translate them, or even replace them with relevant compliments/quotes of your choice in your language.
|
||||
|
||||
### Enabling Localized Videos
|
||||
|
||||
Para los desafìos de video, debe cambiar algunas cosas. First, add the new locale to the GraphQL query in the `client/src/templates/Challenges/video/Show.tsx` file. Por ejemplo, agregando a Dothraki para la consulta:
|
||||
This section is applicable only if you have localized videos in the challenges. Otherwise, you can skip this section.
|
||||
|
||||
Para los desafìos de video, debe cambiar algunas cosas. First, add the new locale to the GraphQL query in the [`client/src/templates/Challenges/video/Show.tsx`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/client/src/templates/Challenges/video/show.tsx) file. Por ejemplo, agregando a Dothraki para la consulta:
|
||||
|
||||
```tsx
|
||||
query VideoChallenge($slug: String!) {
|
||||
@@ -236,18 +298,6 @@ videoLocaleIds: Joi.when('challengeType', {
|
||||
}),
|
||||
```
|
||||
|
||||
## Client UI
|
||||
|
||||
Necesitará dar un paso adicional para manejar las traducciones de la interfaz de usuario del cliente.
|
||||
|
||||
Los flujos de trabajo de Crowdin bajarán automáticamente _algunas_ traducciones de la interfaz de usuario, pero hay un par de ficheros que necesitan ser movidos manualmente.
|
||||
|
||||
Usted quedrá copiar los siguientes archivos desde `/client/i18n/locales/english` a `/client/i18n/locales/<your-language>` y aplicar las traducciones según sea necesario:
|
||||
|
||||
- `links.json`
|
||||
- `meta-tags.json`
|
||||
- `motivation.json`
|
||||
|
||||
## Testing Translations Locally
|
||||
|
||||
Si desea probar las traducciones localmente, antes de añadirlas a nuestro repositorio principal, salte los cambios del flujo de trabajo de Crowdin. Siga los pasos para activar un idioma, luego descargue las traducciones de Crowdin y cargue las traducciones en su código local.
|
||||
@@ -264,6 +314,18 @@ Once these are in place, you should be able to run `pnpm run develop` to view yo
|
||||
|
||||
> [!ATTENTION] Si bien puedes realizar traducciones localmente con motivos de prueba, le recordamos a todos que las traducciones _no_ deben ser enviadas a través de GitHub, estas deben ser enviadas únicamente a traves de Crowdin. Asegúrate de reestablecer tu base de código local despues de que hayas finalizado con las pruebas.
|
||||
|
||||
## Show the language in the navigation menu
|
||||
|
||||
When your prior PR is merged and the VM for your language is ready, make another PR to show your language in the navigation menu.
|
||||
|
||||
In [`config/i18n.ts`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/config/i18n.ts) file, you have included your language in `hiddenLangs` array in the prior PR. Remove it from the array now.
|
||||
|
||||
```js
|
||||
export const hiddenLangs = []; // Remove your language from the array
|
||||
```
|
||||
|
||||
When this PR is merged and gets deployed, the curriculum in your language will be live.
|
||||
|
||||
# Deploying New Languages on `/news`
|
||||
|
||||
To deploy News for a new language, you'll need to create two PRs. One PR will be to the [CDN repo](https://github.com/freeCodeCamp/cdn), and the other will be to the [News repo](https://github.com/freeCodeCamp/news).
|
||||
|
||||
@@ -1,14 +1,36 @@
|
||||
# Neue Sprachen auf `/learn` bereitstellen
|
||||
|
||||
Bevor du eine neue Sprache freigeben kannst, musst du zulassen, dass die Sprachen von Crowdin heruntergeladen werden können.
|
||||
To enable a new language on `/learn` (curriculum), you need to complete the following steps:
|
||||
|
||||
- Complete translating and approving the first 3 certifications on Crowdin. (New Responsive Web Design, JavaScript Algorithms and Data Structures, and Front End Development Libraries)
|
||||
- Complete translating and approving all strings in Learn UI project on Crowdin.
|
||||
- Update Crowdin settings to add a custom language code for the new language.
|
||||
- Open the 1st PR to configure GitHub Actions. You need to update 2 files:
|
||||
- `crowdin-download.client-ui.yml`
|
||||
- `crowdin-download.curriculum.yml`
|
||||
- Open the 2nd PR to add other configurations. You need to update/add the following files:
|
||||
- Update `i18n.ts`
|
||||
- Update `superblocks.ts`
|
||||
- Update `algolia-locale-setup.ts`
|
||||
- Add `links.json`
|
||||
- Add `meta-tags.json`
|
||||
- Add `motivation.json`
|
||||
- Ask infrastructure team to spin up the VM for the new language.
|
||||
- Once the VM is ready, open the 3rd PR to show the new language in the navigation menu.
|
||||
|
||||
We will explain each step in the following sections.
|
||||
|
||||
## Aktualisierung der Crowdin-Einstellungen
|
||||
|
||||
In den Projekten `Curriculum` und `Learn UI` musst du `Project Settings` in der Seitenleiste auswählen. Danach scrollst du nach unten zu `Language Mapping`, wo du eine Option zum Hinzufügen eigener Sprachcodes findest. Füge einen neuen Eintrag für die Sprache hinzu, die du veröffentlichen willst, indem du `language` als `Placeholder`-Wert auswählst und eine URL-freundliche Kleinschreibung des Namens deiner Sprache für den `Custom code` einträgst. Wenn du dir nicht sicher bist, was du verwenden sollst, melde dich in unserem "Contributor"-Chat und wir werden dir helfen.
|
||||
Bevor du eine neue Sprache freigeben kannst, musst du zulassen, dass die Sprachen von Crowdin heruntergeladen werden können. To configure that, you need to add a custom language code for your language.
|
||||
|
||||
## Workflows aktualisieren
|
||||
In the `Curriculum` and `Learn UI` projects on Crowdin, you will need to select `Settings` > `Languages` from the sidebar. Danach scrollst du nach unten zu `Language Mapping`, wo du eine Option zum Hinzufügen eigener Sprachcodes findest. Füge einen neuen Eintrag für die Sprache hinzu, die du veröffentlichen willst, indem du `language` als `Placeholder`-Wert auswählst und eine URL-freundliche Kleinschreibung des Namens deiner Sprache für den `Custom code` einträgst. If you aren't sure what to use, or you don't have an admin role and can't see the settings, reach out in our contributor chat and we will assist you.
|
||||
|
||||
Du musst einen Schritt in der `crowdin-download.client-ui.yml` und `crowdin-download.curriculum.yml` hinzufügen. Der Schritt für die beiden ist der gleiche. Zum Beispiel, wenn du Dothraki-Downloads aktivieren möchtest:
|
||||
## Updating Workflows for GitHub Actions
|
||||
|
||||
Then you need to configure the syncing between Crowdin and GitHub.
|
||||
|
||||
You will need to add a step to the [`crowdin-download.client-ui.yml`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/.github/workflows/crowdin-download.client-ui.yml) and [`crowdin-download.curriculum.yml`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/.github/workflows/crowdin-download.curriculum.yml). Der Schritt für die beiden ist der gleiche. Zum Beispiel, wenn du Dothraki-Downloads aktivieren möchtest:
|
||||
|
||||
```yml
|
||||
##### Download Dothraki #####
|
||||
@@ -49,14 +71,14 @@ Beachte, dass der Schlüssel `download_language` auf den Sprachcode festgelegt w
|
||||
|
||||
Es gibt ein paar Schritte, die du unternehmen musst, damit die Codebasis in deiner gewünschten Sprache erstellt werden kann.
|
||||
|
||||
First, visit the `config/i18n.ts` file to add the language to the list of available languages and configure the values. Hier gibt es mehrere Objekte.
|
||||
First, visit the [`config/i18n.ts`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/config/i18n.ts) file to add the language to the list of available languages and configure the values. Hier gibt es mehrere Objekte.
|
||||
|
||||
- `Languages`: Add the new language to `Languages` enum, similar to the others. The string value here will be used in the `.env` file to set a build language later.
|
||||
- `availableLangs`: Add the new property from the `Languages` enum to both the `client` and `curriculum` arrays.
|
||||
- `i18nextCodes`: Dies sind die ISO-Sprachcodes für jede Sprache. Du musst den entsprechenden ISO-Code für die Sprache hinzufügen, die du aktivieren möchtest. Diese müssen für jede Sprache einzigartig sein.
|
||||
- `LangNames`: Dies sind die Anzeigenamen für die Sprachauswahl im Navigationsmenü.
|
||||
- `LangCodes`: Dies sind die Sprachcodes, die für die Formatierung von Datumsangaben und Zahlen verwendet werden. Dies sollten Unicode CLDR-Codes statt ISO-Codes sein.
|
||||
- `hiddenLangs`: Diese Sprachen werden im Navigationsmenü nicht angezeigt. Dies wird für Sprachen verwendet, die noch nicht zur Veröffentlichung bereit sind.
|
||||
- `hiddenLangs`: Diese Sprachen werden im Navigationsmenü nicht angezeigt. Dies wird für Sprachen verwendet, die noch nicht zur Veröffentlichung bereit sind. Include your language in this array in the first PR and ask staff team to prepare the VM instance for your language. When the VM is ready, make another PR to remove it from the array.
|
||||
- `rtlLangs`: These are languages that read from right to left.
|
||||
|
||||
As an example, if you wanted to enable Dothraki as a language, your `i18n.ts` objects should look like this:
|
||||
@@ -116,7 +138,7 @@ export const hiddenLangs = ['dothraki'];
|
||||
export const rtlLangs = [''];
|
||||
```
|
||||
|
||||
> [!NOTE] Wenn eine Sprache in der Deployment-Pipeline eingerichtet wurde UND eine öffentliche `/news`-Instanz live ist, kann sie aus dem `hiddenLangs`-Array entfernt und der Öffentlichkeit zugänglich gemacht werden.
|
||||
> [!NOTE] When a language has been set up in the deployment pipeline AND has a public `/learn` instance live, it can be removed from the `hiddenLangs` array and be made available to the public.
|
||||
|
||||
### Set Translated SuperBlocks
|
||||
|
||||
@@ -149,7 +171,7 @@ See the `SuperBlocks` enum at the beginning of the same file for the full list o
|
||||
|
||||
### Configure Search
|
||||
|
||||
Als nächstes öffnest du die Datei `client/src/utils/algolia-locale-setup.ts`. Diese Daten werden für die Suchleiste verwendet, die `/news `-Artikel lädt. Es ist zwar unwahrscheinlich, dass du diese Funktion testen wirst, aber das Fehlen der Daten für deine Sprache kann zu Fehlern führen, wenn du versuchst, die Codebasis lokal zu erstellen.
|
||||
Next, open the [`client/src/utils/algolia-locale-setup.ts`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/client/src/utils/algolia-locale-setup.ts) file. Diese Daten werden für die Suchleiste verwendet, die `/news `-Artikel lädt. Es ist zwar unwahrscheinlich, dass du diese Funktion testen wirst, aber das Fehlen der Daten für deine Sprache kann zu Fehlern führen, wenn du versuchst, die Codebasis lokal zu erstellen.
|
||||
|
||||
Füge ein Objekt für deine Sprache zum `algoliaIndices`-Objekt hinzu. Du solltest die gleichen Werte wie das `english`-Objekt für lokale Tests verwenden, indem du den `english`-Schlüssel durch den `availableLangs`-Wert deiner Sprache ersetzt.
|
||||
|
||||
@@ -179,12 +201,52 @@ const algoliaIndices = {
|
||||
name: 'news',
|
||||
searchPage: 'https://www.freecodecamp.org/news/search/'
|
||||
}
|
||||
|
||||
// If we already have /news in the target language up and running, you can update the values like this:
|
||||
// dothraki: {
|
||||
// name: 'news-mis',
|
||||
// searchPage: 'https://www.freecodecamp.org/dothraki/news/search/'
|
||||
// }
|
||||
};
|
||||
```
|
||||
|
||||
### Client UI
|
||||
|
||||
Du musst einen zusätzlichen Schritt unternehmen, um die Übersetzungen der Client-UI zu übernehmen.
|
||||
|
||||
Die Crowdin-Workflows ziehen automatisch _einige_ der UI-Übersetzungen herunter, aber es gibt ein paar Dateien, die manuell verschoben werden müssen.
|
||||
|
||||
You will want to copy the following files from [`/client/i18n/locales/english`](https://github.com/freeCodeCamp/freeCodeCamp/tree/main/client/i18n/locales/english) to `/client/i18n/locales/<your-language>`, and apply translations as needed:
|
||||
|
||||
- `links.json`
|
||||
- `meta-tags.json`
|
||||
- `motivation.json`
|
||||
|
||||
You don't have to have everything in these 3 files translated at first. It's possible to translate only the relevant parts and make adjustments later.
|
||||
|
||||
#### `links.json`
|
||||
|
||||
You can replace any URLs that you have corresponding pages ready in your language.
|
||||
|
||||
For example, if you have the publication in your language, you can replace the URL for `"news"`. If you want to translate articles listed in the footer links, see [How to Translate Articles in the Footer Links](language-lead-handbook.md#how-to-translate-articles-in-the-footer-links).
|
||||
|
||||
#### `meta-tags.json`
|
||||
|
||||
This file contains metadata for the web page of `/learn` in your language. You can translate the values for `"title"`, `"description"`, and `"social-description"`. The value for `"youre-unsubscribed"` is used when someone unsubscribes from Quincy's weekly email.
|
||||
|
||||
Also, you can translate or add relevant keywords in your language to the `"keywords"` array.
|
||||
|
||||
#### `motivation.json`
|
||||
|
||||
This file contains the compliments that will be displayed to campers when they complete a challenge, and motivational quotes that are displayed on the top page of `/learn`.
|
||||
|
||||
You can translate them, or even replace them with relevant compliments/quotes of your choice in your language.
|
||||
|
||||
### Enabling Localized Videos
|
||||
|
||||
Für die Videoaufgaben musst du ein paar Dinge ändern. First, add the new locale to the GraphQL query in the `client/src/templates/Challenges/video/Show.tsx` file. Zum Beispiel, indem man Dothraki zur Abfrage hinzufügt:
|
||||
This section is applicable only if you have localized videos in the challenges. Otherwise, you can skip this section.
|
||||
|
||||
Für die Videoaufgaben musst du ein paar Dinge ändern. First, add the new locale to the GraphQL query in the [`client/src/templates/Challenges/video/Show.tsx`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/client/src/templates/Challenges/video/show.tsx) file. Zum Beispiel, indem man Dothraki zur Abfrage hinzufügt:
|
||||
|
||||
```tsx
|
||||
query VideoChallenge($slug: String!) {
|
||||
@@ -236,18 +298,6 @@ videoLocaleIds: Joi.when('challengeType', {
|
||||
}),
|
||||
```
|
||||
|
||||
## Client UI
|
||||
|
||||
Du musst einen zusätzlichen Schritt unternehmen, um die Übersetzungen der Client-UI zu übernehmen.
|
||||
|
||||
Die Crowdin-Workflows ziehen automatisch _einige_ der UI-Übersetzungen herunter, aber es gibt ein paar Dateien, die manuell verschoben werden müssen.
|
||||
|
||||
Du musst die folgenden Dateien von `/client/i18n/locales/english` nach `/client/i18n/locales/<deine-Sprache>` kopieren und die Übersetzungen nach Bedarf durchführen:
|
||||
|
||||
- `links.json`
|
||||
- `meta-tags.json`
|
||||
- `motivation.json`
|
||||
|
||||
## Testing Translations Locally
|
||||
|
||||
Wenn du Übersetzungen lokal testen möchtest, bevor du sie zu unserem main-Repository hinzufügst, kannst du die Änderungen am Crowdin-Workflow überspringen. Folge den Schritten zur Aktivierung einer Sprache, lade dann die Übersetzungen von Crowdin herunter und lade sie in deinen lokalen Code.
|
||||
@@ -264,6 +314,18 @@ Once these are in place, you should be able to run `pnpm run develop` to view yo
|
||||
|
||||
> [!ATTENTION] Du kannst zwar lokal Übersetzungen zu Testzwecken vornehmen, aber wir erinnern alle daran, dass Übersetzungen _nicht_ über GitHub eingereicht werden sollten und nur über Crowdin erfolgen sollten. Achte darauf, dass du deine lokale Codebasis zurücksetzt, wenn du mit dem Testen fertig bist.
|
||||
|
||||
## Show the language in the navigation menu
|
||||
|
||||
When your prior PR is merged and the VM for your language is ready, make another PR to show your language in the navigation menu.
|
||||
|
||||
In [`config/i18n.ts`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/config/i18n.ts) file, you have included your language in `hiddenLangs` array in the prior PR. Remove it from the array now.
|
||||
|
||||
```js
|
||||
export const hiddenLangs = []; // Remove your language from the array
|
||||
```
|
||||
|
||||
When this PR is merged and gets deployed, the curriculum in your language will be live.
|
||||
|
||||
# Neue Sprachen auf `/news` bereitstellen
|
||||
|
||||
Um die News für eine neue Sprache bereitzustellen, musst du zwei PRs erstellen. Ein PR geht an das [CDN Repo](https://github.com/freeCodeCamp/cdn) und der andere an das [News Repo](https://github.com/freeCodeCamp/news).
|
||||
|
||||
@@ -1,14 +1,36 @@
|
||||
# Rilasciare nuove lingue su `/learn`
|
||||
|
||||
Prima di poter rilasciare una nuova lingua, è necessario consentire alle lingue di fare il download da Crowdin.
|
||||
To enable a new language on `/learn` (curriculum), you need to complete the following steps:
|
||||
|
||||
- Complete translating and approving the first 3 certifications on Crowdin. (New Responsive Web Design, JavaScript Algorithms and Data Structures, and Front End Development Libraries)
|
||||
- Complete translating and approving all strings in Learn UI project on Crowdin.
|
||||
- Update Crowdin settings to add a custom language code for the new language.
|
||||
- Open the 1st PR to configure GitHub Actions. You need to update 2 files:
|
||||
- `crowdin-download.client-ui.yml`
|
||||
- `crowdin-download.curriculum.yml`
|
||||
- Open the 2nd PR to add other configurations. You need to update/add the following files:
|
||||
- Update `i18n.ts`
|
||||
- Update `superblocks.ts`
|
||||
- Update `algolia-locale-setup.ts`
|
||||
- Add `links.json`
|
||||
- Add `meta-tags.json`
|
||||
- Add `motivation.json`
|
||||
- Ask infrastructure team to spin up the VM for the new language.
|
||||
- Once the VM is ready, open the 3rd PR to show the new language in the navigation menu.
|
||||
|
||||
We will explain each step in the following sections.
|
||||
|
||||
## Aggiornare le impostazioni di Crowdin
|
||||
|
||||
Nei progetti `Curriculum` e `Learn UI`, dovrai selezionare `Project Settings` dalla barra laterale. Poi scorri fino a `Language Mapping`, dove vedrai un'opzione per aggiungere dei codici personalizzati per le lingue. Aggiungi una nuova voce per la lingua che vuoi rilasciare, selezionando `language` come valore `Placeholder` e inserendo il nome della lingua in minuscolo e in un formato adatto a un URL per il `Custom code`. Se non sei sicuro di cosa usare, contattaci nella chat per contributori e ti aiuteremo.
|
||||
Prima di poter rilasciare una nuova lingua, è necessario consentire alle lingue di fare il download da Crowdin. To configure that, you need to add a custom language code for your language.
|
||||
|
||||
## Aggiornare i processi automatici
|
||||
In the `Curriculum` and `Learn UI` projects on Crowdin, you will need to select `Settings` > `Languages` from the sidebar. Poi scorri fino a `Language Mapping`, dove vedrai un'opzione per aggiungere dei codici personalizzati per le lingue. Aggiungi una nuova voce per la lingua che vuoi rilasciare, selezionando `language` come valore `Placeholder` e inserendo il nome della lingua in minuscolo e in un formato adatto a un URL per il `Custom code`. If you aren't sure what to use, or you don't have an admin role and can't see the settings, reach out in our contributor chat and we will assist you.
|
||||
|
||||
Dovrai aggiungere uno step a `crowdin-download.client-ui.yml` e `crowdin-download.curriculum.yml`. Lo step sarà lo stesso per entrambi. Ad esempio, se vuoi abilitare il download per il Dothraki:
|
||||
## Updating Workflows for GitHub Actions
|
||||
|
||||
Then you need to configure the syncing between Crowdin and GitHub.
|
||||
|
||||
You will need to add a step to the [`crowdin-download.client-ui.yml`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/.github/workflows/crowdin-download.client-ui.yml) and [`crowdin-download.curriculum.yml`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/.github/workflows/crowdin-download.curriculum.yml). Lo step sarà lo stesso per entrambi. Ad esempio, se vuoi abilitare il download per il Dothraki:
|
||||
|
||||
```yml
|
||||
##### Download Dothraki #####
|
||||
@@ -49,14 +71,14 @@ Nota che la chiave `download_language` deve essere impostata sul codice della li
|
||||
|
||||
Ci sono alcuni step da svolgere per consentire il build del codebase nella lingua scelta.
|
||||
|
||||
Per prima cosa, visita il file `config/i18n.ts` per aggiungere la lingua alla lista delle lingue disponibili e configurare i valori. Qui ci sono diversi oggetti.
|
||||
First, visit the [`config/i18n.ts`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/config/i18n.ts) file to add the language to the list of available languages and configure the values. Qui ci sono diversi oggetti.
|
||||
|
||||
- `Languages`: Aggiunge la nuova lingua all'enum `Languages` simile agli altri. Il valore della stringa qui sarà usato nel file `.env` per impostare un build della lingua in seguito.
|
||||
- `availableLangs`: Aggiunge la nuova proprietà dall'enum `Languages` a entrambi gli array `client` e `curriculum`.
|
||||
- `i18nextCodes`: Questi sono i codici ISO per le varie lingue. Dovrai aggiungere il codice ISO appropriato per la lingua che stai attivando. Devono essere unici per ogni lingua.
|
||||
- `LangNames`: Questi sono i nomi delle lingue visualizzati nel menu di navigazione.
|
||||
- `LangCodes`: Questi sono i codici delle lingue usati per formattare date e numeri. Questi devono essere codici Unicode CLDR invece di codici ISO.
|
||||
- `hiddenLangs`: Queste lingue non saranno mostrate nel menu di navigazione. Viene usato per le lingue che non sono ancora pronte per il rilascio.
|
||||
- `hiddenLangs`: Queste lingue non saranno mostrate nel menu di navigazione. Viene usato per le lingue che non sono ancora pronte per il rilascio. Include your language in this array in the first PR and ask staff team to prepare the VM instance for your language. When the VM is ready, make another PR to remove it from the array.
|
||||
- `rtlLangs`: Sono le lingue che si leggono da destra a sinistra.
|
||||
|
||||
Per esempio, se vuoi attivare la lingua Dothraki, il tuo oggetto `i18n.ts` dovrebbe essere come segue:
|
||||
@@ -116,7 +138,7 @@ export const hiddenLangs = ['dothraki'];
|
||||
export const rtlLangs = [''];
|
||||
```
|
||||
|
||||
> [!NOTE] Quando è stato impostato il deployment per una lingua che ha già una sezione `/news` live, può essere rimossa dall'array `hiddenLangs` e resa disponibile al pubblico.
|
||||
> [!NOTE] When a language has been set up in the deployment pipeline AND has a public `/learn` instance live, it can be removed from the `hiddenLangs` array and be made available to the public.
|
||||
|
||||
### Set Translated SuperBlocks
|
||||
|
||||
@@ -149,7 +171,7 @@ See the `SuperBlocks` enum at the beginning of the same file for the full list o
|
||||
|
||||
### Configurare la ricerca
|
||||
|
||||
Poi, apri il file `client/src/utils/algolia-locale-setup.ts`. Questi dati sono usati dalla barra di ricerca che carica gli articoli in `/news`. Anche se è poco probabile che tu stia testando questa funzione, se questi dati mancano per la tua lingua possono esserci degli errori nel costruire il codebase localmente.
|
||||
Next, open the [`client/src/utils/algolia-locale-setup.ts`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/client/src/utils/algolia-locale-setup.ts) file. Questi dati sono usati dalla barra di ricerca che carica gli articoli in `/news`. Anche se è poco probabile che tu stia testando questa funzione, se questi dati mancano per la tua lingua possono esserci degli errori nel costruire il codebase localmente.
|
||||
|
||||
Aggiungi un oggetto per la tua lingua all'oggetto `algoliaIndices`. Dovresti usare gli stessi valori dell'oggetto `english` per testare in locale, sostituendo la chiave `english` con il valore della tua lingua in `availableLangs`.
|
||||
|
||||
@@ -179,12 +201,52 @@ const algoliaIndices = {
|
||||
name: 'news',
|
||||
searchPage: 'https://www.freecodecamp.org/news/search/'
|
||||
}
|
||||
|
||||
// If we already have /news in the target language up and running, you can update the values like this:
|
||||
// dothraki: {
|
||||
// name: 'news-mis',
|
||||
// searchPage: 'https://www.freecodecamp.org/dothraki/news/search/'
|
||||
// }
|
||||
};
|
||||
```
|
||||
|
||||
### Client UI
|
||||
|
||||
Dovrai fare un ulteriore passo per gestire le traduzioni dell'interfaccia utente client.
|
||||
|
||||
I processi automatici scaricano da Crowdin _una parte_ delle traduzioni dell'interfaccia, ma ci sono alcuni file che devono essere creati manualmente.
|
||||
|
||||
You will want to copy the following files from [`/client/i18n/locales/english`](https://github.com/freeCodeCamp/freeCodeCamp/tree/main/client/i18n/locales/english) to `/client/i18n/locales/<your-language>`, and apply translations as needed:
|
||||
|
||||
- `links.json`
|
||||
- `meta-tags.json`
|
||||
- `motivation.json`
|
||||
|
||||
You don't have to have everything in these 3 files translated at first. It's possible to translate only the relevant parts and make adjustments later.
|
||||
|
||||
#### `links.json`
|
||||
|
||||
You can replace any URLs that you have corresponding pages ready in your language.
|
||||
|
||||
For example, if you have the publication in your language, you can replace the URL for `"news"`. If you want to translate articles listed in the footer links, see [How to Translate Articles in the Footer Links](language-lead-handbook.md#how-to-translate-articles-in-the-footer-links).
|
||||
|
||||
#### `meta-tags.json`
|
||||
|
||||
This file contains metadata for the web page of `/learn` in your language. You can translate the values for `"title"`, `"description"`, and `"social-description"`. The value for `"youre-unsubscribed"` is used when someone unsubscribes from Quincy's weekly email.
|
||||
|
||||
Also, you can translate or add relevant keywords in your language to the `"keywords"` array.
|
||||
|
||||
#### `motivation.json`
|
||||
|
||||
This file contains the compliments that will be displayed to campers when they complete a challenge, and motivational quotes that are displayed on the top page of `/learn`.
|
||||
|
||||
You can translate them, or even replace them with relevant compliments/quotes of your choice in your language.
|
||||
|
||||
### Enabling Localized Videos
|
||||
|
||||
Per le sfide video, devi cambiare alcune cose. First, add the new locale to the GraphQL query in the `client/src/templates/Challenges/video/Show.tsx` file. Per esempio, in questo modo aggiungeresti Dothraki alla query:
|
||||
This section is applicable only if you have localized videos in the challenges. Otherwise, you can skip this section.
|
||||
|
||||
Per le sfide video, devi cambiare alcune cose. First, add the new locale to the GraphQL query in the [`client/src/templates/Challenges/video/Show.tsx`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/client/src/templates/Challenges/video/show.tsx) file. Per esempio, in questo modo aggiungeresti Dothraki alla query:
|
||||
|
||||
```tsx
|
||||
query VideoChallenge($slug: String!) {
|
||||
@@ -236,18 +298,6 @@ videoLocaleIds: Joi.when('challengeType', {
|
||||
}),
|
||||
```
|
||||
|
||||
## Client UI
|
||||
|
||||
Dovrai fare un ulteriore passo per gestire le traduzioni dell'interfaccia utente client.
|
||||
|
||||
I processi automatici scaricano da Crowdin _una parte_ delle traduzioni dell'interfaccia, ma ci sono alcuni file che devono essere creati manualmente.
|
||||
|
||||
Dovrai copiare i seguenti file da `/client/i18n/locales/english` a `/client/i18n/locales/<your-language>` e applicare le traduzioni se necessario:
|
||||
|
||||
- `links.json`
|
||||
- `meta-tags.json`
|
||||
- `motivation.json`
|
||||
|
||||
## Testing Translations Locally
|
||||
|
||||
Se desideri testare le traduzioni localmente, prima di aggiungerle al nostro repository principale - salta i cambiamenti delle procedure di Crowdin. Segui i passaggi per abilitare una lingua, quindi scarica le traduzioni da Crowdin e caricale nel tuo codice locale.
|
||||
@@ -264,6 +314,18 @@ Una volta che questi saranno in posizione, dovresti essere in grado di eseguire
|
||||
|
||||
> [!ATTENTION] Anche se puoi farei delle traduzioni localmente per i test, ricordiamo che le traduzioni _non_ devono essere inviate attraverso GitHub ma solo tramite Crowdin. Assicurati di resettare il tuo codebase locale dopo che avrai finito con i test.
|
||||
|
||||
## Show the language in the navigation menu
|
||||
|
||||
When your prior PR is merged and the VM for your language is ready, make another PR to show your language in the navigation menu.
|
||||
|
||||
In [`config/i18n.ts`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/config/i18n.ts) file, you have included your language in `hiddenLangs` array in the prior PR. Remove it from the array now.
|
||||
|
||||
```js
|
||||
export const hiddenLangs = []; // Remove your language from the array
|
||||
```
|
||||
|
||||
When this PR is merged and gets deployed, the curriculum in your language will be live.
|
||||
|
||||
# Rilasciare nuove lingue su `/learn`
|
||||
|
||||
Per distribuire News per una nuova lingua, dovrai creare due PR. Una Pr sarà al [repo CDN](https://github.com/freeCodeCamp/cdn), e l'altra sarà al [repo News](https://github.com/freeCodeCamp/news).
|
||||
|
||||
@@ -1,14 +1,36 @@
|
||||
# Deploying New Languages on `/learn`
|
||||
|
||||
Before you can release a new language, you will need to allow the languages to download from Crowdin.
|
||||
To enable a new language on `/learn` (curriculum), you need to complete the following steps:
|
||||
|
||||
- Complete translating and approving the first 3 certifications on Crowdin. (New Responsive Web Design, JavaScript Algorithms and Data Structures, and Front End Development Libraries)
|
||||
- Complete translating and approving all strings in Learn UI project on Crowdin.
|
||||
- Update Crowdin settings to add a custom language code for the new language.
|
||||
- Open the 1st PR to configure GitHub Actions. You need to update 2 files:
|
||||
- `crowdin-download.client-ui.yml`
|
||||
- `crowdin-download.curriculum.yml`
|
||||
- Open the 2nd PR to add other configurations. You need to update/add the following files:
|
||||
- Update `i18n.ts`
|
||||
- Update `superblocks.ts`
|
||||
- Update `algolia-locale-setup.ts`
|
||||
- Add `links.json`
|
||||
- Add `meta-tags.json`
|
||||
- Add `motivation.json`
|
||||
- Ask infrastructure team to spin up the VM for the new language.
|
||||
- Once the VM is ready, open the 3rd PR to show the new language in the navigation menu.
|
||||
|
||||
We will explain each step in the following sections.
|
||||
|
||||
## Updating Crowdin Settings
|
||||
|
||||
In the `Curriculum` and `Learn UI` projects, you will need to select `Project Settings` from the sidebar. Then scroll down to `Language Mapping`, where you will see an option to add custom language codes. Add a new entry for the language you are releasing, selecting `language` as the `Placeholder` value, and entering a URL-friendly lower-case spelling of your language's name for the `Custom code`. If you aren't sure what to use, reach out in our contributor chat and we will assist you.
|
||||
Before you can release a new language, you will need to allow the languages to download from Crowdin. To configure that, you need to add a custom language code for your language.
|
||||
|
||||
## Updating Workflows
|
||||
In the `Curriculum` and `Learn UI` projects on Crowdin, you will need to select `Settings` > `Languages` from the sidebar. Then scroll down to `Language Mapping`, where you will see an option to add custom language codes. Add a new entry for the language you are releasing, selecting `language` as the `Placeholder` value, and entering a URL-friendly lower-case spelling of your language's name for the `Custom code`. If you aren't sure what to use, or you don't have an admin role and can't see the settings, reach out in our contributor chat and we will assist you.
|
||||
|
||||
You will need to add a step to the `crowdin-download.client-ui.yml` and `crowdin-download.curriculum.yml`. The step for these will be the same. For example, if you want to enable Dothraki downloads:
|
||||
## Updating Workflows for GitHub Actions
|
||||
|
||||
Then you need to configure the syncing between Crowdin and GitHub.
|
||||
|
||||
You will need to add a step to the [`crowdin-download.client-ui.yml`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/.github/workflows/crowdin-download.client-ui.yml) and [`crowdin-download.curriculum.yml`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/.github/workflows/crowdin-download.curriculum.yml). The step for these will be the same. For example, if you want to enable Dothraki downloads:
|
||||
|
||||
```yml
|
||||
##### Download Dothraki #####
|
||||
@@ -49,14 +71,14 @@ Note that the `download_language` key needs to be set to the language code displ
|
||||
|
||||
There are a few steps to take in order to allow the codebase to build in your desired language.
|
||||
|
||||
First, visit the `config/i18n.ts` file to add the language to the list of available languages and configure the values. There are several objects here.
|
||||
First, visit the [`config/i18n.ts`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/config/i18n.ts) file to add the language to the list of available languages and configure the values. There are several objects here.
|
||||
|
||||
- `Languages`: Add the new language to `Languages` enum, similar to the others. The string value here will be used in the `.env` file to set a build language later.
|
||||
- `availableLangs`: Add the new property from the `Languages` enum to both the `client` and `curriculum` arrays.
|
||||
- `i18nextCodes`: These are the ISO language codes for each language. You will need to add the appropriate ISO code for the language you are enabling. These do need to be unique for each language.
|
||||
- `LangNames`: These are the display names for the language selector in the navigation menu.
|
||||
- `LangCodes`: These are the language codes used for formatting dates and numbers. These should be Unicode CLDR codes instead of ISO codes.
|
||||
- `hiddenLangs`: These languages will not be displayed in the navigation menu. This is used for languages that are not yet ready for release.
|
||||
- `hiddenLangs`: These languages will not be displayed in the navigation menu. This is used for languages that are not yet ready for release. Include your language in this array in the first PR and ask staff team to prepare the VM instance for your language. When the VM is ready, make another PR to remove it from the array.
|
||||
- `rtlLangs`: These are languages that read from right to left.
|
||||
|
||||
As an example, if you wanted to enable Dothraki as a language, your `i18n.ts` objects should look like this:
|
||||
@@ -116,7 +138,7 @@ export const hiddenLangs = ['dothraki'];
|
||||
export const rtlLangs = [''];
|
||||
```
|
||||
|
||||
> [!NOTE] When a language has been set up in the deployment pipeline AND has a public `/news` instance live, it can be removed from the `hiddenLangs` array and be made available to the public.
|
||||
> [!NOTE] When a language has been set up in the deployment pipeline AND has a public `/learn` instance live, it can be removed from the `hiddenLangs` array and be made available to the public.
|
||||
|
||||
### Set Translated SuperBlocks
|
||||
|
||||
@@ -149,7 +171,7 @@ See the `SuperBlocks` enum at the beginning of the same file for the full list o
|
||||
|
||||
### Configure Search
|
||||
|
||||
Next, open the `client/src/utils/algolia-locale-setup.ts` file. This data is used for the search bar that loads `/news` articles. While it is unlikely that you are going to test this functionality, missing the data for your language can lead to errors when attempting to build the codebase locally.
|
||||
Next, open the [`client/src/utils/algolia-locale-setup.ts`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/client/src/utils/algolia-locale-setup.ts) file. This data is used for the search bar that loads `/news` articles. While it is unlikely that you are going to test this functionality, missing the data for your language can lead to errors when attempting to build the codebase locally.
|
||||
|
||||
Add an object for your language to the `algoliaIndices` object. You should use the the same values as the `english` object for local testing, replacing the `english` key with your language's `availableLangs` value.
|
||||
|
||||
@@ -179,12 +201,52 @@ const algoliaIndices = {
|
||||
name: 'news',
|
||||
searchPage: 'https://www.freecodecamp.org/news/search/'
|
||||
}
|
||||
|
||||
// If we already have /news in the target language up and running, you can update the values like this:
|
||||
// dothraki: {
|
||||
// name: 'news-mis',
|
||||
// searchPage: 'https://www.freecodecamp.org/dothraki/news/search/'
|
||||
// }
|
||||
};
|
||||
```
|
||||
|
||||
### Client UI
|
||||
|
||||
You will need to take an additional step to handle the client UI translations.
|
||||
|
||||
The Crowdin workflows will automatically pull down _some_ of the UI translations, but there are a couple of files that need to be moved manually.
|
||||
|
||||
You will want to copy the following files from [`/client/i18n/locales/english`](https://github.com/freeCodeCamp/freeCodeCamp/tree/main/client/i18n/locales/english) to `/client/i18n/locales/<your-language>`, and apply translations as needed:
|
||||
|
||||
- `links.json`
|
||||
- `meta-tags.json`
|
||||
- `motivation.json`
|
||||
|
||||
You don't have to have everything in these 3 files translated at first. It's possible to translate only the relevant parts and make adjustments later.
|
||||
|
||||
#### `links.json`
|
||||
|
||||
You can replace any URLs that you have corresponding pages ready in your language.
|
||||
|
||||
For example, if you have the publication in your language, you can replace the URL for `"news"`. If you want to translate articles listed in the footer links, see [How to Translate Articles in the Footer Links](language-lead-handbook.md#how-to-translate-articles-in-the-footer-links).
|
||||
|
||||
#### `meta-tags.json`
|
||||
|
||||
This file contains metadata for the web page of `/learn` in your language. You can translate the values for `"title"`, `"description"`, and `"social-description"`. The value for `"youre-unsubscribed"` is used when someone unsubscribes from Quincy's weekly email.
|
||||
|
||||
Also, you can translate or add relevant keywords in your language to the `"keywords"` array.
|
||||
|
||||
#### `motivation.json`
|
||||
|
||||
This file contains the compliments that will be displayed to campers when they complete a challenge, and motivational quotes that are displayed on the top page of `/learn`.
|
||||
|
||||
You can translate them, or even replace them with relevant compliments/quotes of your choice in your language.
|
||||
|
||||
### Enabling Localized Videos
|
||||
|
||||
For the video challenges, you need to change a few things. First, add the new locale to the GraphQL query in the `client/src/templates/Challenges/video/Show.tsx` file. For example, adding Dothraki to the query:
|
||||
This section is applicable only if you have localized videos in the challenges. Otherwise, you can skip this section.
|
||||
|
||||
For the video challenges, you need to change a few things. First, add the new locale to the GraphQL query in the [`client/src/templates/Challenges/video/Show.tsx`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/client/src/templates/Challenges/video/show.tsx) file. For example, adding Dothraki to the query:
|
||||
|
||||
```tsx
|
||||
query VideoChallenge($slug: String!) {
|
||||
@@ -236,18 +298,6 @@ videoLocaleIds: Joi.when('challengeType', {
|
||||
}),
|
||||
```
|
||||
|
||||
## Client UI
|
||||
|
||||
You will need to take an additional step to handle the client UI translations.
|
||||
|
||||
The Crowdin workflows will automatically pull down _some_ of the UI translations, but there are a couple of files that need to be moved manually.
|
||||
|
||||
You will want to copy the following files from `/client/i18n/locales/english` to `/client/i18n/locales/<your-language>`, and apply translations as needed:
|
||||
|
||||
- `links.json`
|
||||
- `meta-tags.json`
|
||||
- `motivation.json`
|
||||
|
||||
## Testing Translations Locally
|
||||
|
||||
If you would like to test translations locally, before adding them to our main repository - skip the Crowdin workflow changes. Follow the steps for enabling a language, then download the translations from Crowdin and load them into your local code.
|
||||
@@ -264,6 +314,18 @@ Once these are in place, you should be able to run `pnpm run develop` to view yo
|
||||
|
||||
> [!ATTENTION] While you may perform translations locally for the purpose of testing, we remind everyone that translations should _not_ be submitted through GitHub and should only be done through Crowdin. Be sure to reset your local codebase after you are done testing.
|
||||
|
||||
## Show the language in the navigation menu
|
||||
|
||||
When your prior PR is merged and the VM for your language is ready, make another PR to show your language in the navigation menu.
|
||||
|
||||
In [`config/i18n.ts`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/config/i18n.ts) file, you have included your language in `hiddenLangs` array in the prior PR. Remove it from the array now.
|
||||
|
||||
```js
|
||||
export const hiddenLangs = []; // Remove your language from the array
|
||||
```
|
||||
|
||||
When this PR is merged and gets deployed, the curriculum in your language will be live.
|
||||
|
||||
# Deploying New Languages on `/news`
|
||||
|
||||
To deploy News for a new language, you'll need to create two PRs. One PR will be to the [CDN repo](https://github.com/freeCodeCamp/cdn), and the other will be to the [News repo](https://github.com/freeCodeCamp/news).
|
||||
|
||||
@@ -1,14 +1,36 @@
|
||||
# Implantar novos idiomas no `/learn`
|
||||
|
||||
Antes de lançar um novo idioma, você precisará permitir que os idiomas sejam baixados do Crowdin.
|
||||
To enable a new language on `/learn` (curriculum), you need to complete the following steps:
|
||||
|
||||
- Complete translating and approving the first 3 certifications on Crowdin. (New Responsive Web Design, JavaScript Algorithms and Data Structures, and Front End Development Libraries)
|
||||
- Complete translating and approving all strings in Learn UI project on Crowdin.
|
||||
- Update Crowdin settings to add a custom language code for the new language.
|
||||
- Open the 1st PR to configure GitHub Actions. You need to update 2 files:
|
||||
- `crowdin-download.client-ui.yml`
|
||||
- `crowdin-download.curriculum.yml`
|
||||
- Open the 2nd PR to add other configurations. You need to update/add the following files:
|
||||
- Update `i18n.ts`
|
||||
- Update `superblocks.ts`
|
||||
- Update `algolia-locale-setup.ts`
|
||||
- Add `links.json`
|
||||
- Add `meta-tags.json`
|
||||
- Add `motivation.json`
|
||||
- Ask infrastructure team to spin up the VM for the new language.
|
||||
- Once the VM is ready, open the 3rd PR to show the new language in the navigation menu.
|
||||
|
||||
We will explain each step in the following sections.
|
||||
|
||||
## Atualizar as configurações do Crowdin
|
||||
|
||||
Nos projetos `Curriculum` e `Learn UI`, você precisará selecionar `Projects Settings`, na barra lateral. Em seguida, desça até `Language Mapping`, onde você verá uma opção para adicionar códigos de idioma personalizados. Adicione uma nova entrada para o idioma que você está liberando, selecionando `language` como o valor de `Placeholder` e digitando um URL amigável em letras minúsculas do nome do seu idioma para o `Custom code`. Se você não tiver certeza do que usar, fale conosco pelo nosso chat de colaboradores e nós o ajudaremos.
|
||||
Antes de lançar um novo idioma, você precisará permitir que os idiomas sejam baixados do Crowdin. To configure that, you need to add a custom language code for your language.
|
||||
|
||||
## Atualizar os fluxos de trabalho
|
||||
In the `Curriculum` and `Learn UI` projects on Crowdin, you will need to select `Settings` > `Languages` from the sidebar. Em seguida, desça até `Language Mapping`, onde você verá uma opção para adicionar códigos de idioma personalizados. Adicione uma nova entrada para o idioma que você está liberando, selecionando `language` como o valor de `Placeholder` e digitando um URL amigável em letras minúsculas do nome do seu idioma para o `Custom code`. If you aren't sure what to use, or you don't have an admin role and can't see the settings, reach out in our contributor chat and we will assist you.
|
||||
|
||||
Você precisará adicionar um passo em `crowdin-download.client-ui.yml` e em `crowdin-download.curriculum.yml`. O passo para ambos será o mesmo. Por exemplo, se você quiser habilitar os downloads de Dothraki:
|
||||
## Updating Workflows for GitHub Actions
|
||||
|
||||
Then you need to configure the syncing between Crowdin and GitHub.
|
||||
|
||||
You will need to add a step to the [`crowdin-download.client-ui.yml`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/.github/workflows/crowdin-download.client-ui.yml) and [`crowdin-download.curriculum.yml`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/.github/workflows/crowdin-download.curriculum.yml). O passo para ambos será o mesmo. Por exemplo, se você quiser habilitar os downloads de Dothraki:
|
||||
|
||||
```yml
|
||||
##### Download Dothraki #####
|
||||
@@ -49,14 +71,14 @@ Observe que a chave `download_language` precisa ser definida como código do idi
|
||||
|
||||
Existem algumas etapas a serem seguidas para permitir que a base de código seja compilada no idioma desejado.
|
||||
|
||||
Primeiro, visite o arquivo `config/i18n.ts` para adicionar o idioma à lista de idiomas disponíveis e configurar os valores. Existem vários objetos aqui.
|
||||
First, visit the [`config/i18n.ts`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/config/i18n.ts) file to add the language to the list of available languages and configure the values. Existem vários objetos aqui.
|
||||
|
||||
- `Languages`: adiciona o novo idioma no enum `Languages`, do mesmo modo que com os outros. O valor da string aqui será usado no arquivo `.env` para definir o idioma da build posteriormente.
|
||||
- `availableLangs`: adiciona a nova propriedade do enum `Languages` aos dois arrays, `client` e `curriculum`.
|
||||
- `i18nextCodes`: esses são os códigos ISO de cada linguagem. Você vai precisar do código ISO apropriado para o idioma que você está habilitando. Eles precisam ser únicos para cada idioma.
|
||||
- `LangNames`: esses são os nomes dos idiomas que aparecerão para a seleção no menu de navegação.
|
||||
- `LangCodes`: esses são os códigos de idiomas usados para formatar datas e números. Esses deverão ser códigos Unicode CLDR ao invés de códigos ISO.
|
||||
- `hiddenLangs`: Esses idiomas não serão exibidos no menu de navegação. Isto é usado para idiomas que ainda não estão prontos para liberação.
|
||||
- `hiddenLangs`: Esses idiomas não serão exibidos no menu de navegação. Isto é usado para idiomas que ainda não estão prontos para liberação. Include your language in this array in the first PR and ask staff team to prepare the VM instance for your language. When the VM is ready, make another PR to remove it from the array.
|
||||
- `rtlLangs`: estes são os idiomas que leem da direita para a esquerda.
|
||||
|
||||
Como um exemplo, se você tivesse que habilitar o idioma Dothraki como seu idioma, os objetos `i18n.ts` devem ficar assim:
|
||||
@@ -116,7 +138,7 @@ export const hiddenLangs = ['dothraki'];
|
||||
export const rtlLangs = [''];
|
||||
```
|
||||
|
||||
> [!NOTE] Quando um idioma for configurado no pipeline de implantação E tiver uma instância pública de `/news` ativa, ele pode ser removido da matriz `hiddenLangs` e ser disponibilizado ao público.
|
||||
> [!NOTE] When a language has been set up in the deployment pipeline AND has a public `/learn` instance live, it can be removed from the `hiddenLangs` array and be made available to the public.
|
||||
|
||||
### Configuração dos superblocos traduzidos
|
||||
|
||||
@@ -149,7 +171,7 @@ Veja o enum `SuperBlocks` no início do mesmo arquivo para ver a lista completa
|
||||
|
||||
### Configurar a busca
|
||||
|
||||
Agora, abra o arquivo `client/src/utils/algolia-locale-setup.ts`. Esse dado é usado para a barra de busca que carrega os artigos `/news`. Embora seja improvável que você venha a testar essa funcionalidade, não ter os dados para o seu idioma pode levar a erros quando tentar criar a base de código localmente.
|
||||
Next, open the [`client/src/utils/algolia-locale-setup.ts`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/client/src/utils/algolia-locale-setup.ts) file. Esse dado é usado para a barra de busca que carrega os artigos `/news`. Embora seja improvável que você venha a testar essa funcionalidade, não ter os dados para o seu idioma pode levar a erros quando tentar criar a base de código localmente.
|
||||
|
||||
Adicione um objeto para seu idioma no objeto `algoliaIndices`. Você deve usar os mesmos valores do objeto `english` para o teste local, substituindo a chave `english` pelo valor de `availableLangs` do seu idioma.
|
||||
|
||||
@@ -179,12 +201,52 @@ const algoliaIndices = {
|
||||
name: 'news',
|
||||
searchPage: 'https://www.freecodecamp.org/news/search/'
|
||||
}
|
||||
|
||||
// If we already have /news in the target language up and running, you can update the values like this:
|
||||
// dothraki: {
|
||||
// name: 'news-mis',
|
||||
// searchPage: 'https://www.freecodecamp.org/dothraki/news/search/'
|
||||
// }
|
||||
};
|
||||
```
|
||||
|
||||
### Interface do client
|
||||
|
||||
Você precisará dar um passo adicional para lidar com as traduções da interface do client.
|
||||
|
||||
Os fluxos de trabalho do Crowdin serão automaticamente puxados _algumas_ das traduções da UI, mas há alguns arquivos que precisam ser movidos manualmente.
|
||||
|
||||
You will want to copy the following files from [`/client/i18n/locales/english`](https://github.com/freeCodeCamp/freeCodeCamp/tree/main/client/i18n/locales/english) to `/client/i18n/locales/<your-language>`, and apply translations as needed:
|
||||
|
||||
- `links.json`
|
||||
- `meta-tags.json`
|
||||
- `motivation.json`
|
||||
|
||||
You don't have to have everything in these 3 files translated at first. It's possible to translate only the relevant parts and make adjustments later.
|
||||
|
||||
#### `links.json`
|
||||
|
||||
You can replace any URLs that you have corresponding pages ready in your language.
|
||||
|
||||
For example, if you have the publication in your language, you can replace the URL for `"news"`. If you want to translate articles listed in the footer links, see [How to Translate Articles in the Footer Links](language-lead-handbook.md#how-to-translate-articles-in-the-footer-links).
|
||||
|
||||
#### `meta-tags.json`
|
||||
|
||||
This file contains metadata for the web page of `/learn` in your language. You can translate the values for `"title"`, `"description"`, and `"social-description"`. The value for `"youre-unsubscribed"` is used when someone unsubscribes from Quincy's weekly email.
|
||||
|
||||
Also, you can translate or add relevant keywords in your language to the `"keywords"` array.
|
||||
|
||||
#### `motivation.json`
|
||||
|
||||
This file contains the compliments that will be displayed to campers when they complete a challenge, and motivational quotes that are displayed on the top page of `/learn`.
|
||||
|
||||
You can translate them, or even replace them with relevant compliments/quotes of your choice in your language.
|
||||
|
||||
### Ativar os vídeos localizados
|
||||
|
||||
Para os desafios em vídeo, você precisa fazer algumas alterações. Primeiro, adicione o novo idioma (locale) à consulta do GraphQL no arquivo `client/src/templates/Challenges/video/Show.tsx`. Por exemplo, para adicionar Dothraki à consulta:
|
||||
This section is applicable only if you have localized videos in the challenges. Otherwise, you can skip this section.
|
||||
|
||||
Para os desafios em vídeo, você precisa fazer algumas alterações. First, add the new locale to the GraphQL query in the [`client/src/templates/Challenges/video/Show.tsx`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/client/src/templates/Challenges/video/show.tsx) file. Por exemplo, para adicionar Dothraki à consulta:
|
||||
|
||||
```tsx
|
||||
query VideoChallenge($slug: String!) {
|
||||
@@ -236,18 +298,6 @@ videoLocaleIds: Joi.when('challengeType', {
|
||||
}),
|
||||
```
|
||||
|
||||
## Interface do client
|
||||
|
||||
Você precisará dar um passo adicional para lidar com as traduções da interface do client.
|
||||
|
||||
Os fluxos de trabalho do Crowdin serão automaticamente puxados _algumas_ das traduções da UI, mas há alguns arquivos que precisam ser movidos manualmente.
|
||||
|
||||
Você vai querer copiar os seguintes arquivos de `/client/i18n/locales/english` para `/client/i18n/locales/<your-language>` e aplicar as traduções conforme necessário:
|
||||
|
||||
- `links.json`
|
||||
- `meta-tags.json`
|
||||
- `motivation.json`
|
||||
|
||||
## Testar traduções localmente
|
||||
|
||||
Se quiser testar as traduções localmente, antes de adicioná-las ao nosso repositório principal - pule as alterações de fluxo de trabalho do Crowdin. Siga as etapas para habilitar um idioma e, em seguida, baixe as traduções do Crowdin e as carregue em seu código local.
|
||||
@@ -264,6 +314,18 @@ Quando estes arquivos estiverem no local certo, você deve poder usar `pnpm run
|
||||
|
||||
> [!ATTENTION] Embora você possa realizar as traduções localmente para fins de teste, lembramos a todos que as traduções _não_ devem ser enviadas pelo GitHub e devem ser feitas somente pelo Crowdin. Certifique-se de reiniciar sua base de código local após realizar os testes.
|
||||
|
||||
## Show the language in the navigation menu
|
||||
|
||||
When your prior PR is merged and the VM for your language is ready, make another PR to show your language in the navigation menu.
|
||||
|
||||
In [`config/i18n.ts`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/config/i18n.ts) file, you have included your language in `hiddenLangs` array in the prior PR. Remove it from the array now.
|
||||
|
||||
```js
|
||||
export const hiddenLangs = []; // Remove your language from the array
|
||||
```
|
||||
|
||||
When this PR is merged and gets deployed, the curriculum in your language will be live.
|
||||
|
||||
# Implantar novos idiomas em `/news`
|
||||
|
||||
Para implantar novos idiomas em News, você precisa criar dois PRs. Um PR será para o [repositório do CDN](https://github.com/freeCodeCamp/cdn), enquanto o outro será para o [repositório News](https://github.com/freeCodeCamp/news).
|
||||
|
||||
@@ -1,14 +1,36 @@
|
||||
# Додавання нових мов для `/learn`
|
||||
|
||||
Перш ніж випустити нову мову, потрібно дозволити завантаження мов з Crowdin.
|
||||
To enable a new language on `/learn` (curriculum), you need to complete the following steps:
|
||||
|
||||
- Complete translating and approving the first 3 certifications on Crowdin. (New Responsive Web Design, JavaScript Algorithms and Data Structures, and Front End Development Libraries)
|
||||
- Complete translating and approving all strings in Learn UI project on Crowdin.
|
||||
- Update Crowdin settings to add a custom language code for the new language.
|
||||
- Open the 1st PR to configure GitHub Actions. You need to update 2 files:
|
||||
- `crowdin-download.client-ui.yml`
|
||||
- `crowdin-download.curriculum.yml`
|
||||
- Open the 2nd PR to add other configurations. You need to update/add the following files:
|
||||
- Update `i18n.ts`
|
||||
- Update `superblocks.ts`
|
||||
- Update `algolia-locale-setup.ts`
|
||||
- Add `links.json`
|
||||
- Add `meta-tags.json`
|
||||
- Add `motivation.json`
|
||||
- Ask infrastructure team to spin up the VM for the new language.
|
||||
- Once the VM is ready, open the 3rd PR to show the new language in the navigation menu.
|
||||
|
||||
We will explain each step in the following sections.
|
||||
|
||||
## Оновлення налаштувань Crowdin
|
||||
|
||||
На бічній панелі проєктів `Curriculum` та `Learn UI` вам потрібно обрати `Project Settings`. Прокрутіть вниз до `Language Mapping`, де ви побачите опцію додавання нового коду мови. Додайте нову мову, обравши значення `language` для `Placeholder` та ввівши назву мови у нижньому регістрі для `Custom code`. Якщо ви не впевнені, що вводити, ми допоможемо у нашому чаті помічників.
|
||||
Перш ніж випустити нову мову, потрібно дозволити завантаження мов з Crowdin. To configure that, you need to add a custom language code for your language.
|
||||
|
||||
## Оновлення потоку робіт
|
||||
In the `Curriculum` and `Learn UI` projects on Crowdin, you will need to select `Settings` > `Languages` from the sidebar. Прокрутіть вниз до `Language Mapping`, де ви побачите опцію додавання нового коду мови. Додайте нову мову, обравши значення `language` для `Placeholder` та ввівши назву мови у нижньому регістрі для `Custom code`. If you aren't sure what to use, or you don't have an admin role and can't see the settings, reach out in our contributor chat and we will assist you.
|
||||
|
||||
Вам потрібно буде додати крок до `crowdin-download.client-ui.yml` та `crowdin-download.curriculum.yml`. Він буде однаковим. Наприклад, якщо ви хочете завантажувати дотракійську мову:
|
||||
## Updating Workflows for GitHub Actions
|
||||
|
||||
Then you need to configure the syncing between Crowdin and GitHub.
|
||||
|
||||
You will need to add a step to the [`crowdin-download.client-ui.yml`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/.github/workflows/crowdin-download.client-ui.yml) and [`crowdin-download.curriculum.yml`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/.github/workflows/crowdin-download.curriculum.yml). Він буде однаковим. Наприклад, якщо ви хочете завантажувати дотракійську мову:
|
||||
|
||||
```yml
|
||||
##### Download Dothraki #####
|
||||
@@ -49,14 +71,14 @@
|
||||
|
||||
Щоб дозволити кодовій базі функціонувати на обраній вами мові, потрібно зробити декілька кроків.
|
||||
|
||||
Спочатку відвідайте файл `config/i18n.ts`, щоб додати мову до списку доступних мов та налаштувати значення. У ньому розміщено декілька об’єктів.
|
||||
First, visit the [`config/i18n.ts`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/config/i18n.ts) file to add the language to the list of available languages and configure the values. У ньому розміщено декілька об’єктів.
|
||||
|
||||
- `Languages`: додайте нову мову до запису `Languages`, схоже до інших. Значення рядка пізніше буде використане у файлі `.env`, щоб налаштувати збірку мови.
|
||||
- `availableLangs`: додайте нову властивість із запису `Languages` до масивів `client` та `curriculum`.
|
||||
- `i18nextCodes`: мовні коди ISO для кожної мови. Вам потрібно додати відповідний код ISO для мови, з якою працюєте. Вони повинні бути унікальними для кожної мови.
|
||||
- `LangNames`: назви мов для перемикача мови у навігаційному меню.
|
||||
- `LangCodes`: мовні коди, які використовуються для форматування дат і чисел. Ними повинні бути коди Unicode CLDR замість кодів ISO.
|
||||
- `hiddenLangs`: мови, які не показано у навігаційному меню. Використовують для мов, які не готові до випуску.
|
||||
- `hiddenLangs`: мови, які не показано у навігаційному меню. Використовують для мов, які не готові до випуску. Include your language in this array in the first PR and ask staff team to prepare the VM instance for your language. When the VM is ready, make another PR to remove it from the array.
|
||||
- `rtlLangs`: мови, які читаються справа наліво.
|
||||
|
||||
Наприклад, якщо ви хочете використовувати дотракійську мову, об’єкти `i18n.ts` повинні виглядати так:
|
||||
@@ -116,7 +138,7 @@ export const hiddenLangs = ['dothraki'];
|
||||
export const rtlLangs = [''];
|
||||
```
|
||||
|
||||
> [!NOTE] Коли мова буде налаштована у послідовності розгортання ТА матиме публічний активний екземпляр `/news`, її можна видалити з масиву `hiddenLangs` та зробити доступною.
|
||||
> [!NOTE] When a language has been set up in the deployment pipeline AND has a public `/learn` instance live, it can be removed from the `hiddenLangs` array and be made available to the public.
|
||||
|
||||
### Налаштуйте перекладені суперблоки
|
||||
|
||||
@@ -149,7 +171,7 @@ export const notAuditedSuperBlocks: NotAuditedSuperBlocks = {
|
||||
|
||||
### Налаштування пошуку
|
||||
|
||||
Потім відкрийте файл `client/src/utils/algolia-locale-setup.ts`. Ці дані використовуються для рядка пошуку, який завантажує статті `/news`. Хоча й малоймовірно, що ви будете тестувати цю функціональність, відсутність даних мови може призвести до помилок при спробі створити кодову базу локально.
|
||||
Next, open the [`client/src/utils/algolia-locale-setup.ts`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/client/src/utils/algolia-locale-setup.ts) file. Ці дані використовуються для рядка пошуку, який завантажує статті `/news`. Хоча й малоймовірно, що ви будете тестувати цю функціональність, відсутність даних мови може призвести до помилок при спробі створити кодову базу локально.
|
||||
|
||||
Додайте об’єкт своєї мови до об’єкта `algoliaIndices`. Використовуйте значення об’єкта `english` для локального тестування, замінивши ключ `english` на значення своєї мови `availableLangs`.
|
||||
|
||||
@@ -179,12 +201,52 @@ const algoliaIndices = {
|
||||
name: 'news',
|
||||
searchPage: 'https://www.freecodecamp.org/news/search/'
|
||||
}
|
||||
|
||||
// If we already have /news in the target language up and running, you can update the values like this:
|
||||
// dothraki: {
|
||||
// name: 'news-mis',
|
||||
// searchPage: 'https://www.freecodecamp.org/dothraki/news/search/'
|
||||
// }
|
||||
};
|
||||
```
|
||||
|
||||
### Інтерфейс клієнта
|
||||
|
||||
Вам потрібно здійснити додатковий крок для роботи з перекладами інтерфейсу клієнта.
|
||||
|
||||
Робочі процеси на Crowdin автоматично завантажують _деякі_ переклади інтерфейсу, однак певні файли потрібно перемістити вручну.
|
||||
|
||||
You will want to copy the following files from [`/client/i18n/locales/english`](https://github.com/freeCodeCamp/freeCodeCamp/tree/main/client/i18n/locales/english) to `/client/i18n/locales/<your-language>`, and apply translations as needed:
|
||||
|
||||
- `links.json`
|
||||
- `meta-tags.json`
|
||||
- `motivation.json`
|
||||
|
||||
You don't have to have everything in these 3 files translated at first. It's possible to translate only the relevant parts and make adjustments later.
|
||||
|
||||
#### `links.json`
|
||||
|
||||
You can replace any URLs that you have corresponding pages ready in your language.
|
||||
|
||||
For example, if you have the publication in your language, you can replace the URL for `"news"`. If you want to translate articles listed in the footer links, see [How to Translate Articles in the Footer Links](language-lead-handbook.md#how-to-translate-articles-in-the-footer-links).
|
||||
|
||||
#### `meta-tags.json`
|
||||
|
||||
This file contains metadata for the web page of `/learn` in your language. You can translate the values for `"title"`, `"description"`, and `"social-description"`. The value for `"youre-unsubscribed"` is used when someone unsubscribes from Quincy's weekly email.
|
||||
|
||||
Also, you can translate or add relevant keywords in your language to the `"keywords"` array.
|
||||
|
||||
#### `motivation.json`
|
||||
|
||||
This file contains the compliments that will be displayed to campers when they complete a challenge, and motivational quotes that are displayed on the top page of `/learn`.
|
||||
|
||||
You can translate them, or even replace them with relevant compliments/quotes of your choice in your language.
|
||||
|
||||
### Додавання локалізованих відео
|
||||
|
||||
Вам потрібно дещо змінити стосовно відеозавдань. Спочатку додайте нову локаль до запиту GraphQL у файлі `client/src/templates/Challenges/video/Show.tsx`. Ось так додається дотракійська мова:
|
||||
This section is applicable only if you have localized videos in the challenges. Otherwise, you can skip this section.
|
||||
|
||||
Вам потрібно дещо змінити стосовно відеозавдань. First, add the new locale to the GraphQL query in the [`client/src/templates/Challenges/video/Show.tsx`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/client/src/templates/Challenges/video/show.tsx) file. Ось так додається дотракійська мова:
|
||||
|
||||
```tsx
|
||||
query VideoChallenge($slug: String!) {
|
||||
@@ -236,18 +298,6 @@ videoLocaleIds: Joi.when('challengeType', {
|
||||
}),
|
||||
```
|
||||
|
||||
## Інтерфейс клієнта
|
||||
|
||||
Вам потрібно здійснити додатковий крок для роботи з перекладами інтерфейсу клієнта.
|
||||
|
||||
Робочі процеси на Crowdin автоматично завантажують _деякі_ переклади інтерфейсу, однак певні файли потрібно перемістити вручну.
|
||||
|
||||
Вам потрібно скопіювати наступні файли з `/client/i18n/locales/english` до `/client/i18n/locales/<your-language>` та застосувати переклади там, де потрібно:
|
||||
|
||||
- `links.json`
|
||||
- `meta-tags.json`
|
||||
- `motivation.json`
|
||||
|
||||
## Тестування перекладів локально
|
||||
|
||||
Якщо ви хочете перевірити переклади локально, перш ніж додати їх до нашого основного репозиторію, то пропустіть зміни робочого процесу на Crowdin. Виконайте кроки для додавання мови, а потім завантажте переклади з Crowdin і додайте їх до свого локального коду.
|
||||
@@ -264,6 +314,18 @@ videoLocaleIds: Joi.when('challengeType', {
|
||||
|
||||
> [!ATTENTION] Ви можете працювати з перекладами локально, щоб провести тестування. Ми нагадуємо, що переклади _не_ потрібно надсилати через GitHub, а лише через Crowdin. Не забудьте скинути локальну кодову базу після закінчення тестування.
|
||||
|
||||
## Show the language in the navigation menu
|
||||
|
||||
When your prior PR is merged and the VM for your language is ready, make another PR to show your language in the navigation menu.
|
||||
|
||||
In [`config/i18n.ts`](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/config/i18n.ts) file, you have included your language in `hiddenLangs` array in the prior PR. Remove it from the array now.
|
||||
|
||||
```js
|
||||
export const hiddenLangs = []; // Remove your language from the array
|
||||
```
|
||||
|
||||
When this PR is merged and gets deployed, the curriculum in your language will be live.
|
||||
|
||||
# Додавання нових мов для `/news`
|
||||
|
||||
Щоб започаткувати новини новою мовою, потрібно створити два PR. Один PR буде для [репозиторію CDN](https://github.com/freeCodeCamp/cdn), а інший — для [репозиторію News](https://github.com/freeCodeCamp/news).
|
||||
|
||||
Reference in New Issue
Block a user