Skip to content

Обновить README #386

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Morganov merged 1 commit into from
May 11, 2021
Merged

Обновить README #386

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 8 additions & 9 deletions README.asc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,14 +10,13 @@ image:https://travis-ci.org/progit/progit2-ru.svg?branch=master["Build Status",

С момента публикации первого издания многое изменилось.
Для начала, мы перешли с Markdown на AsciiDoc -- вот краткий справочник по синтаксису https://docs.asciidoctor.org/asciidoc/latest/syntax-quick-reference/[AsciiDoc].
К тому же мы теперь используем https://atlas.oreilly.com[Atlas] от О'Рейли для постоянной сборки книги, так что все основные форматы всегда в наличии.

Еще мы убрали переводы из подразделов английского языка в отдельные репозитории.
Подробнее в пункте про переводы.

== Участие

Чтобы исправить ошибку или добавить что-то новое в этот репозиторий, вам нужно открыть пулл-реквест на GitHub.
Чтобы исправить ошибку или добавить что-то новое в этот репозиторий, вам нужно открыть запрос на слияние (Pull Request) на GitHub.

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

Expand All @@ -27,10 +26,10 @@ image:https://travis-ci.org/progit/progit2-ru.svg?branch=master["Build Status",

Самый простой -- поручить это нам. Робот реагирует на изменения в ветке `master` репозитория и автоматически собирает книгу во всех форматах.

Текущую сборку можно найти на https://git-scm.com/book/ru/v2.
Текущую сборку можно найти на странице https://git-scm.com/book/ru/v2.

Другой способ получить книгу -- собрать её самостоятельно с помощью Asciidoctor.
Используя команды ниже, вы сможете получить HTML, Epub, Mobi и PDF файлы:
Используя команды ниже, вы сможете получить книгу в форматах HTML, EPUB и PDF.

----
$ bundle config set --local path '.bundle/vendor'
Expand All @@ -40,8 +39,8 @@ Downloading locale attributes file...
-- Saved at attributes-ru.adoc
Converting to HTML...
-- HTML output at progit.html
Converting to EPub...
-- Epub output at progit.epub
Converting to EPUB...
-- EPUB output at progit.epub
Converting to PDF...
-- PDF output at progit.pdf
Validating generated files...
Expand Down Expand Up @@ -79,7 +78,7 @@ bundle config set --local path '.bundle/vendor'
bundle exec rake book:build_html
----

Для генерации только EPUB файла:
Для генерации только EPUB-файла:

----
bundle exec rake book:build_epub
Expand All @@ -99,13 +98,13 @@ bundle exec rake book:build_pdf
bundle exec rake book:check_html
----

Для проверки EPUB файла:
Для проверки EPUB-файла:

----
bundle exec rake book:check_epub
----

Обратите внимание, что для запуска проверки EPUB файла требуется наличие установленного JRE.
Обратите внимание, что для запуска проверки EPUB-файла требуется наличие установленного JRE.

== Переводы

Expand Down