Giter Club home page Giter Club logo

book's Introduction

Publications for classes

โ„น๏ธ ePubs are best read on MacOS with ibooks, on Windows with Microsoft Edge, on Linux with Calibre

Link Class Description
E516, E416, B649 Evolving Lecture notes for class E516, E416, B649
E516, E416, B649 Evolving Lecture notes for Raspberry PI Clusters for class E516, E416, B649
e534, I523, I423 Evolving Lecture notes for class e534, I523, I423
e534, I523, I423 Cloud Technologies
e222 Intelligent Systems Engineering II
all Scientific Writing with Markdown
all Scientific Writing I
all Scientific Writing II
all Class Communication Services (update version can be found in the Lecture notes for the class)
๐Ÿ“š Bibliographies I all BibTeX files directory I as used in all but the Cloud Technologies ePub
๐Ÿ“š Bibliographies II - Cloud Technologies all BibTeX files directory II as used in the Cloud Technologies ePub

https://github.com/cloudmesh-community/book/blob/main/

Cloudmesh Community ePup Publication Framework

โš ๏ธ This section is only for those that like to generate their own ePubs based on our framework

ePubs can be easily created as they are build on a template. E good template is provided in the directory cloud

You simply copy that directory to your own directory. let us assume we call it mybook. Note that we use all loer case letters to avoid complications while misspelling the directory

You will have to edit now the file called Makefile and change the value BOOK_516 to BOOK_MYBOOK. Let us assume you use emacs

$ emacs mybook/Makefile

Now you have to edit the file chapters.yml in the book directory and add chapters you like to include in your ePub. See some of the examples we provided for other ebooks. It is now important that you use the same name we used before, e.g. BOOK_MYBOOK. Thus create in the yaml file a list of chapters for it.

$ emacs chapters.yml
$ yamllint chapters.yaml

To avoid any yaml errors, just use yamllint to check your file and correct all errors and warnings.

An example would be

- BOOK_MYBOOK:
     - chapters/linux/refcards.md

To compile the book, you first have to generate an initial Makefile, which you can do with the command

../bin/manifest-parser.py dep BOOK_MYBOOK > Makefile.BOOK_MYBOOK

Now the framework is all set up and you can add your new chapters in ./chapters while referring to them in the chapters.yaml file for your book

To create the book simply do the following

$ cd mybook
$ make

To view it say

$ make view

Installation Instructions

This 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

Mac OSX use homebrew and node

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

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-community
$ cd ~/github/cloudmesh-community
$ git clone https://github.com/cloudmesh-community/book.git
$ cd book
$ pip install -r requirements

Then chose the book you like to compile. Let us assume the book is in the cloud directory. Than you can create it with

$ cd cloud
$ make images
$ make

In case you like to compile another book just replace the cloud we used in the previous step with the book you like. This includes at this time

  • big-data-applications
  • cloud
  • communicate
  • writing-1

Draft bpooks include

  • cluster
  • pi

LaTeX

The directory latex is different and it requires latex to be installed as a PDF is created that showcases you how to efficeintly use LaTeX

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

Cabal

notes only at this time

mkdir pandoc
cabal update
cd pandoc
cabal sandbox init
cabal install pandoc-crossref
cabal install pandoc-citeproc

book's People

Contributors

laszewsk avatar tangqianq avatar bfeng avatar pulasthi avatar mallik3006 avatar tbalson avatar kelifine avatar trawat87 avatar fugangwang avatar manjunathsivan avatar vibhatha avatar keithhickman08 avatar nirandaperera avatar jonathanbranam avatar vafa-andalibi avatar rirasto avatar anandid avatar anthonyduer avatar mihirns avatar kennethj avatar iumsds avatar btpope avatar joshish-iu avatar tandon-ritz avatar mcheruvu avatar ahilgenkamp avatar keithhickman07 avatar tvangalapat avatar hrbahramian avatar swsachith avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.