Check out this this git repository by running: git clone [email protected]:ManageIQ/manageiq.org.git

When the git clone is done, run cd manageiq.org to change to the checked out directory.

Make sure you have sudo rights on your computer running Fedora, RHEL, or CentOS.

Once you do, simply run ./setup.sh.

1. Type ./run-server.sh

2. Next, browse to http://0.0.0.0:4567

3. Edit!

   When you edit files (pages, layouts, CSS, etc.), the site will dyanmically update in development mode. (There's no need to refresh the page, unless you get a Ruby error.)

Since it's already set up at this point, all you need to do is repeat change to the correct directory and run step 3 every time you want to start the server.

The site can be easily customized by editing data/site.yml.

To add a post to the community blog (or any blog managed by middleman) use:

bundle middleman article TITLE

After getting it how you want, you can build the static site by running:

bundle exec middleman build

(If you have middleman in your path, you can just run middleman build.)

FIXME: Right now, please reference <data/site.yml>

After copying your public key to the remote server and configuring your site in <data/site.yml>, deployment is one simple command:

bundle exec middleman deploy

Simply add a new gem 'some-gem-here' line in the Gemfile and run bundle install

For more information, please check the excellent Middleman documentation.