Google SRE 电子书生成器使用教程

1. 项目的目录结构及介绍

google-sre-ebook/
├── COPYING
├── Dockerfile
├── Gemfile
├── Gemfile.lock
├── README.md
├── books.sh
├── generate.rb
└── generate.sh

• COPYING: 项目的许可证文件，采用 WTFPL 许可证。
• Dockerfile: 用于构建 Docker 镜像的文件。
• Gemfile 和 Gemfile.lock: 用于管理 Ruby 依赖的文件。
• README.md: 项目的说明文档。
• books.sh: 用于处理书籍的脚本文件。
• generate.rb 和 generate.sh: 用于生成电子书的脚本文件。

2. 项目的启动文件介绍

项目的启动文件主要是 generate.sh 和 books.sh。

• generate.sh: 该脚本用于生成电子书文件（EPUB/MOBI/PDF）。使用 Docker 运行时，可以通过设置 BOOK_SLUG 变量来选择生成哪本书。

  示例命令：

  docker run --rm --volume "$(pwd):/output" -e BOOK_SLUG='srw_book' captn3m0/google-sre-ebook:latest
  

• books.sh: 该脚本用于处理书籍的相关操作，具体功能在脚本中有详细说明。

3. 项目的配置文件介绍

项目的配置文件主要是 Dockerfile 和 Gemfile。

• Dockerfile: 该文件定义了如何构建 Docker 镜像，包括基础镜像、安装依赖、运行脚本等步骤。

  关键部分：

  FROM ruby:2.7-slim
  RUN apt-get update && apt-get install -y \
      build-essential \
      libxml2-dev \
      libxslt-dev \
      zlib1g-dev \
      wget \
      unzip \
      && rm -rf /var/lib/apt/lists/*
  COPY . /app
  WORKDIR /app
  RUN bundle install
  

• Gemfile: 该文件列出了项目所需的 Ruby 依赖包。

  示例内容：

  source 'https://rubygems.org'
  gem 'nokogiri'
  gem 'epub-maker'
  

通过以上配置文件和启动文件，用户可以构建 Docker 镜像并生成所需的电子书文件。