Skip to content

Latest commit

 

History

History
44 lines (23 loc) · 1.31 KB

README-tools.md

File metadata and controls

44 lines (23 loc) · 1.31 KB
Raw

Tools Used to Create CDS

CDS reuses the ClojureWerkz docslate toolchain. The clojure-doc.org site is generated using jekyll. To run the site generator yourself, you'll need to first have Ruby installed. Python is also required, as syntax-highlighting of code blocks is handled by pygments.

If installing Ruby from source, a prerequisite is the libyaml dev package.

Install Tools & Dependencies

Install Bundler. Ruby 1.9.3 or JRuby are recommended:

gem install bundler

Then install dependencies (Jekyll, GitHub-flavored Markdown processors, etc) with Bundler by running the following in the CDS repository root:

bundle install --binstubs

As an alternative to bundler, if you like you can manually (via gem install) install all the dependencies listed in path/to/cds/Gemfile, and then later (from the cds directory) run the gem-installed jekyll to view your local version of the site.

Then install Pygments via your OS-specific package installer, or else using pip (assuming you've installed pip):

pip install pygments

How To Run A Development Server

./bin/jekyll --server --auto

The server will be started at localhost:4000.

How To Regenerate The Site

To regenerate the entire site, use

  ./bin/jekyll