A softcover version of the online elixir getting started guides
Switch branches/tags
Nothing to show
Clone or download
Latest commit 2a2b648 Mar 31, 2014
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
chapters initial Mar 29, 2014
config initial Mar 29, 2014
ebooks updated ebooks Mar 31, 2014
html initial Mar 29, 2014
images initial Mar 29, 2014
latex_styles initial Mar 29, 2014
.gitignore added ebooks to deploy pdf files Mar 29, 2014
.softcover-build initial Mar 29, 2014
.softcover-deploy initial Mar 29, 2014
Book.txt initial Mar 29, 2014
README.md updated readme Mar 31, 2014
download-source.sh initial Mar 29, 2014
elixir-book.tex initial Mar 29, 2014
process.rb initial Mar 29, 2014

README.md

Usage

This 'project' pulls the Elixir book down from github and formats it for softcover. It also includes the Ex_unit and the Mix documentation at the end.

The best way to use this project is to not use it, but just download the ebooks. Links are provided below for the published books in the ebooks/ directory.

Installation

If you want to support this project and build the books yourself, first install softcover:

gem install softcover

and follow the instructions to complete the softcover install. (Softcover requires extensive supporting installs. (Be aware that install time can take a while if you don't have the supporting tools installed.)

Then, clone this repository and run the commands below:

git clone git@github.com:jfreeze/elixir-book.git
cd elixir-book
./download-source.sh
./process.rb
sc build

Caveats

This intent of this project was to get reasonably clean PDF and mobile versions of the online Elixir Getting Started documents. For the most part, it does just that, but note there are some broken external links. However, I don't believe this impedes the delivery of the content.

There are some bugs in the https://github.com/elixir-lang/elixir-lang.github.com markdown files that have not been corrected yet. These problems are fixed with the process.rb script.

TODOS

If you want to help improve this project, below are a few ways to help.

  • Add a Book Cover Page. Graphic in form of .png and .pdf.
  • Add task to process.rb to get all the contributor names and add them to the preface section.
  • Create pull requests to the source project to fix the few existing markdown problems.
  • Fix the relative web links in the markdown to work with softcover.
  • Host the HTML version of this book on the web.