Git Product home page Git Product logo

rusrails's Introduction

Официальный репозиторий проекта RusRails.ru

Проект RusRails является неофициальным переводом официальных руководств по Ruby on Rails

Установка и запуск

  • Скопировать и установить

    $ git clone git://github.com/rusrails/rusrails.git
    $ cd rusrails
    $ bundle install
    
  • Создать конфиг для своих настроек бд (config/database.yml)

  • Создать базу данных и загрузить схему базы данных

     rails db:setup
    
  • Заполнить базу

    $ rails static_docs:import
    
  • Запустить сервер и открыть в браузере

Пул-реквесты

Все пул-реквесты нужно делать в ту ветку, которая выставлена в данный момент текущей на гитхабе!

Нашли ошибку?

  • Находите нужный файл в source (соответствие url на сайте rusrails и имени файла задается в source/index.yml)
  • В интерфейсе есть кнопка Edit
  • Вносите изменение
  • Commit / Push

Нашли много ошибок?

  • Делаете форк. Инструкция по форкам
  • У себя в репозитории правите ошибки (желательно для каждого руководства править ошибки в отдельных ветках)
  • Отправляете пул-реквест

Хотите помочь с переводами?

Для удобного перевода, каждое руководство привязано к определенной ревизии rails/rails, в файле source/index.yml. Таким образом, указывается заголовок на русском, url, имя файла, ревизия и дата коммита.

Алгоритм работы:

  • Делаете форк. Инструкция по форкам
  • Выбираете руководство (степень актуальности всех руководств можно оценить с помощью rails docrails:status)
  • Открываете issue в rusrails, с пометкой о руководстве которое хотите обновить/перевести (чтобы этим руководством никто параллельно не занимался)
  • Смотрите, что изменилось - rails 'docrails:diff[file_name]' > diff.diff - в файле diff.diff
  • В том же файле смотрите информацию по последней ревизии и ее дате, изменяете эти данные в source/index.yml
  • Вносите в нужных местах исправления по диффу
  • Отправляете пул-реквест

Хотите помочь с развитием сайта?

Есть много всяких идей, до которых руки не доходят, например, правки дизайна, социализация, расширение на другие руководства, связанные с Rails, версии в PDF/kindle и т.д.

Предлагайте свои идеи, которые в состоянии реализовать. @RusRails

Развертывание

HTML версия развертывается на Github Pages.

Предполагается, что клон репозитория rusrails/rusrails.github.io находится в той же директории, что и клон rusrails/rusrails.

Тогда rails deploy:start сгенерирует свежую версию и отправит на Гитхаб.

rusrails's People

Contributors

amet13 avatar arnisoft avatar crossaidi avatar davetoxa avatar dependabot[bot] avatar dipiash avatar gentoid avatar harrykiselev avatar himic avatar ivanov-anton avatar ivpal avatar khusnetdinov avatar krdprog avatar leenday avatar maksimabramchuk avatar mgrachev avatar mikdiet avatar nickskalkin avatar orion122 avatar piton4eg avatar r3nya avatar reabiliti avatar tiser avatar v-kolesnikov avatar vieditcom avatar webmstk avatar ydakuka avatar yousysadmin avatar yunique33 avatar zvlex avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

rusrails's Issues

Обновление разделов

Обновлю некоторые разделы, начиная с наиболее старых. Если будете обновлять в это же время, напишите сюда комментарий.

Перевод namespace и scope?

Что-то одно "пространство имен", скорее всего, это - namespace.
А что-то scope...
Предлагаю scope - "область видимости".

generate и create

Еще предлагаю пересмотреть перевод generate и create. Почти везде в гайдах переведено и то, и другое как создают.

А предлагаю:
generate - генерируют
create - создают

Подстветка синтаксиса

Измените подсветку синтаксиса с html+erb на на ruby во всех документах для корректного отображения.

Image 1
Image 2

dockrails:status not working

rake aborted!
Git::GitExecuteError: git  clone '--' '[email protected]:rails/docrails.git' '/Users/nikita/Projects/rusrails/tmp/docrails'  2>&1:Cloning into '/Users/nikita/Projects/rusrails/tmp/docrails'...
Warning: Permanently added the RSA host key for IP address '192.30.253.113' to the list of known hosts.
ERROR: Repository not found.
fatal: Could not read from remote repository.

So there is no docrails repo nowadays, maybe we should replace it with https://github.com/rails/rails/tree/master/guides . Need help with it?

Назначение локали из имени домена: опечатка: разныЕ доменах

