Pro Git, wydanie drugie

Witaj w drugim wydaniu Pro Git.

Możesz znaleźć tę książkę w wersji online: http://git-scm.com/book

Wydanie drugie tak jak wydanie pierwsze udostępniane jest na licencji Creative Commons.

Zmieniono kilka rzeczy od czasu pierwszego wydania. Po pierwsze, przenieśliśmy tekst książki z Markdown do wspaniałego formatu Asciidoc.

Przenieśliśmy tłumaczenenia do oddzielnych repozytoriów zamiast podkatalogów w angielskim repozytorium. Zajrzyj do przewodnika po wiecej informacji.

Jak wygenerować książkę

Są trzy sposoby na wygenerowanie zawartości e-book’a z tego kodu źródłowego.

Najłatwiej powierzyć to nam. Robot czeka na nowe zmiany w głównej gałęzi i dokonuje automatycznej budowy dla wszystkich.

Aktualną wersję znajdziesz tutaj: https://git-scm.com/book.

Innym sposobem jest użycie Docker-a, za pomocą polecenia docker-compose stworzy się nam środowisko które wygeneruje ksiązki w HTML, Epub i PDF

-- Dodanie zmiennych twojego użutkownika i grupy, aby pliki miały uprawnienia twojego użytkownika.
$ export UID=${UID}
$ export GID=${GID}

-- Uruchomienie generowania książek.
$ docker-compose up

Ostatnim sposoben jest ręczna budowa za pomocą Asciidoctor. Po uruchomieniu poniższych poleceń możesz uzyskać pliki wyjściowe w formatach HTML, Epub i PDF:

$ bundle install
$ bundle exec rake book:build
Converting to HTML...
 -- HTML output at progit.html
Converting to EPub...
 -- Epub output at progit.epub
Converting to PDF...
 -- PDF  output at progit.pdf

Użyto tutaj asciidoctor, asciidoctor-pdf i asciidoctor-epub.

Wsparcie

Jeśli chcesz pomóc zmieniając lub wspierając tłumaczenie, zajrzyj tutaj: przewodnik