[TM] Долгосрочное обновление, нативная поддержка 516

.github/CONTRIBUTING.md

@@ -14,6 +14,7 @@
 - [Разработка безопасного кода](#разработка-безопасного-кода)
 - [Файлы](#файлы)
 - [Фишки и лайфхаки Dream Maker](#фишки-и-лайфхаки-dream-maker)
+- [Инструменты перевода](#инструменты-перевода)
 
 </details>
 
@@ -568,3 +569,6 @@ for(var/obj/item/projectile/O as anything() in weapon.content)
 ```
 
 Также вместо **as anything()** можно писать просто **as()**.
+## Инструменты перевода
+
+Если у вас возникло желание или необходимость в переводе определенного текста/вещей, рекомендуется ознакомиться с отдельной статьёй связанной с инструментарием для перевода. Ознакомиться вы можете [здесь.](.github/TRANSLATION.md)

.github/TRANSLATION.md

@@ -0,0 +1,56 @@
+# Перевод на русский язык
+
+* [Макросы для работы с переводами](code/__DEFINES/~mod_celadon/translation.dm)
+
+## Перевод названий объектов
+
+Мы не трогаем оригинальное ``name`` объекта, но заполняем отдельно ``case`` со склонением по падежам:
+
+```dm
+/obj/something
+	name = "Atom"
+	cases = list("атом", "атома", "атому", "атом", "атомом", "атоме")
+```
+
+В массиве каждая позиция соответствует своему падежу, и имеет соответствующий DEFINE:
+
+
+| Падеж         | DEFINE в коде          | Позиция в массиве ``cases`` |
+| ------------- | ---------------------- | --------------------------- |
+| Именительный  | ``NOMINATIVE_CASE``    | 1                           |
+| Родительный   | ``GENITIVE_CASE``      | 2                           |
+| Дательный     | ``DATIVE_CASE``        | 3                           |
+| Винительный   | ``ACCUSATIVE_CASE``    | 4                           |
+| Творительный  | ``ABLATIVE_CASE``      | 5                           |
+| Предложный    | ``PREPOSITIONAL_CASE`` | 6                           |
+
+При необходимости вывести имя объекта в сообщении в чате, мы используем макрос ``CASE()``, который первым параметром принимает объект, имя которого надо вывести, а вторым - DEFINE соответствующего падежа, который нам нужен. Пример:
+
+```dm
+	to_chat(user, "Вы поджигаете [CASE(src, ACCUSATIVE_CASE)] при помощи [CASE(item, GENITIVE_CASE)]!")
+```
+
+Макрос безопасно использовать даже в том случае, если не известно, определены ли у объекта ``case`` - в случае их отсутствия он просто вернет оригинальный ``name``, так что вы сможете это заметить и поправить отдельно.
+
+## Местоимения
+
+Для правильной работы местоимений надо заполнить ``gender`` у объектов. Род может отличаться в английском и русском языке, мы переписываем их на русский манер. Возможные значения ``gender``: ``MALE``, ``FEMALE``, ``NEUTER``.
+
+После мы можем использовать специальные макросы для вывода местоимения объекта:
+
+```dm
+	// Для gender = MALE, выведет "Неудачно пошутив, он падает без признаков жизни"
+	to_chat(user, "Неудачно пошутив, [THEY_RU(src)] падает без признаков жизни") 
+```
+
+Все макросы и примеры использования можно посмотреть [тут](code/__DEFINES/~mod_celadon/translation.dm), раздел "Местоимения(RU)"
+
+## Склонения числительных
+
+``pluralize_russian`` в качестве параметров принимает число (должно быть целое, по необходимости округлите) и склонения числительного для 1, 2, 5 значений:
+
+```dm
+	// корректно выведет "через 1 секунду", "через 3 секунды", "через 10 секунд" и так далее, в зависимости от seconds
+	to_chat(user, "Готовность к полёту через [pluralize_russian(seconds, "секунду", "секунды", "секунд")]!")
+```
+Однако, перед тем как использовать ``pluralize_russian`` в голом виде, убедитесь, что под вашу задачу нет готового инструмента для необходимого вам склонение числительного.

.github/labeler.yml

@@ -100,3 +100,11 @@
     - 'LICENSE'
     - 'README.md'
     - 'SpacemanDMM.toml'
+
+# If anyone wants to update the Russian localization tools or wiki
+'🏴‍☠️ Локализация 🏴‍☠️':
+- changed-files:
+  - any-glob-to-any-file:
+    - 'code/__DEFINES/~mod_celadon/translation.dm'
+    - '.github/TRANSLATION.md'
+