nemo/google-sre-ebook
1
0
Fork 0
mirror of https://github.com/captn3m0/google-sre-ebook.git synced 2024-09-13 13:47:41 +00:00
Code Issues Projects Releases Wiki Activity
59 Commits 10 Branches 2 Tags 610 KiB
Shell 53.7%
Ruby 38.3%
Dockerfile 8%
pandoc-yml
Go to file
Nemo 3e8bf8c233 WIP attempt to use pandoc YML format 
- Adds smart quotes
- Removes double captions from tables and figures
2020-06-17 16:31:22 +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
books.sh better names for output files 2019-02-03 16:10:22 +01:00
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.8 to 1.10.9 2020-03-27 01:34:50 +05:30
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
pandoc.yml WIP attempt to use pandoc YML format 2020-06-17 16:31:22 +05:30
README.md Improve typography by switching to pandoc for PDF generation 2020-05-01 03:34:30 +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/.