Skip to content

Latest commit

 

History

History
80 lines (54 loc) · 2.33 KB

README.md

File metadata and controls

80 lines (54 loc) · 2.33 KB
Raw

Ember Website

The website for the Ember.js project.

Contributing

To get started:

git clone git://github.com/emberjs/website.git
cd website
bundle
bundle exec middleman

Then visit http://localhost:4567/

Note: unless you're working with the API docs, don't use rake preview—use middleman (aka middleman server) instead.

To populate organizers data from meetup.com on http://localhost:4567/meetups

  • get a meetup API Key
  • set ENV["MEETUP_API_KEY"]
  • run the following rake command
rake findorganizers [force=true]

The force=true flag will overwrite all existing organizer data

API Documentation

You can preview the API documentation by generating the docs from the source code. To begin, ensure that you have the necessary dependencies:

  • Node
  • npm
  • Ruby
  • bundler

Next, clone the three repositories: ember.js, data, and this repository, website. The repositories need to be placed in the same directory:

emberjs/
    website/
    ember.js/
    ember-data/

Note that the name of the data project needs to be ember-data, not data.

Next, navigate into the root directory of this repository and execute bundle exec rake generate_docs. This will build the documentation for the ember.js and data repositories.

You can launch the website via bundle exec middleman to preview the generated docs.

Requirements

If the bundle command fails to run, you may need to upgrade your Ruby version. The Ember.js website build requires 1.9.3 or newer (2.0.0 recommended). You can use RVM to install it:

curl -L https://get.rvm.io | bash -s stable
rvm install 2.0.0
rvm use 2.0.0

Troubleshooting tips for Windows devs

For Windows developers using RubyInstaller, you'll need to download the DevKit and install it using instructions: https://github.com/oneclick/rubyinstaller/wiki/Development-Kit

After you have a proper install, you can then run:

gem install bundler wdm tzinfo-data
gem update listen middleman

Once Middleman comes up, you'll be prompted by Windows Firewall. Click "Allow access" and you'll be in business!