From 8bab66dcc3f56c8a679952bc89349d1f26110c3b Mon Sep 17 00:00:00 2001 From: zer0Kerbal <39887717+zer0Kerbal@users.noreply.github.com> Date: Sun, 30 Apr 2023 17:37:34 -0500 Subject: [PATCH 1/4] Create OrigLicense.md --- docs/LegalMumboJumbo/OrigLicense.md | 38 +++++++++++++++++++++++++++++ 1 file changed, 38 insertions(+) create mode 100644 docs/LegalMumboJumbo/OrigLicense.md diff --git a/docs/LegalMumboJumbo/OrigLicense.md b/docs/LegalMumboJumbo/OrigLicense.md new file mode 100644 index 0000000..3836d4b --- /dev/null +++ b/docs/LegalMumboJumbo/OrigLicense.md @@ -0,0 +1,38 @@ +--- +permalink: /OrigLicense.html +title: Original License - The Unilicense +--- + + +# [The Unilicense](https://unlicense.org/) + +The Unilicense Logo + +SPDX short identifier: [unilicense](https://unlicense.org/) + +Further resources on [**The Unilicense**](https://unlicense.org/) + +--- + +This is free and unencumbered software released into the public domain. + +Anyone is free to copy, modify, publish, use, compile, sell, or distribute this software, either in source code form or as a compiled +binary, for any purpose, commercial or non-commercial, and by any means. + +In jurisdictions that recognize copyright laws, the author or authors of this software dedicate any and all copyright interest in the +software to the public domain. We make this dedication for the benefit of the public at large and to the detriment of our heirs and +successors. We intend this dedication to be an overt act of relinquishment in perpetuity of all present and future rights to this +software under copyright law. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + +IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, +ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +For more information, please refer to From b925aa65ca0f48f782d8483a770b11f8386699a2 Mon Sep 17 00:00:00 2001 From: zer0Kerbal <39887717+zer0Kerbal@users.noreply.github.com> Date: Sun, 30 Apr 2023 17:37:35 -0500 Subject: [PATCH 2/4] Delete OrigLicesne.md --- docs/LegalMumboJumbo/OrigLicesne.md | 38 ----------------------------- 1 file changed, 38 deletions(-) delete mode 100644 docs/LegalMumboJumbo/OrigLicesne.md diff --git a/docs/LegalMumboJumbo/OrigLicesne.md b/docs/LegalMumboJumbo/OrigLicesne.md deleted file mode 100644 index 3836d4b..0000000 --- a/docs/LegalMumboJumbo/OrigLicesne.md +++ /dev/null @@ -1,38 +0,0 @@ ---- -permalink: /OrigLicense.html -title: Original License - The Unilicense ---- - - -# [The Unilicense](https://unlicense.org/) - -The Unilicense Logo - -SPDX short identifier: [unilicense](https://unlicense.org/) - -Further resources on [**The Unilicense**](https://unlicense.org/) - ---- - -This is free and unencumbered software released into the public domain. - -Anyone is free to copy, modify, publish, use, compile, sell, or distribute this software, either in source code form or as a compiled -binary, for any purpose, commercial or non-commercial, and by any means. - -In jurisdictions that recognize copyright laws, the author or authors of this software dedicate any and all copyright interest in the -software to the public domain. We make this dedication for the benefit of the public at large and to the detriment of our heirs and -successors. We intend this dedication to be an overt act of relinquishment in perpetuity of all present and future rights to this -software under copyright law. - -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF -MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. - -IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, -ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. - -For more information, please refer to From f8b198571b3d588e0b334d5f7b672b152fbf2473 Mon Sep 17 00:00:00 2001 From: zer0Kerbal <39887717+zer0Kerbal@users.noreply.github.com> Date: Sun, 30 Apr 2023 22:37:48 +0000 Subject: [PATCH 3/4] auto: Generated markdown indexes --- docs/LegalMumboJumbo/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/LegalMumboJumbo/index.md b/docs/LegalMumboJumbo/index.md index 1611c31..3d50fda 100644 --- a/docs/LegalMumboJumbo/index.md +++ b/docs/LegalMumboJumbo/index.md @@ -5,4 +5,4 @@ ## Documents - [License](License.md) -- [OrigLicesne](OrigLicesne.md) \ No newline at end of file +- [OrigLicense](OrigLicense.md) \ No newline at end of file From 500f8eb431deb51872bc2a9f0dd063701b4726da Mon Sep 17 00:00:00 2001 From: kwentar Date: Mon, 5 Jun 2023 10:16:05 +0300 Subject: [PATCH 4/4] added ru.cfg/ added ru translated readme and quickstart --- .../Localization/quickstart-ru.md | 47 +++++ .../Localization/readme-ru.md | 172 ++++++++++++++++++ .../ExceptionDetector/Localization/ru.cfg | 28 +++ 3 files changed, 247 insertions(+) create mode 100644 GameData/godarklight/ExceptionDetector/Localization/quickstart-ru.md create mode 100644 GameData/godarklight/ExceptionDetector/Localization/readme-ru.md create mode 100644 GameData/godarklight/ExceptionDetector/Localization/ru.cfg diff --git a/GameData/godarklight/ExceptionDetector/Localization/quickstart-ru.md b/GameData/godarklight/ExceptionDetector/Localization/quickstart-ru.md new file mode 100644 index 0000000..db12346 --- /dev/null +++ b/GameData/godarklight/ExceptionDetector/Localization/quickstart-ru.md @@ -0,0 +1,47 @@ +--- +permalink: /Quickstart.html +title: Краткое руководство +--- + + + + + +## Руководство по переводу + +Если вы хотите помочь в переводе этого мода, я очень вам благодарен! Следуйте этому краткому руководству, чтобы приступить к делу. + +### Как переводить + +Чтобы создать перевод на ваш язык, сделайте копию файла *en_us.cfg* и назовите его соответственно вашему языку: + +* *es-es.cfg* для испанского языка +* *es-mx.cfg* для мексиканского языка +* *ja.cfg* для японского языка +* *ru.cfg* для русского языка +* *zh-cn.cfg* для упрощенного китайского языка + +*Ещё раз:* + +* *es-es* для испанского языка +* *es-mx* для мексиканского языка +* *ja* для японского языка +* *ru* для русского языка +* *zh-cn* для упрощенного китайского языка + +### Что не нужно переводить + +Некоторые символы переводить не нужно, они должны оставаться в файлах как есть: + +1. Теги не должны быть заменены. Вместо этого следует добавлять теги на языке перевода. +2. Управляющие последовательности, такие как '\n', '\t' или им подобные. +3. Теги HTML вроде `..., ...` и им подобные. + + + diff --git a/GameData/godarklight/ExceptionDetector/Localization/readme-ru.md b/GameData/godarklight/ExceptionDetector/Localization/readme-ru.md new file mode 100644 index 0000000..82c9f8b --- /dev/null +++ b/GameData/godarklight/ExceptionDetector/Localization/readme-ru.md @@ -0,0 +1,172 @@ +--- +permalink: /readme.html +title: Иструкция по переводу и локализации +--- + + + + + + + +# Перевод на ваш язык + +![Языки поддерживаемые в KSP 1.3: Английский, Испанский, Китайский, Русский, Японский](https://i.imgur.com/DbCCJWK.png) + +В версии KSP 1.3 появилась локализация, которая позволяет переводить текст в игре на другие языки. Блягодаря этому большее число людей сможет наслаждаться игрой на предпочитаемом ими языке и сообщество игроков будет только расширяться. Однако, для модов этот процесс не автоматизирован; по умолчанию, мод будет на английском языке, независимо от языка основного клиента игры. Чтобы и основной клиент и моды были доступны на одном языке, при этом отличном от английского, создателю мода нужно проделать дополнительную работу. + +К сожалению, я говорю только на английском, и я разрабатываю и поддерживаю этот мод бесплатно. Поэтому я не могу заниматься переводами самостоятельно и не имею возможности заплатить переводчикам за профессиональный перевод. Лучшее что я могу сделать самостоятельно - это использовать Google Переводчик, который не очень хорошо справляется с краткими и идиоматическими фразами, необходимыми в пользовательском интерфейсе мода KSP. Вместо этого, мне придется полагаться на ваш, многоязычного члена сообщества KSP, профессионализм, чтобы вы показали мне как выглядят по настоящему хорошие переводы. Если вы хотите помочь в этом деле, пожалуйста, подробно изучите этот файл до конца, чтобы узнать, как устроены языковые файлы мода и как подготовить переводы для использования другими игроками. + +Примечание: Несмотря на то что вы редактируете файлы проекта, не бойтесь ошибиться. GitHub сохранит ваши изменения отдельно от основных файлов до тех пор, пока я не проверю их и не подтвержу, что все в норме. Я даже смогу, в случае чего, задавать вам вопросы или просить внести изменения, прежде чем ваша работа будет добавлена в основной код. + +## Языки + +* Поддерживаемые Kerbal Space Program на момент версии 1.12.x + * ![Английский][EN] Английский + * ![Бразильский][BR] Бразильский + * ![Китайский][CN] Упрощенный китайский (中文) + * ![Немецкий][DE] Немецкий (Deutsch) + * ![Испанский][ES]] Испанский (Español) + * ![Французский][FR] Французский (Français) + * ![Итальянский][IT] Итальянский (Italiano) + * ![Японский][JA] Японский (日本語) +* Included as well + * ![Корейский][KO] Корейский (한국어) + * ![Мексиканский испанский][ME] Мексиканский испанский (Español Mexicano) + * ![Голландский][NL] Голландский + * ![Норвежский][NO] Норвежский (Norsk) + * ![Польский][PO] Польский (Polski) + * ![Русский][RU] Русский (Русский) + * ![Шведский][SW] Шведский (Svenska) + * ![Тайваньский][TW]] Тайваньский (国语) + +## Создание или редактирование перевода + +Рекомендуется вносить изменения сначала локально на вашем устройстве, чтобы вы могли их протестировать перед отправкой. Особенно если вы создаете новый перевод с нуля. + +1. Установите последнюю версию xxx мода, если еще этого не сделали. +2. Откройте папку /GameData/xxxMod/Localization на вашем локальном диске. +3. Найдите файл с названием *lang*.cfg, где *lang* - это название языка в KSP; начиная с KSP 1.3, в него входят: + +* en-us (английский) +* es-es (испанский) +* ja (японский) +* ru (русский) +* zh-cn (китайский) + +Дальнейшие действия зависят от того, существует ли файл: + +### Если файл существует + +Чтобы внести улучшения в существующий перевод, выполните следующие действия: + +4. Откройте файл вашего языка в выбранном вами текстовом редакторе. +5. Внесите изменения которые хотели бы видеть в игре (подробнее в разделе [Формат файла](#file-format) ниже) +6. Сохраните ваши изменения +7. Не забудьте [их протестировать](#testing)! + +### Если файл не существует + +Чтобы создать свой собственный перевод с нуля, выполните следующие действия: + +4. Сделайте копию файла `en-us.cfg` в папке `Localization`. +5. Переименуйте файл в соответствии со списком языков выше. +6. Откройте файл вашего языка в выбранном вами текстовом редакторе. +7. Замените третью строку с `en-us` на название вашего языка (подробнее в разделе [Языки](#Languages)) +8. Переведите каждую строку с английского на ваш язык (подробнее в разделе [Формат файла](#file-format) ниже) +9. Сохраните внесенные изменения +10. Не забудьте [их протестировать](#testing)! + +### Формат файла + +Центральная часть файла `cfg` содержит строки, которые нужно перевести. Формат записи выглядит так: `имя = перевод`, где имя - это особая строка, определенная модом. Например: + + #launchSubtitle = Transfers from <<1>>\n(Launch ~<<2>>) + +**Не нужно** изменять часть слева от знака равенства ("=")! Эта часть должна быть одинаковой во всех файлах с переводами. + +Часть справа от знака равенства - это строка, которая будет использоваться в игре. Большая часть текста будет отображаться как есть, но он может содержать несколько особых строк, как показано в [демонстрационном грамматическом модуле Lingoona](http://lingoona.com/cgi-bin/grammar#l=en&oh=1): + +| Строка | Назначение | +| ------- | -------------------------------------------------------------------------------------------------------------------------- | +| \n | Перенос строки; старайтесь сохранить их исходя из исходных строк, чтобы убедиться, что все строки поместятся | +| <<1>> | Первый подставляемый токен в строке, который будет заменен на число, название планеты и т.д., в зависимости от строки | +| <<2>> | Второй токен и так далее | +| <> | Первый токен, но замененный правильным значением | + +Например, вот так может выглядеть перевод строки, указанной выше, на испанский, выполненный через Google Переводчик: + + #launchSubtitle = Transferencias desde <<1>>\n(Lanzamiento ~<<2>>) + +### Тестирование + +Очень важно убедиться что ваши изменения работают корректно. Если вы используете Steam: + +1. [Выберите язык для использования в Steam](https://www.youtube.com/watch?v=iBwYCvQxfeI) +2. Дождитесь полной загрузки языкового пакета +3. Запустите KSP +4. Активируйте xxxMod в игре и убедитесь что ваши изменения работают так, как вы задумывали + +Если вы не пользуетесь Steam, я не знаю какие шаги необходимо предпринять для смены языка. Свяжитесь со SQUAD если не сможете разобраться самостоятельно. + +## Публикация перевода в общий доступ + +После того как вы подготовили `cfg` файл для вашего языка и убедились что все работает как нужно, если вы хотите предоставить его для переиспользования под xxxModd's лицензией - следуйте следующим шагам чтобы загрузить перевод в основной репозиторий: + +1. Войдите в свою учетную запись [GitHub](https://github.com); Вам нужно будет зарегистрировать новый аккаунт если вы заходите туда впервые. +2. Перейдите в папку Localization внутри xxxMod +3. Найдите файл над которым вы работали + +Дальнейшие действия зависят от того, существует ли файл: + +### Если файл существует + +4. Нажмите на название файла чтобы посмотреть его +5. Нажмите на [иконку карандаша](https://help.github.com/assets/images/help/repository/edit-file-edit-button.png) для внесения изменений +6. Замените текст на отредактированный вами локально +7. **Важно**: Внизу страницы, под кнопкой Propose file change, напишите краткое описание своий изменений на английском языке, что именно изменено и почему вы считаете эти правки необходимыми. Это поможет мне понять что правки действительно следует внести. Помните, что я не говорю на языке текста в `cfg` файле, поэтому мне нужно чтобы вы объяснили мне почему ваш вариант лучший! +6. Нажмите на кнопку `Propose file change` внизу страницы, когда вы закончите + +### Если файл не существует + +4. Нажмите на кнопку [Create new file](https://help.github.com/assets/images/help/repository/create_new_file.png) для создания нового файла +5. Введите корректное название файла в поле сверху +6. Вставьте отредактированный вами локально текст в большое поле посередине страницы +8. Нажмите на кнопку `Propose file change` внизу страницы, когда вы закончите + +### Ревью + +Как только вы внесете изменения, GitHub пришлет мне уведомление о том, что появился новый пул реквест. Я обязательно взгляну на него в течении суток или двух и попробую определить валидность правок следующими методами: + +* Убеждаясь что название файла и третья строка в нем совпадают с кодом выбранного языка +* Просмотрев все измененные строки в игре +* Проверив перевод через Google Переводчик +* Спросив нескольких знакомых экспертов +* Запросив помощь на форуме KSP + +Если у меня будут какие-нибдь вопросы касательно конкретных изменений которые вы внесли, я добавлю их в пул реквест, вам должно будет придти уведомление об этом. Пожалуйста, постарайтесь отвечать на эти вопросы как можно оперативнее, насколько вам позволяет ваше время. Ваш пул реквест может быть закрыт без утверждения и добавления ваших правок в основной репозиторий если от вас слишком долго не будет ответа. + +Как только я буду полностью удовлетворен решениями всех возникших вопросов, ваши правки будут добавлены в основной репозиторий и будут включены в следующий релиз. Также, я добавлю ваш никнейм на Github в секцию Acknowledgements в файле README. + +[EN]: https://raw.githubusercontent.com/zer0Kerbal/zer0Kerbal/zed'K/img/EN.png "English" +[BR]: https://raw.githubusercontent.com/zer0Kerbal/zer0Kerbal/zed'K/img/BR.png "Português Brasil" +[CN]: https://raw.githubusercontent.com/zer0Kerbal/zer0Kerbal/zed'K/img/CH.png "中文" +[DE]: https://raw.githubusercontent.com/zer0Kerbal/zer0Kerbal/zed'K/img/DE.png "Deutsch" +[ES]: https://raw.githubusercontent.com/zer0Kerbal/zer0Kerbal/zed'K/img/ES.png "Español" +[FR]: https://raw.githubusercontent.com/zer0Kerbal/zer0Kerbal/zed'K/img/FR.png "Français" +[IT]: https://raw.githubusercontent.com/zer0Kerbal/zer0Kerbal/zed'K/img/IT.png "Italiano" +[JA]: https://raw.githubusercontent.com/zer0Kerbal/zer0Kerbal/zed'K/img/JA.png "日本語" +[KO]: https://raw.githubusercontent.com/zer0Kerbal/zer0Kerbal/zed'K/img/KO.png "한국어" +[MX]: https://raw.githubusercontent.com/zer0Kerbal/zer0Kerbal/zed'K/img/MX.png "Mexicano Español" +[NL]: https://raw.githubusercontent.com/zer0Kerbal/zer0Kerbal/zed'K/img/NL.png "Dutch" +[NO]: https://raw.githubusercontent.com/zer0Kerbal/zer0Kerbal/zed'K/img/NO.png "Norsk" +[PO]: https://raw.githubusercontent.com/zer0Kerbal/zer0Kerbal/zed'K/img/PO.png "Polski" +[RU]: https://raw.githubusercontent.com/zer0Kerbal/zer0Kerbal/zed'K/img/RU.png "Русский" +[SW]: https://raw.githubusercontent.com/zer0Kerbal/zer0Kerbal/zed'K/img/SW.png "Svenska" +[TW]: https://raw.githubusercontent.com/zer0Kerbal/zer0Kerbal/zed'K/img/TW.png "国语" + + diff --git a/GameData/godarklight/ExceptionDetector/Localization/ru.cfg b/GameData/godarklight/ExceptionDetector/Localization/ru.cfg new file mode 100644 index 0000000..e526cc3 --- /dev/null +++ b/GameData/godarklight/ExceptionDetector/Localization/ru.cfg @@ -0,0 +1,28 @@ +// ru.cfg v1.0.0.0 +// Exception Detector (EXCD) +// created: 29 Apr 2023 +// updated: + +// THIS FILE: +// BSD-2-Clause by zer0Kerbal +// generated by: [zer0Kerbal](https://github.com/zer0Kerbal) +// translated by [evanisrael](https://github.com/evanisrael) + +Localization +{ + ru + { + // Addon specific + #EXCD-name = Детектор исключений + #EXCD-abbv = ДИ + #EXCD-tags = исключений детектор ди + + #EXCD-00 = Исключение было вызвано + #EXCD-01 = **ED-Исключение + #EXCD-02 = *ДИ* + #EXCD-03 = НЕИЗВЕСТНАЯ ОШИБКА + #EXCD-04 = Бросков в секунду: + #EXCD-05 = ТОП <<1>> ПРОБЛЕМ + #EXCD-06 = Больше информации доступно в <<1>> + } +}