Skip to content

Commit 158af24

Browse files
committed
Update README
1 parent 017c648 commit 158af24

File tree

1 file changed

+25
-8
lines changed

1 file changed

+25
-8
lines changed

README.asc

Lines changed: 25 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -10,14 +10,13 @@ image:https://travis-ci.org/progit/progit2-ru.svg?branch=master["Build Status",
1010

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

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

1817
== Участие
1918

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

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

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

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

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

32-
Другой способ получить кнугу -- собрать её самостоятельно с помощью Asciidoctor.
33-
Используя команды ниже, вы сможете получить HTML, Epub, Mobi и PDF файлы:
31+
Другой способ получить книгу -- собрать её самостоятельно с помощью Asciidoctor.
32+
Раньше мы могли собирать файлы .mobi (Kindle), но сейчас не можем, см. https://github.com/progit/progit2/issues/1496[#1496] для получения дополнительной информации.
33+
Используя команды ниже, вы сможете получить HTML, Epub и PDF-файлы:
3434

3535
----
36+
$ bundle config set --local path '.bundle/vendor'
3637
$ bundle install
3738
$ bundle exec rake book:build
39+
Downloading locale attributes file...
40+
-- Saved at attributes-ru.adoc
3841
Converting to HTML...
3942
-- HTML output at progit.html
4043
Converting to EPub...
4144
-- Epub output at progit.epub
42-
Converting to Mobi (kf8)...
43-
-- Mobi output at progit.mobi
4445
Converting to PDF...
4546
-- PDF output at progit.pdf
47+
Validating generated files...
48+
-- Validate HTML file progit.html
49+
Running ["ScriptCheck", "LinkCheck", "ImageCheck", "HtmlCheck"] on progit.html on *.html...
50+
51+
52+
Checking 89 external links...
53+
Ran on 1 file.
54+
55+
56+
HTML-Proofer finished successfully.
57+
-- Validate EPUB output file progit.epub
58+
Validating using EPUB version 3.2 rules.
59+
No errors or warnings detected.
60+
Messages: 0 fatals / 0 errors / 0 warnings / 0 infos
61+
62+
EPUBCheck completed
4663
----
4764

4865
Здесь используются проекты `asciidoctor`, `asciidoctor-pdf` и `asciidoctor-epub`.
4966

5067
По умолчанию, `bundle install` устанавливает зависимости глобально в систему.
51-
Чтобы этого избежать, следует сконфигурировать менеджер пакетов перед установкой зависимостей с помощью следующей команды:
68+
Чтобы этого избежать, в примере выше менеджер пакетов дополнительно конфигурируется перед установкой зависимостей с помощью следующей команды:
5269

5370
----
5471
bundle config set --local path '.bundle/vendor'

0 commit comments

Comments
 (0)