URL: http://rusrails.ru/rails-internationalization-i18n-api#naznachenie-lokali-iz-imeni-domena
Контекст: У этого решения есть вышеупомянутые преимущества, однако возможно, что вам нельзя или вы не хотите предоставить разные локализации ("языковые версии") на разные доменах.
Написано: разные доменах
Правильно: разных доменах

Шапка

Ребят, сделайте пжалиста шапку не фиксированной, ужасные проблемы когда смотришь с маленького разрешения, приходится ковырятся через инспектор, или возвращатся на главную. Честно ужасно раздражает, и дмаю не только меня.

493af1932b

Вопрос по разделу form helpers

В след. разделе небольшая путаница:
http://rusrails.ru/rails-form-helpers
http://guides.rubyonrails.org/form_helpers.html

Есть англ. слово: option
И "Select options" переведено как "список варианта выбора".
Где в этой статье использовать перевод как "вариант/вариант выбора", а где как "опций"?

А вообще, это пока самый лучший перевод, что вообще есть/был на rusrails, что я встречал.

Можешь по пунктам расписать, что где на что исправить?

Добавить Ruby on Rails doctrine

Привет всем! Предлагаю добавить Ruby on Rails соглашение на сайт, это очень важная вещь для понимания многих аспекток того как устроен Ruby / Rails и на каких принципах это все работает.

У меня есть цикл статей на Habrahabr:
https://habrahabr.ru/post/327890/
https://habrahabr.ru/post/328942/
https://habrahabr.ru/post/329844/
https://habrahabr.ru/post/330650/

Если утверждаете задачу, то готов приступить к выполению ))

Путаница с названиями и адресами файлов

Встречаются и такое вариант, когда path и file имеют различное написание, и разделитель слов тире.

    path:  active-record-query-interface
    file:  active_record_querying.md

А бывает, что разделитель нижнее подчеркивание, например:

    path:  active_job_basics
    file:  active_job_basics.md

Читаемость стала хуже

Спасибо за труд, за смену дизайна и попытку сделать подачу информации удобнее.

Мое личное ИМХО воспринимать информацию стало не возможно, сейчас поймал себя на том, что бегу на офф сайт.

Шапка нависат и отвлекает, особенно Fork me.

Вот скрин для сравнения: http://imgur.com/a/WWQ6r

Linux Opera 150% масштабирование (becouse "retina")

Резюме:

  1. Шапка давит
  2. Правое меню сложно воспринимать

Странный шрифт

Привет

Это не совсем баг, но я хочу обратить ваше внимание.
Если не устанавливать специально шрифты указанные в ваших css, то получается вот какое не соответствие (см articles_path):


screenshot from 2014-09-15 14 13 45


После того, как я специально установил Menlo, Monaco — стало ок, но ведь этих шрифтов нет по умолчанию в Linux или Windows (не знаю как там в Mac OS). Вам не кажется, что в определении семейства шрифтов следует использовать хотябы один дефолтный шрифт для отображения кода? Типа, если нет всяких там Menlo, Monaco и т.п. отображаем какой нибудь относительно стандартный шрифт (лучше несколько для разных операционок, а не только виндовый Courier New).

С уважением

#315 fixed?

#315 был задеплоен? У меня на локалхост этот баг исправлен, а в удаленной версии - нет, хотя более поздние коммиты, вроде, задеплоены.

Ошибка при правке предыдущего раздела

Не пуш, пожалуйста, последние изменения в ближайшее время
Случайно не туда отправил редакцию нового раздела :(
Я про 335

Файл "source/action_controller_overview.md" еще не проверен.
Там даже много "enter"-ов обозначает место, где остановился в последний раз.

В понедельник займусь этим.

перевод "custom"

in custom Ajax calls - пользовательские или произвольные аякс вызовы?

Либо как-нибудь по-другому?

task и job

:/ ?
И это не только в контексте rake task и Active Job.

asset и resource

Встречал в тексте что оба этих слова переведены как "ресурсы".

Не выделено слово на странице

Добрый день.
По адресу _rusrails.ru/action-mailer-basics в строке
"Action Mailer позволяет определить before_action, after_action и 'around_action'."
не подсвечено слово 'around_action'.

Не работает bundle

Команда bundle install выдаёт такое:

Could not find capistrano-2.13.0 in any of the sources

И действительно, если поискать: gem list | grep capistrano, вывод будет:
capistrano (2.14.1)

"by default" и "default"

Почти везде перепутан перевод этих значений:
generator by default - генератор по умолчанию
default generator - дефолтный генератор

Обычно в тексте встречается только первый вариант.

Потом исправлю.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.