Name: clojurescript-unraveled
Owner: funcool
Description: An open source book about ClojureScript
Created: 2015-03-15 20:32:35.0
Updated: 2018-01-15 06:08:20.0
Pushed: 2017-12-07 11:20:31.0
Homepage: http://funcool.github.io/clojurescript-unraveled/
Size: 12317
Language: XSLT
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
An open source ClojureScript book. Read an HTML version here. A version for ebook readers (epub, mobi) is available on Leanpub, where you have the opportunity to make a donation and buy us a beer.
This books aims to serve as:
As such, it is divided into three main sections: Language, Tooling & Compiler, and Mixed Bag.
At this moment the book is still being written and is mostly incomplete.
We are not native English speakers, so language improvements and typo fixes are very, very welcome!
This is a quick and dirty FAQ:
Please, maintain the commit size small for easy commits picking.
Rules for text formatting:
General note:
At this moment, we do not have plans to accept new chapters until the the basic book structure is finished. This is not because we don't want to, but because it's very difficult to handle that at this stage of the book. That being said, proposals are very welcome.
The book is written using asciidoctor, so you should install the last version of asciidoctor using your package manager. The asciidoctor is responsible of the generation of the online html format. So if you are happy with a local copy in html format, this is a unique dependency that you need.
This is a command for generate the html:
html
mium dist/index.html
If you want to generate a pdf. Some additional depencies are needed. For this process we are using fopub tool (included in the repo) that requires the JDK 7 or 8.
For generate pdf, having jdk installed, execute this:
git
pdf
is will generate dist/clojurescript-unraveled.pdf
And finally, if you want to generate epub or mobi, you should install calibre
and docbook-xsl
using the package manager of you distribution. Once you have
this installed, execute the following commands:
epub
mobi
In order to build the pdf on OS X, please follow the notes on this issue.
This book is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.