diff --git a/README.md b/README.md index bef3d85..55620d1 100644 --- a/README.md +++ b/README.md @@ -63,8 +63,9 @@ This is a gentle step-by-step guide through the abstract and complex universe of * [Glossary](glossary/) * [Appendix:](appendix/) Other ways to use this book - * [How can I navigate this book offline?](appendix/) - * [How to use the GPU of a RaspberryPi to interact with the examples?](appendix/) + * [How can I navigate this book offline?](appendix/) + * [How to run the examples on a RaspberryPi?](appendix/) + * [How to print this book?](appendix/) ## About the Author diff --git a/appendix/README.md b/appendix/README.md index 0130c80..fef9734 100644 --- a/appendix/README.md +++ b/appendix/README.md @@ -1,12 +1,12 @@ # Appendix: Other ways to use this book -This book is interactive. Is designed to be navigated with a modern web browser that supports WebGL technology (Firefox, Chrome, Safari, between others). But you may encounter the situation that you don't have a computer with no GPU card or not internet. If that's the case the following sections can help you. +This book is designed to be navigated with a modern web browser that supports WebGL technology (Firefox, Chrome, Safari, between others). But you may encounter the situation that you don't have a computer with no GPU card or not internet. If that's the case the following sections can help you. -## Navigate this book off-line? +## How can I navigate this book off-line? Let’s say you have a long trip and you want to use it to teach yourself some shaders. In that case you can make a local copy of this book on your computer and run a local server. -For that you only need Python 2.6 and a git client. On MacOS and Linux computers Python is installed by default but you still need to install a git client. For that: +For that you only need Python 2.6 and a git client. On MacOS and RaspberryPi computers Python is installed by default but you still need to install a git client. For that: In **MacOSX** be sure to have [homebrew](http://brew.sh/) installed and then on your terminal do: @@ -16,7 +16,7 @@ brew upgrade brew install git ``` -On **Linux** you need to do: +On **RaspberryPi** you need to do: ```bash sudo apt-get update @@ -59,3 +59,74 @@ cd ~ git clone https://github.com/patriciogonzalezvivo/thebookofshaders.git cd thebookofshaders ``` + +## 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 update +brew upgrade +brew install git freeimage +brew tap homebrew/versions +brew install glfw3 +cd ~ +git clone http://github.com/patriciogonzalezvivo/glslViewer.git +cd glslViewer +make +make install +``` + +On **RaspberryPi** you need to do: + +```bash +sudo apt-get update +sudo apt-get upgrade +sudo apt-get install git-core libfreeimage +cd ~ +git clone http://github.com/patriciogonzalezvivo/glslViewer.git +cd glslViewer +make +make install +``` + +#### Installing 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 [basictex & MacTeX-Additions](http://www.tug.org/mactex/morepackages.html) and then install [Pandoc](http://johnmacfarlane.net/pandoc/) by: + +```bash +brew install pandoc +``` + +On **RaspberryPi**: + +```bash +sudo apt-get install texlive-xetex pandoc +``` + +#### 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 +``` + +If everything goes well, you will see a ```book.pdf``` file which you can read on your favorite device or print. +