docs: add russian docs translation

2025-01-17 05:38:15 +01:00 · 2019-07-21 22:30:30 +03:00 · 2019-07-21 22:30:30 +03:00 · a13c1c6636
commit a13c1c6636
parent 1719b582ed
4 changed files with 211 additions and 2 deletions
--- a/.github/CONTRUBUTING-ru.md
+++ b/.github/CONTRUBUTING-ru.md
@ -0,0 +1,103 @@
+# Вклад
+
+Посмотри документы на другом языке:
+[简体中文](.github/CONTRIBUTING-zh-CN.md) / [日本語](.github/CONTRIBUTING-jp.md) / [Español](.github/CONTRIBUTING-es.md) / [Português](.github/CONTRIBUTING-pt-BR.md)/ [English](../CONTRIBUTING.md)
+
+Хочешь внести свой вклад в проект? Отлично!
+
+## Вещи, которые следует знать
+
+Этот проект соответствует нормам поведения Contributor Covenant. Если вы участвуете, то должны соответствовать этому кодексу. Пожалуйста, обратите внимание на наши [нормы поведения][code-of-conduct] для того, чтобы сообщать о недопустимом поведении.
+
+**Работашь над своим первым Pull Request'ом?**
+[How to Contribute to an Open Source Project on GitHub][egghead]
+
+## Как мне
+
+* Запустить проект?
+  [Мы тебе поможем!](#запуск-проекта)
+
+* Рассказать о баге?
+  [Дай нам знать!][new-issue]
+
+* Исправить баг?
+  [Сделай PR!][new-pr]
+
+* Добавить новую фичу?
+  Удостоверься, что есть [открытая issue][new-issue]описывающая твою фичу, затем отправь [PR][new-pr] когда будешь готов к обратной связи!
+
+## Запуск проекта
+
+Мы очень рады, что вы хотите внести свой вклад в проект! ❤️ Следующие шаги помогут вам начать работу:
+
+1. Сделай форк и склонируй репозиторий
+2. Установи зависимости:
+    ```sh
+    $ npm install
+    ```
+3. Запустите сервер:
+    ```sh
+    $ npm run storybook
+    ```
+
+### Директории
+```sh
+.
+├── index.html: Демо страница
+├── style.css: Стили демо страницы
+├── css: Поставляемые файлы
+├── docs: Документация Storybook
+└── scss: Исходный код
+    ├── base
+    │   ├── reboot.scss: Не менять! (Bootstrap Reboot)
+    │   ├── generic.scss: Общие стили и reboot.css
+    │   └── variables.scss: Общие переменные
+    ├── elements
+    ├── components
+    ├── form
+    ├── icons: Иконки 16x16
+    ├── pixel-arts: Для иконов, имеющих отличный от 16x16 формат.
+    └── utilities
+```
+
+> Совет: Следжи за тем, чтобы ваша ветка `master` указывала на оригинальный репозиторий и делайте свои Pull Request'ы из веток своего форка. Для этого запустите:
+>
+> ```
+> git remote add upstream https://github.com/nostalgic-css/NES.css.git
+> git fetch upstream
+> git branch --set-upstream-to=upstream/master master
+> ```
+>
+> Это добавит оригинальный репозиторий, как "удалённый" под именем "upstream" получит всю нужную информацию из него и сделает так, чтобы ваша ветка `master` использовала `upstream/master` когда вы делаете `git pull`. Теперь вы можете ветвиться от `master` . Когда вы захотите обновить свой `master`, сделайте `git pull`.
+
+## Вклад для членов организации `nostalgic-css`
+
+Ниже приведены шаги, которым должны следовать члены организации `nostalgic-css`. Внешние сотрудники должны следовать только вышеуказанным рекомендациям.
+
+### Шаги для разработки
+
+1. Ветвитесь от `develop` используя следующие правила.
+2. Делайте работу, нужную для закрытия issue. Если вы делаете что-то что не удволетворяет открытым issue, [создайте новое][new-issue] и делайте работу в отдельной ветке.
+3. Отправте ваш PR в `develop`.
+    * Любое изменение должно быть задокументированно.
+    * PR, который решает какое-то issue должен включать номер issue в заголовке. Например: `[#33] исправил ошибку`
+    * Назначте PR на себя.
+    * Когда PR готов к тому, чтобы стать частью основной ветки, вы должны запросить ревью у команды `nostalgic-css/NES.css`.
+4. Когда изменения в вашем PR подтверждены, тот, на кого вы **назначили** ваш PR должен залить ваши изменения в основную ветку.
+
+### Форматирование коммитов
+
+Мы используем [Commitizen][commitizen] и [`commitlint`][commitlint] для того, чтобы все коммиты в репозиторий легко читались, и [`semantic-release`][semantic-release] чтобы наши релизы были автоматизированы, [неромантичны и несентиментальны][sentimental-versioning].
+
+
+
+
+
+[code-of-conduct]: CODE_OF_CONDUCT.md
+[commitizen]: https://github.com/commitizen/cz-cli
+[commitlint]: [https://github.com/marionebl/commitlint]
+[egghead]: https://egghead.io/series/how-to-contribute-to-an-open-source-project-on-github
+[new-issue]: https://github.com/nostalgic-css/NES.css/issues/new/choose
+[new-pr]: https://github.com/nostalgic-css/NES.css/compare/develop...develop
+[semantic-release]: https://github.com/semantic-release/semantic-release
+[sentimental-versioning]: http://sentimentalversioning.org/
--- a/.github/README-ru.md
+++ b/.github/README-ru.md
@ -0,0 +1,106 @@
+<div align="center">
+  <a href="https://nostalgic-css.github.io/NES.css/" target="_blank"><img src="https://user-images.githubusercontent.com/5305599/49061716-da649680-f254-11e8-9a89-d95a7407ec6a.png" alt="NES.css: NES-style  CSS framework" style="max-width: 100%;" width="600" height="315"></a>
+
+  <a href="README.md">English</a> / <a href=".github/README-jp.md">日本語</a> / <a href="README-zh-CN.md">简体中文</a> / <a href=".github/README-pt-BR.md">Português</a>
+</div>
+
+NES.css - это CSS фреймворк в стиле **NES(8bit)**
+
+[![Gitter][gitter-badge]][gitter] [![Commitizen friendly][commitizen-badge]][commitizen]
+
+## Установка
+
+### С помощью стилей
+
+NES.css доступен через npm (более предпочтительный), Yarn, или CDN.
+
+#### Через менеджер пакетов
+
+```shell
+npm install nes.css
+# или
+yarn add nes.css
+```
+
+Наш `package.json` содержит дополнительную информацию в этих полях:
+* `sass` - Путь до главного Sass файла
+* `style` - Путь до неминифицированного CSS
+
+#### Через CDN
+
+Использования через тэг `<link />`:
+
+```html
+<!-- Миницифированные -->
+<link href="https://unpkg.com/nes.css@2.2.0/css/nes.min.css" rel="stylesheet" />
+<!-- Последние -->
+<link href="https://unpkg.com/nes.css@latest/css/nes.min.css" rel="stylesheet" />
+<!-- Только основные стили -->
+<link href="https://unpkg.com/nes.css/css/nes-core.min.css" rel="stylesheet" />
+```
+
+### Шрифты
+
+NES.css не предоставляет никаких шрифтов, но мы поддерживаем следующие шрифты, которые рекомендуются к использованию с этой билиотекой
+
+| Язык         | Шрифт                                                              |
+|--------------|--------------------------------------------------------------------|
+| По умолчанию | [Press Start 2P](https://fonts.google.com/specimen/Press+Start+2P) |
+| Английский   | [Kongtext](https://www.dafont.com/kongtext.font)                   |
+| Японский     | [美咲フォント](http://littlelimit.net/misaki.htm)                  |
+| Японский     | [Nu もち](http://kokagem.sakura.ne.jp/font/mochi/)                 |
+| Корейский    | [둥근모꼴](http://cactus.tistory.com/193)                          |
+
+## Использование
+
+NES.css предоставляет компоненты. Вам нужно будет определить собственный лейаут.
+
+Рекомендуемый для NES.css шрифт - [Press Start 2P][press-start-2p-font]. Однако, [Press Start 2P][press-start-2p-font] поддерживает только латинские символы. Когда вы используете NES.css не с английским языком, используйте другой шрифт. Cледуйте [инструкции][google-fonts-guide] Google Fonts про то, как их использовать или используйте их так:
+
+```html
+<head>
+    <link href="https://fonts.googleapis.com/css?family=Press+Start+2P" rel="stylesheet">
+    <link href="https://unpkg.com/nes.css/css/nes.css" rel="stylesheet" />
+
+    <style>
+      html, body, pre, code, kbd, samp {
+          font-family: "font-family который вы хотите использовать";
+      }
+    </style>
+</head>
+```
+
+## Только CSS
+
+Для NES.css нужен только CSS и совсем не нужен JavaScript
+
+## Поддержка браузерами
+
+NES.css совместим с новейшими версяями следующих браузеров:
+* Chrome
+* Firefox
+* Safari
+
+Работоспособность не гарантируется:
+* IE/Edge
+
+## Лицензия и защита авторских прав
+
+Código y documentación copyright 2018 [B.C.Rikko](https://github.com/BcRikko). Код выпущен под лицензией MIT. Документация выпущена под лицензией Creative Commons.
+
+
+## Разработка
+
+Мы всегда рады вкладам! Обратите внимание [`CONTRIBUTING.md`][contributing-document] для большего количества деталей о том, как вы можете помочь нам делать NES.css более крутым!
+
+
+
+
+
+[commitizen]: http://commitizen.github.io/cz-cli/
+[commitizen-badge]: https://img.shields.io/badge/commitizen-friendly-brightgreen.svg
+[contributing-document]: ./CONTRIBUTING-es.md
+[gitter]: https://gitter.im/nostalgic-css/Lobby
+[gitter-badge]: https://img.shields.io/gitter/room/nostalgic-css/Lobby.svg
+[google-fonts-guide]: https://developers.google.com/fonts/docs/getting_started
+[press-start-2p-font]: https://fonts.google.com/specimen/Press+Start+2P?selection.family=Press+Start+2P
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@ -1,7 +1,7 @@
 # Contributing

 View this document in another language:
-[简体中文](.github/CONTRIBUTING-zh-CN.md) / [日本語](.github/CONTRIBUTING-jp.md) / [Español](.github/CONTRIBUTING-es.md) / [Português](.github/CONTRIBUTING-pt-BR.md)
+[简体中文](.github/CONTRIBUTING-zh-CN.md) / [日本語](.github/CONTRIBUTING-jp.md) / [Español](.github/CONTRIBUTING-es.md) / [Português](.github/CONTRIBUTING-pt-BR.md) / [Русский](.github/CONTRIBUTING-ru.md)

 You want to contribute to the project? Awesome!

--- a/README.md
+++ b/README.md
@ -1,7 +1,7 @@
 <div align="center">
  <a href="https://nostalgic-css.github.io/NES.css/" target="_blank"><img src="https://user-images.githubusercontent.com/5305599/49061716-da649680-f254-11e8-9a89-d95a7407ec6a.png" alt="NES.css: NES-style  CSS framework" style="max-width: 100%;" width="600" height="315"></a>

-  <a href=".github/README-jp.md">日本語</a> / <a href=".github/README-zh-CN.md">简体中文</a> / <a href=".github/README-es.md">Español</a> / <a href=".github/README-pt-BR.md">Português</a>
+  <a href=".github/README-jp.md">日本語</a> / <a href=".github/README-zh-CN.md">简体中文</a> / <a href=".github/README-es.md">Español</a> / <a href=".github/README-pt-BR.md">Português</a> / <a href=".github/README-ru.md">Русский</a>
 </div>

 NES.css is a **NES-style(8bit-like)** CSS Framework.