2017-09-16 16:22:31 +00:00
|
|
|
# google-sre-ebook
|
|
|
|
|
|
|
|
![Cover](cover.jpg)
|
|
|
|
|
2017-09-16 17:45:59 +00:00
|
|
|
Generates a EPUB/MOBI for the Google SRE Book.
|
2017-09-16 16:22:31 +00:00
|
|
|
|
|
|
|
Original sources are downloaded from https://landing.google.com/sre/
|
|
|
|
|
2018-05-15 17:41:05 +00:00
|
|
|
# Build
|
|
|
|
|
2018-05-16 20:24:54 +00:00
|
|
|
## Docker (Preferred)
|
2017-09-16 16:22:31 +00:00
|
|
|
|
2017-09-16 17:45:59 +00:00
|
|
|
Requirements:
|
|
|
|
|
2018-05-16 20:24:54 +00:00
|
|
|
- Docker
|
2017-09-16 17:47:03 +00:00
|
|
|
|
2018-05-16 20:24:54 +00:00
|
|
|
`docker run --rm --volume "$(pwd):/output" captn3m0/google-sre-ebook:latest`
|
2018-05-15 17:41:05 +00:00
|
|
|
|
2018-05-16 20:24:54 +00:00
|
|
|
- You should see the final EPUB/MOBI files in the `output` directory after the above runs.
|
|
|
|
- The file may be owned by the root user.
|
2018-05-15 17:41:05 +00:00
|
|
|
|
2018-05-16 20:24:54 +00:00
|
|
|
The build for the above Docker image can be audited at <https://cloud.docker.com/swarm/captn3m0/repository/docker/captn3m0/google-sre-ebook/builds>.
|
2018-05-15 17:41:05 +00:00
|
|
|
|
2018-05-16 20:24:54 +00:00
|
|
|
## macOS
|
|
|
|
|
|
|
|
Review and run the `bootstrap.sh` script to generate the EPUB and MOBI files
|
|
|
|
|
|
|
|
Requirements:
|
|
|
|
|
|
|
|
- Ruby
|
|
|
|
- `gem install bundler`
|
|
|
|
- `gem install nokogiri`
|
|
|
|
- `brew install pandoc`
|
|
|
|
- `brew cask install calibre`
|
|
|
|
- `brew install wget`
|
2018-05-15 17:41:05 +00:00
|
|
|
|
2017-09-16 17:47:03 +00:00
|
|
|
# Known Issues
|
|
|
|
|
|
|
|
- Inline references are not handled in the best possible way
|
|
|
|
- metadata.xml is not complete. There are just too many authors
|
|
|
|
- Foreword/Preface is not part of the index
|
2017-09-16 17:52:58 +00:00
|
|
|
|
|
|
|
# LICENSE
|
|
|
|
|
|
|
|
This is licensed under WTFPL. See COPYING file for the full text.
|