GitHub - progit2-pl/progit2-pl: Pro Git Wydanie Drugie PL

Witaj w drugim wydaniu Pro Git.

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.

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.