Files

Build files and dirs

• README.md - this readme
• bin - some convenient scripts to manipulate the content
• template - dir with the templates in it including fonts

Bib

• bib - bibliography goes here.

Chapters

• chapters - all chapters from which we can chose

Books

• class - class handbook (finished)
• cluster - cluster handbook (just a collection)
• pi (just a collection)

Creating the Document

Thid document is for the ebooks only

The documentation is very easy to create as it relies on pandoc. To install it you can do the following:

Windows 10, Debian, Ubuntu, and derivatives use package published at

• https://github.com/jgm/pandoc/releases/latest

Mac OSX use homebrew and node

$ brew install node.
$ brew install graphviz
$ npm install --global mermaid-filter
$ brew install pandoc

Once you have installed pandoc you can create the book with our simple Makefile contained in the source directory. Simply clone the source and call make in the source dir

$ mkdir -p ~/github/cloudmesh
$ cd ~/github/cloudmesh
$ git clone https://github.com/cloudmesh-community/book.git
$ cd book/pi
$ make

In case you need to use latex you need to download the full version. For OSX this is

• http://www.tug.org/mactex/mactex-download.html

The Raspbery PI is to small to run LaTeX, so use it to log into a remot resource and run it there.

Go to a dir (example)

$ cd pi

To look at the book, open the text with your favorite e-book reader. On OSX you can say

$ open *.epub

or simply

$ make view