This is the recommended method for new contributors. Although the website is built with Ruby, most work is done in Markdown files. You don't need to know Ruby or install its dependencies to help out. Simply follow the Docker container instructions below to install and run locally.
First, install Docker and Compose and leave it running.
Next, the commands below will install all necessary dependencies for the website app and start a server. This will take a little while to run the first time, possibly a few minutes. The dependencies will be installed inside a Docker container, and do not affect your normal developer environment.
git clone https://github.com/ember-cli/ember-cli.github.io.git
cd ember-cli.github.io
docker-compose upInstall Jekyll and a special gem provided by GitHub:
$ gem install bundler
$ bundleOpen the directory which contains the repo and run Jekyll:
$ bundle exec jekyll serve -wYou can now view the result at http://localhost:4000.
If you want to help with the development of this site and you're using Windows, please read this guide about how to run Jekyll on your OS.
Alternatively, use bash via Windows Subsystem for Linux (WSL):
- Install/setup WSL
- Install ruby, perhaps use rbenv or linuxbrew.sh