chore(i18n,docs): processed translations (#47318)

pull/47326/head
camperbot 2022-08-19 00:16:04 +05:30 committed by GitHub
parent 6753cd67c7
commit b19119b601
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
5 changed files with 63 additions and 63 deletions

View File

@ -1,6 +1,6 @@
### Я лише починаю ознайомлення з GitHub та відкритим вихідним кодом. З чого мені варто почати?
Прочитайте нашу інструкцію ["Як зробити внесок до відкритого вихідного коду"](https://github.com/freeCodeCamp/how-to-contribute-to-open-source). Там є вичерпні вказівки для тих, хто вперше стикається з такими проєктами. Там також є багато порад для роботи з відкритим вихідним кодом.
Прочитайте [«Як зробити внесок до відкритого вихідного коду»](https://github.com/freeCodeCamp/how-to-contribute-to-open-source). Там є вичерпні вказівки для тих, хто вперше стикається з такими проєктами. Там також є багато порад для роботи з відкритим вихідним кодом.
### What do I need to know to contribute to the codebase?

View File

@ -6,10 +6,10 @@
При обговоренні навчальної програми важливо знати декілька термінів.
- `certification` : Коли йдеться про сертифікацію, мається на увазі сертифікати, які отримують користувачі. Це не те саме, що й superBlock.
- `superBlock` : superBlock — це збірка найскладніших завдань. Each superblock corresponds to a certification in the curriculum (e.g. Responsive Web Design).
- `block` : Блок — це розділ у межах superblock. A block corresponds to a group of challenges in a given certification (e.g. Basic HTML and HTML5)
- `challenge` : A challenge is a single lesson within the curriculum (e.g. Say Hello to HTML Elements)
- `certification` : коли йдеться про сертифікацію, мається на увазі сертифікати, які отримують користувачі. Це не те саме, що й superBlock.
- `superBlock` : superBlock це збірка найскладніших завдань. Кожен суперблок відповідає сертифікації в навчальній програмі (наприклад, «Адаптивний вебдизайн»).
- `block` : блок це розділ у межах superblock. Блок відповідає групі завдань у даній сертифікації (наприклад, «Основи HTML та HTML5»)
- `challenge` : завдання це окремий урок у навчальній програмі (наприклад, «Ознайомтесь з елементами HTML»)
## Дерево файлів
@ -30,7 +30,7 @@ curriculum/
## Каталог `_meta`
Каталог `_meta` це особливий каталог, який містить `.json` файли. Ці файли відповідають кожному окремому блоку в навчальній програмі та використовуються, щоб визначити до якого суперблоку належить блок та порядок завдань у цьому блоці.
Каталог `_meta` це особливий каталог, який містить файли `.json`. Ці файли відповідають кожному окремому блоку в навчальній програмі та використовуються, щоб визначити до якого суперблоку належить блок та порядок завдань у цьому блоці.
## Перейменування файлів
@ -44,15 +44,15 @@ curriculum/
1. Оберіть нову назву для теки `curriculum/challenges/_meta/{superBlock}-certificate`.
1. У файлі `meta.json` тієї теки, змініть значення в `name`, `dashedName` і `challengeOrder` на нову назву.
1. У `curriculum/challenges/english/12-certificate`, перейменуйте теку `{superBlock}-certificate` і YAML файл у ній.
1. У YAML файлі, змініть `title` на нову назву.
1. У `curriculum/challenges/english/12-certificate`, перейменуйте теку `{superBlock}-certificate` і файл YAML у ній.
1. У файлі YAML, змініть `title` на нову назву.
1. Перейменуйте файл і теку з третього кроку для інших мов навчальної програми.
1. Оновіть `client/src/redux/index.ts`, щоб використовувати правильний `title`.
1. За бажанням оновіть і `certSlug` для суперблока в цьому ж файлі. **Зауважте**, що перейменування `certSlug` змінить URL-адресу для сертифікатів, тому це слід робити обачно.
1. Оновіть `title` в `client/src/resources/cert-and-project-map.ts` до нових значень. **Зверніть увагу**, що зміна `title` тут **зруйнує** superBlock сторінку для відповідної сертифікації. Це пов'язано із тим, що назва superBlock має відповідати назві сертифікації. Бажано одночасно змінити й назву суперблоку.
1. Якщо Ви перейменували `certSlug` у сьомому кроці, змініть його тут для сертифіката і вкладених `projects` значень.
1. Оновіть `title` в `client/src/resources/cert-and-project-map.ts` на нові значення. **Зверніть увагу**, що зміна `title` тут **зруйнує** сторінку superBlock для відповідної сертифікації. Це пов'язано із тим, що назва superBlock має відповідати назві сертифікації. Бажано одночасно змінити й назву суперблоку.
1. Якщо ви перейменували `certSlug` у сьомому кроці, змініть його тут для сертифіката і вкладених значень `projects`.
1. У `config/certification-settings.js`, оновіть значення `certTypeTitleMap` на нову назву.
1. Якщо Ви перейменували `certSlug` у сьомому кроці, оновіть ключ доступу `certSlugTypeMap` в цьому ж файлі.
1. Якщо ви перейменували `certSlug` у сьомому кроці, оновіть ключ доступу `certSlugTypeMap` в цьому ж файлі.
1. За необхідності оновіть ім'я сертифікату в масиві `legacyCerts` з `client/src/client-only-routes/show-project-links.tsx`.
1. Оновіть основний файл `README.md` до нового імені.
@ -66,14 +66,14 @@ curriculum/
1. Перейменуйте теку superBlock у сіх_ інших каталогах `curriculum/challenges/{language}`.
1. Для кожного блоку в цьому суперблоці оновіть значення `superBlock` в `meta.json` файлі на його ж dashedName. Вам не потрібно перейменовувати теки тут. Зробіть це при перейменуванні блоку.
1. Перейменуйте теку суперблоку в `client/src/pages/learn`.
1. Оновіть файл `index.md` у вищевказаній теці, змінивши `title` та `superBlock` значення на нове ім'я.
1. Для кожної вищезазначеної теки у блоці, оновіть `index.md`, щоб використовувати її за правильним `superBlock` значенням.
1. Оновіть файл `index.md` у вищевказаній теці, змінивши значення `title` та `superBlock` на нове ім'я.
1. Для кожної вищезазначеної теки у блоці, оновіть `index.md`, щоб використовувати її за правильним значенням `superBlock`.
1. У файлі `client/src/resources/cert-and-project-map.ts`, оновіть алгоритм дій до сертифіката на початку файлу і значення `title` для цього суперблоку. **Зверніть увагу:** зміна `title` тут **забере у Вас** можливість переглядати дійсні сертифікати для цього суперблоку. Це пов'язано із тим, що назва superBlock має відповідати назві сертифікації. Бажано одночасно змінити й назву сертифіката.
1. Оновіть `superBlockCertTypeMap` ключ у `config/certification-settings.js` до нової назви суперблоку.
1. Оновіть ключ `superBlockCertTypeMap` у `config/certification-settings.js` до нової назви суперблоку.
1. Оновіть значення шляху в `client/src/assets/icons/index.tsx`.
1. Оновіть `intro.json` файл для кожної мови в `client/i18n/locales`, щоб мати змогу використати новий суперблок `dashedName`. В англійському файлі також оновіть `title`.
1. Перевірте `config/i18n/all-langs.js` файл, щоб побачити чи надав суперблок можливість конвертації. Оновіть усі значення, де він використовується.
1. Оновіть назву головного `README.md` файлу.
1. Перевірте файл `config/i18n/all-langs.js`, щоб побачити чи надав суперблок можливість конвертації. Оновіть усі значення, де він використовується.
1. Оновіть назву головного файлу `README.md`.
### Перейменування блоку
@ -81,17 +81,17 @@ curriculum/
1. Змінити назву теки блоку в каталозі `curriculum/challenges/english/{superBlock}`.
1. Змінити назву тієї ж самої теки блоку в _усіх_ іншомовних каталогах, аби вони збігалися. Вони повинні бути такі ж самі як і в англійській теці, інакше буде помилка збірки.
1. Змінити назву теки блоку в `_meta` каталозі.
1. Оновити властивості `name` та `dashedName` для `meta.json` файлу цього блоку.
1. Змінити назву теки блоку в каталозі `_meta`.
1. Оновити властивості `name` та `dashedName` для файлу `meta.json` цього блоку.
1. Оновити `client/utils/help-category-map.json`, щоб використати нову назву блоку як основну.
1. Оновити теку блоку в `client/src/pages/learn/{superBlock}`.
1. Оновити `block` значення в титульному елементі в файлі `index.md` з вищезгаданої теки.
1. Оновити значення `block` в титульному елементі в файлі `index.md` з вищезгаданої теки.
1. У файлах `client/i18n/locales/{language}/intro.json` оновіть назву блоку до нової для всіх мов. В англійському файлі `intro.json` також оновіть `title`.
1. Оновити основний `README.md` файл до нового імені.
1. Оновити головний файл `README.md` до нового імені.
### Перейменування завдання
Під час перейменування окремого файлу завдання Вам необхідно:
Під час перейменування окремого файлу завдання вам необхідно:
1. Змінити назву файлу завдання в каталозі `curriculum/challenges/english`.
1. Змінити назву `title` і `dashedName` у цьому файлі.
@ -103,4 +103,4 @@ curriculum/
## Властивість `dashedName`
The `dashedName` property is used to generate the URL path for the superblock, block, or challenge. These should generally match what the `/utils/slugs.js` helper would output for the file name.
Властивість `dashedName` використовується для створення шляху URL-адреси для суперблока, блока або завдання. Загалом вони повинні відповідати тому, що помічник `/utils/slugs.js` виведе для імені файлу.

View File

@ -1,15 +1,15 @@
# Як використовувати Docker на Windows Home
Є декілька підводних каменів, яких треба уникнути, коли налаштовуєте Docker на Windows Home. По-перше, ви маєте використовувати [Docker Toolbox](https://docs.docker.com/toolbox/toolbox_install_windows/) як адміністратор. На жаль, Windows Home не підтримує Docker для робочого столу Windows, тому замість нього необхідно використовувати панель інструментів. Він повинен бути запущений від імені Адміністратора, так як при установці використовуються символічні посилання, які інакше створити неможливо.
Є декілька підводних каменів, яких треба уникнути, коли налаштовуєте Docker на Windows Home. По-перше, ви маєте використовувати [Docker Toolbox](https://docs.docker.com/toolbox/toolbox_install_windows/) як адміністратор. На жаль, Windows Home не підтримує Docker для робочого столу Windows, тому замість нього необхідно використовувати панель інструментів. Використайте роль адміністратора, оскільки при встановленні використовуються символічні посилання, які інакше створити неможливо.
Після встановлення панелі інструментів запустіть термінал Docker Quickstart від імені адміністратора. Це створить `default` віртуальну машину, якщо вона ще не створена. Як тільки це сталося, закрийте термінал і відкрийте VirtualBox (знову від Адміністратора). Ви можете побачити `default` машину. Цей сайт є доволі ресурсомістким, тому зупиніть віртуальну машину і підвищить налаштування наскільки ви зможете - зокрема, пам'ять. Було підтверджено, що він працює з 4 ГБ оперативної пам'яті.
Після встановлення панелі інструментів запустіть термінал Docker Quickstart від імені адміністратора. Це створить `default` віртуальну машину, якщо вона ще не створена. Одразу після цього закрийте термінал та відкрийте VirtualBox (знову як адміністратор). Ви можете побачити `default` машину. Цей сайт є доволі ресурсомістким, тому зупиніть віртуальну машину і підвищте налаштування наскільки ви зможете зокрема, пам'ять. Було підтверджено, що він працює з 4 ГБ оперативної пам'яті.
Після того, як ви будете переконані, що Docker працює, скопіюйте репозиторій freeCodeCamp в середину папки `C:\Users`. Ці каталоги є загальними, надаючи Docker доступ до локальних каталогів, які йому необхідні під час установки.
Після того, як ви будете переконані, що Docker працює, скопіюйте репозиторій freeCodeCamp в середину `C:\Users`. Ці каталоги є загальними, надаючи Docker доступ до локальних каталогів, які йому необхідні під час встановлення.
Якщо ви бачите такі повідомлення як
Якщо ви бачите такі повідомлення
```shell
bash: change_volumes_owner.sh: No such file or directory
```
коли ви `npm запустіть docker:init` це, ймовірно, буде вирахувано.
коли `npm run docker:init` це, ймовірно, злам.

View File

@ -1,78 +1,78 @@
# How to work on documentation
# Як працювати над документацією
## Work on the content of the docs
## Робота над вмістом документації
To work on the contributing guidelines, you can edit or add files in the `docs` directory [available here](https://github.com/freeCodeCamp/freeCodeCamp/tree/main/docs). When your changes are merged, they will be made available automatically at the documentation site.
Щоб працювати над рекомендаціями щодо внеску, ви можете редагувати або додавати файли в каталозі `docs`, [доступному тут](https://github.com/freeCodeCamp/freeCodeCamp/tree/main/docs). Коли ваші зміни об'єднані, вони стануть автоматично доступними на документаційному сайті.
### How to create an internal link
### Як створити внутрішнє посилання
If you want to create a link targeting a different section of the contributing guidelines, follow this format:
Якщо ви хочете створити внутрішнє посилання, націлене на інший розділ рекомендацій щодо внеску, слідуйте цьому формату:
```md
[Link text](target-file-name.md#target-section-heading-id)
// If the target section is within the same page, you can omit the file name
// Якщо цільовий розділ знаходиться на тій же сторінці, ви можете опустити назву файлу
[Link text](#target-section-heading-id)
```
Make sure you include the file extension (`.md`). Don't specify the full URL or append `/` before the file name.
Переконайтеся, що включили розширення файлу (`.md`). Не вказуйте повну URL-адресу або додайте `/` перед назвою файлу.
This is necessary to make these links work for the translated version of the document. Otherwise, they will redirect to the English version of the page regardless of the language.
Це обов'язково для того, щоб посилання працювали для перекладеної версії документа. В іншому випадку вони перенаправлятимуть на англійську версію сторінки, незалежно від мови.
#### Translating docs with internal links
#### Переклад документації з внутрішніми посиланнями
When you work on translating docs on Crowdin, make sure to replace the `#target-section-heading-id` with the id on the translated document. [Learn more about translating docs here](how-to-translate-files.md#translate-documentation).
Коли ви працюєте над перекладом документації на Crowdin, не забудьте змінити `#target-section-heading-id` на ідентифікацію в перекладеному документі. [Дізнатись більше про переклад документації](how-to-translate-files.md#translate-documentation).
## Work on the docs theme
## Робота над темою документації
> [!NOTE] A quick reminder that you do not need to set up anything for working on the content for the documentation site.
> [!NOTE] Швидке нагадування, що вам не потрібно нічого налаштовувати для роботи над вмістом документації.
>
> To work on the contributing guidelines, see [work on the docs content](#work-on-the-docs-content) section.
> Щоб працювати над рекомендаціями щодо внеску, див. розділ [робота над вмістом документації](#work-on-the-docs-content).
### Structure of the docs website
### Структура вебсайту документації
The site is generated using [`docsify`](https://docsify.js.org) and served using GitHub pages.
Сайт створений з використанням [`docsify`](https://docsify.js.org) та обслуговується завдяки GitHub Pages.
Typically you would not need to change any configuration or build the site locally. In case you are interested, here is how it works:
Зазвичай вам не потрібно буде змінювати конфігурації або створювати сайт локально. Хочете дізнатись більше? Ось як це працює:
- The homepage's source for this site is available in [`docs/index.html`](index.html).
- We serve this file as a SPA using `docsify` and GitHub Pages.
- The `docsify` script generates the content of `markdown` files in the `docs` directory on demand.
- The homepage is generated from the [`_coverpage.md`](_coverpage.md).
- the sidebar navigation is generated from [`_sidebar.md`](_sidebar.md).
- Джерело домашньої сторінки для цього сайту доступне в [`docs/index.html`](index.html).
- Ми обслуговуємо цей файл як SPA, використовуючи `docsify` та GitHub Pages.
- Скрипт `docsify` генерує вміст файлів `markdown` в каталозі `docs` за запитом.
- Домашня сторінка генерується з [`_coverpage.md`](_coverpage.md).
- Навігація бічної панелі генерується з [`_sidebar.md`](_sidebar.md).
### Serving the documentation site locally
### Обслуговування документаційного сайту локально
Clone freeCodeCamp:
Клонуйте freeCodeCamp:
```console
git clone https://github.com/freeCodeCamp/freeCodeCamp.git
```
Install `docsify`:
Встановіть `docsify`:
```console
npm install -g docsify
```
and serve the `/docs` directory
та обслужіть каталог `/docs`
```console
docsify serve docs
```
Alternatively, if you have installed freeCodeCamp locally (see the local setup guide), we bundled the CLI with the development tools so you can run any of the below commands as needed from the root of the repo:
Іншим чином, якщо ви встановили freeCodeCamp локально (див. посібник з локального налаштування), ми зібрали CLI з інструментами веброзробки, щоб ви могли запустити будь-яку з наведених нижче команд, необхідних з кореня репозиторію:
#### Serve and launch the documentation site only
#### Обслужити та запустити лише документаційний сайт
```console
npm run docs:serve
```
#### Serve the documentation site alongside freeCodeCamp locally:
#### Обслужити документаційний сайт поряд з freeCodeCamp локально:
```console
npm run develop
```
> The documentation site should be available at <http://localhost:3200>
> Документаційний сайт повинен бути доступний на <http://localhost:3200>

View File

@ -1,11 +1,11 @@
# Responsible Disclosure - Hall of Fame
# Відповідальне розкриття інформації Зала слави
We appreciate any responsible disclosure of vulnerabilities that might impact the integrity of our platforms and users. If you are interested in contributing to the security of our platform, please read our [security policy outlined here](security.md).
Ми цінуємо будь-яке відповідальне розкриття інформації, що може вплинути на цілісність наших платформ та користувачів. Якщо ви зацікавлені в тому, щоб зробити свій внесок до безпеки нашої платформи, ознайомтесь з нашою [політикою безпеки](security.md).
While we do not offer any bounties or swags at the moment, we are grateful to these awesome people for helping us keep the platform safe for everyone:
Поки ми не пропонуємо жодних щедрот на даний момент, ми вдячні цим неймовірним людям, що допомагають нам зберегти платформу безпечною для всіх:
- Mehul Mohan from [codedamn](https://codedamn.com) ([@mehulmpt](https://twitter.com/mehulmpt)) - [Vulnerability Fix](https://github.com/freeCodeCamp/freeCodeCamp/blob/bb5a9e815313f1f7c91338e171bfe5acb8f3e346/client/src/components/Flash/index.js)
- Peter Samir https://www.linkedin.com/in/peter-samir/
- Laurence Tennant ([@hyperreality](https://github.com/hyperreality)) working with IncludeSecurity.com - [GHSA-cc3r-grh4-27gj](https://github.com/freeCodeCamp/freeCodeCamp/security/advisories/GHSA-cc3r-grh4-27gj)
- Мехул Мохан з [codedamn](https://codedamn.com) ([@mehulmpt](https://twitter.com/mehulmpt)) [Виправлення вразливості](https://github.com/freeCodeCamp/freeCodeCamp/blob/bb5a9e815313f1f7c91338e171bfe5acb8f3e346/client/src/components/Flash/index.js)
- Пітер Самір https://www.linkedin.com/in/peter-samir/
- Лоуренс Теннант ([@hyperreality](https://github.com/hyperreality)) працює з IncludeSecurity.com [GHSA-c3r-grh4-27gj](https://github.com/freeCodeCamp/freeCodeCamp/security/advisories/GHSA-cc3r-grh4-27gj)
> ### Thank you for your contributions :pray:
> ### Дякуємо за ваш вклад :pray: