diff --git a/.github/CONTRUBUTING-ru.md b/.github/CONTRUBUTING-ru.md new file mode 100644 index 0000000..67b58da --- /dev/null +++ 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/ diff --git a/.github/README-ru.md b/.github/README-ru.md new file mode 100644 index 0000000..e60c2fb --- /dev/null +++ b/.github/README-ru.md @@ -0,0 +1,106 @@ +
+ +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 + +Использования через тэг ``: + +```html + + + + + + +``` + +### Шрифты + +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 + + + + + + +``` + +## Только 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 diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index b6528de..9d44d6d 100644 --- 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! diff --git a/README.md b/README.md index 5dc399c..409f8e1 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ NES.css is a **NES-style(8bit-like)** CSS Framework.