google-sre-ebook/README.md

# google-sre-ebook

![Cover](cover.jpg)

Generates a EPUB/MOBI for the Google SRE Book.

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

# Build

## 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

## Docker

Requirements:

- Docker

```
$ ./build_docker.sh
```

# 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


# LICENSE

This is licensed under WTFPL. See COPYING file for the full text.
Initial commit 2017-09-16 16:22:31 +00:00			`# google-sre-ebook`

			`![Cover](cover.jpg)`

Working script in ruby 2017-09-16 17:45:59 +00:00			`Generates a EPUB/MOBI for the Google SRE Book.`
Initial commit 2017-09-16 16:22:31 +00:00
			`Original sources are downloaded from https://landing.google.com/sre/`

Add support for building eBook with Docker This change adds support for building the eBook with Docker. Supporting Docker means that users who want to build the eBook do not have to install Ruby/Bundler/Calibre in their environments. I'm a Docker n00b, so if there's a better way to handle file permissions on the output, I'm all ears. Build tested on Linux. Outputs were fine. There is also a change to the pandoc outputs. It seems the `+smart` extension is not supported for epub/html[0] in their latest versions. [0] - https://pandoc.org/MANUAL.html#extension-smart 2018-05-15 17:41:05 +00:00			`# Build`

			`## macOS`

Working script in ruby 2017-09-16 17:45:59 +00:00			Review and run the `bootstrap.sh` script to generate the EPUB and MOBI files
Initial commit 2017-09-16 16:22:31 +00:00
Working script in ruby 2017-09-16 17:45:59 +00:00			`Requirements:`

			`- Ruby`
updated bootstrap script, requirements README 2018-01-16 16:59:30 +00:00			`- gem install bundler`
			`- gem install nokogiri`
Adding missing Requirement on README.md 2018-04-08 04:17:47 +00:00			`- brew install pandoc`
updated bootstrap script, requirements README 2018-01-16 16:59:30 +00:00			`- brew cask install calibre`
Adds wget as a dependency - Closes #7 2018-05-04 14:17:24 +00:00			`- brew install wget`
Updates README 2017-09-16 17:47:03 +00:00
Add support for building eBook with Docker This change adds support for building the eBook with Docker. Supporting Docker means that users who want to build the eBook do not have to install Ruby/Bundler/Calibre in their environments. I'm a Docker n00b, so if there's a better way to handle file permissions on the output, I'm all ears. Build tested on Linux. Outputs were fine. There is also a change to the pandoc outputs. It seems the `+smart` extension is not supported for epub/html[0] in their latest versions. [0] - https://pandoc.org/MANUAL.html#extension-smart 2018-05-15 17:41:05 +00:00			`## Docker`

			`Requirements:`

			`- Docker`

			```
			`$ ./build_docker.sh`
			```

Updates README 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`
Adds License 2017-09-16 17:52:58 +00:00

			`# LICENSE`

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