mirror of
https://github.com/patriciogonzalezvivo/thebookofshaders
synced 2024-11-11 13:10:57 +00:00
3c85984cb0
Add epub metadata & placeholder cover image Refactor parseBook.py and extend Makefile to enable support for more formats Update appendix 2 Add book.epub to .gitignore
73 lines
2.2 KiB
Markdown
73 lines
2.2 KiB
Markdown
## How to print this book?
|
||
|
||
Let’s say you don’t want to navigate or interact with the examples and you just want a good old fashion text book which you can read on the beach or on your commute to the city. In that case you can print this book.
|
||
|
||
|
||
#### Installing glslViewer
|
||
|
||
For printing this book you need first to parse it. For that you will need [`glslViewer`](https://github.com/patriciogonzalezvivo/glslViewer) a console shader tool that will compile and transform the shader examples into images.
|
||
|
||
In **MacOSX** get sure to have [homebrew](http://brew.sh/) installed and then on your terminal do:
|
||
|
||
```bash
|
||
brew install glslviewer
|
||
```
|
||
|
||
On **Raspberry Pi** you need to get [Raspbian](https://www.raspberrypi.org/downloads/raspbian/), a Debian-based Linux distribution made for Raspberry Pi and then do:
|
||
|
||
```bash
|
||
sudo apt-get update
|
||
sudo apt-get upgrade
|
||
sudo apt-get install git-core glslviewer
|
||
```
|
||
|
||
#### Installing Python 2.7, Latex Engine and Pandoc
|
||
|
||
For parsing the Markdown chapters into Latex and then into a PDF file we will use Xetex Latex Engine and Pandoc.
|
||
|
||
In **MacOSX**:
|
||
|
||
Download and Install MacTeX by:
|
||
|
||
```bash
|
||
brew cask install mactex-no-gui
|
||
```
|
||
|
||
and then install [Pandoc](http://johnmacfarlane.net/pandoc/) and Python 2 by:
|
||
|
||
```bash
|
||
brew install pandoc python@2
|
||
```
|
||
|
||
On **Raspberry Pi** (Raspbian):
|
||
|
||
```bash
|
||
sudo apt-get install texlive-xetex pandoc python2.7
|
||
```
|
||
|
||
#### Compile the book into a pdf and print it
|
||
|
||
Now that you have all you need, it is time to clone [the repository of this book](https://github.com/patriciogonzalezvivo/thebookofshaders) and compile the book.
|
||
|
||
For that open your terminal once again and type:
|
||
|
||
```bash
|
||
cd ~
|
||
git clone https://github.com/patriciogonzalezvivo/thebookofshaders.git
|
||
cd thebookofshaders
|
||
make clean pdf
|
||
```
|
||
|
||
If everything goes well, you will see a `book.pdf` file which you can read on your favorite device or print.
|
||
|
||
#### Compile the book into an epub for use with an e-reader
|
||
|
||
```bash
|
||
cd ~
|
||
git clone https://github.com/patriciogonzalezvivo/thebookofshaders.git
|
||
cd thebookofshaders
|
||
make clean epub
|
||
```
|
||
|
||
The generated `book.epub` can be used directly, or converted to a `.mobi` file for use with Kindle by using a converter, for example Calibre.
|