Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
openFrameworks community book
C++ C Objective-C Python CSS TeX Other
branch: master

Merge pull request #120 from tpltnt/debian-readme

adding setup instructions for Debian
latest commit fb26463a13
@mikewesthad mikewesthad authored

README.md

ofBook

this is a collaboratively written openFrameworks book.

please note that this is still work-in-progress

Building the Book

Dependencies

Scripts for building the web and pdf versions of the book are in scripts/ directory: createWebBook.py and createPDFBook.py. You must run them from the scripts/ directory, so either double-click the script or run it from command line.

  • When building the web book, the website is stored in the output/webBook directory. Opening up output/webBook/toc.html will open up the table of contents.
  • When building the pdf book, the pdf is created at output/ofBook.pdf. output/ofBook.tex is also created, for debugging purposes.

OSX

  1. install pip at the terminal sudo easy_install pip
  2. install beauitful soup 4 (bs4) pip install beautifulsoup4
  3. install pandoc
  4. install basictex & MacTeX-Additions
  5. install libsass sudo pip install libsass

Windows Installation of Dependencies

  1. Download and install Python 2.7+
  2. Download and install beauitful soup 4 (bs4)
    • Method 1:
      1. Get the python package manager, pip. This involves downloading get-pip.py and running it from command line.
      2. Run pip install beautifulsoup4 from the command line to install BeautifulSoup
    • Alternate installation methods for bs4
  3. Download and install pandoc using the latest windows installer (.msi) from here
  4. Download and install MiKTeX using the windows installer from here
    • When installing, check the box for "Install Packages on the Fly." The pandoc -> PDF pipeline uses latex packages that don't all come standard with MiKTeX, so this will allow you to grab any missing packages when building the book for the first time.
  5. Download and install libsass
    • Using pip: pip install libsass

Debian (Linux)

  1. install packages: sudo apt-get install python-pip python2.7-dev git pandoc ruby-sass texlive
  2. install beauitful soup 4 and libsass: pip install beauitfulsoup4 libsass

Mailing List

openFrameworks Book discussion.

Older Book discussions can be checked at Ofbook Archives

Something went wrong with that request. Please try again.