nemo
/
google-sre-ebook
mirror of https://github.com/captn3m0/google-sre-ebook.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
59 Commits 7 Branches 2 Tags 562 KiB
Shell 52.4%
Ruby 39%
Dockerfile 8.6%
Go to file
dependabot-preview[bot] 7fae963067 Bump nokogiri from 1.10.9 to 1.10.10 
Bumps [nokogiri](https://github.com/sparklemotion/nokogiri) from 1.10.9 to 1.10.10.
- [Release notes](https://github.com/sparklemotion/nokogiri/releases)
- [Changelog](https://github.com/sparklemotion/nokogiri/blob/master/CHANGELOG.md)
- [Commits](https://github.com/sparklemotion/nokogiri/compare/v1.10.9...v1.10.10)

Signed-off-by: dependabot-preview[bot] <support@dependabot.com>
 		2020-08-03 14:01:39 +05:30
cover add support to generate multi book 2019-02-01 06:17:47 +01:00
metadata add The Site Reliability Workbook 2019-02-01 06:28:34 +01:00
.dockerignore Easier Docker workflow 2018-05-17 01:54:54 +05:30
.editorconfig Initial commit 2017-09-16 21:52:31 +05:30
.gitignore Fix Directory Structure Changes (#17) 2018-12-20 23:23:37 +05:30
COPYING Adds License 2017-09-16 23:22:58 +05:30
Dockerfile Switch to debian, fixes #31, closes #32 2020-06-07 00:35:54 +05:30
Gemfile Initial commit 2017-09-16 21:52:31 +05:30
Gemfile.lock Bump nokogiri from 1.10.9 to 1.10.10 2020-08-03 14:01:39 +05:30
README.md Improve typography by switching to pandoc for PDF generation 2020-05-01 03:34:30 +05:30
books.sh better names for output files 2019-02-03 16:10:22 +01:00
generate.rb Improve typography by switching to pandoc for PDF generation 2020-05-01 03:34:30 +05:30
generate.sh Switch to debian, fixes #31, closes #32 2020-06-07 00:35:54 +05:30

README.md

Google SRE Book/s

Generates a EPUB/MOBI/PDF for the Google SRE Book/s.

Original sources are downloaded from https://landing.google.com/sre/books

Visit the Releases page to download the latest release.

Books

Site Reliability Engineering (2016) The Site Reliability Workbook (2018)
site reliability engineering cover the site reliability workbook cover

Build

Docker (Preferred)

Requirements:

  • Docker

You can generate either of books using BOOK_SLUG variable.

Available values for BOOK_SLUG:

  • sre_book Site Reliability Engineering.
  • srw_book The Site Reliability Workbook.
$ docker run --rm --volume "$(pwd):/output" -e BOOK_SLUG='srw_book' captn3m0/google-sre-ebook:latest
  • You should see the final EPUB/MOBI/PDF files in the current directory after the above runs.
  • The file may be owned by the root user.

NOTE: You'll have to allow docker access to a directory that's local to your system. The safest way to do this is as follows:

$ mkdir /tmp/sreoutput
$ chcon -Rt svirt_sandbox_file_t /tmp/sreoutput
$ docker run --rm --volume "/tmp/sreoutput:/output" -e BOOK_SLUG='srw_book' captn3m0/google-sre-ebook:latest

The build for the above Docker image can be audited at https://hub.docker.com/repository/docker/captn3m0/google-sre-ebook/builds.

macOS

Review and run the generate.sh script to generate the EPUB, MOBI, and PDF files

Requirements:

  • Ruby
  • gem install bundler
  • bundle install
  • brew install pandoc
  • brew cask install calibre
  • brew install wget

Known Issues

  • metadata is not complete. There are just too many authors
  • Foreword/Preface is not part of the index
  • The typesetting is not great and does not match the original. See #22 for a list

LICENSE

This is licensed under WTFPL. See COPYING file for the full text.

Extra

I have a list of my E-book publishing related projects at https://captnemo.in/ebooks/.