Skip to content
Utah JavaScript User Group Website
JavaScript Ruby
Find file
Pull request Compare This branch is 57 commits behind UtahJS:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

This is the repository for the website. All are welcome to contribute.

How to Contribute

Visit #utahjs on freenode for help any time. I'm there most of the day.

Contributing is easy. The website is built on nanoc, a static site compiler. Contributing is as easy as adding a member profile yaml file, and then writing an article in markdown.

  1. Fork the repository, check out a new branch off of master.

  2. Add your member profile to content/members. It should look something like this:

    name: Ryan Florence
    location: West Jordan, UT
    github: rpflorence
    twitter: ryanflorence
    about: Yadda yadda yadda

    This information will display on your articles and on the members page. The name of your yaml file is a unique identifier for articles you write. More on that in a minute.

  3. Write an article in markdown, html, or haml in the content/articles directory. The name of the file becomes the url of the article. At the top of the article is some configuration.

    title: Sample article title
    author: Ryan Florence
    date: 2011-08-17
    Then write your article here.

    Your article extension needs to match the filter you want: -> filtered with markdown
    article-name.haml -> filtered with haml
    article-name.html -> not filtered
  4. Push to your repository and send a pull request.

You can look at articles/example to see how to use some of the helpers.

Viewing Locally

If you want to view the site locally it's a bit more involved. You'll need ruby installed on your machine. If you're on Mac OS X, you've already got it.


  1. Post to and ask for Push / Pull access
  2. Fork the repository

    cd ${UTAHJS_HOME}
    git clone
  3. Install rvm, ruby, and bundler (Ubuntu / OS X)

    cd ${UTAHJS_HOME}/
    bash < <(curl -s )
    rvm install ruby-1.9.2
    echo 'gem: --no-rdoc --no-ri' >> ~/.gemrc
    rvm use 1.9.2@utahjs --create
    # that's just a shortcut for:
    #   rvm use ruby-1.9.2
    #   rvm gemset create utahjs
    #   rvm gemset use utahjs
    rvm gemset list
    gem install bundler
  4. Now, with bundler, install the gem dependencies

    bundle install

    All of the required ruby gems, including nanoc, should be installed locally for this project now.


Nanoc ships with several commands, but since the site uses bundler you need to prepend all commands with bundle exec. For example, nanoc has a static file web server:

nanoc view
# with bundler
bundle exec nanoc view

To compile the site:

bundle exec nanoc compile

Autocompile compiles the site on each visit, so you don't have to compile after each change you make:

bundle exec nanoc autocompile

Check out the nanoc website to learn more about the platform is built on.

Something went wrong with that request. Please try again.