From d0bb1c5c47e6077808e83c06312adf63a732a74e Mon Sep 17 00:00:00 2001 From: Dr Nic Williams Date: Tue, 2 Sep 2014 09:20:37 -0700 Subject: [PATCH] website - how to build & deploy site --- website/README.md | 38 +++++++++++++++++++++++++------------- 1 file changed, 25 insertions(+), 13 deletions(-) diff --git a/website/README.md b/website/README.md index acb0b462cd..077949dae5 100644 --- a/website/README.md +++ b/website/README.md @@ -1,24 +1,36 @@ -# Consul Website +Consul Website +============== -This subdirectory contains the entire source for the [Consul Website](http://www.consul.io). -This is a [Middleman](http://middlemanapp.com) project, which builds a static -site from these source files. +This subdirectory contains the entire source for the [Consul Website](http://www.consul.io). This is a [Middleman](http://middlemanapp.com) project, which builds a static site from these source files. -## Contributions Welcome! +Contributions Welcome! +---------------------- -If you find a typo or you feel like you can improve the HTML, CSS, or -JavaScript, we welcome contributions. Feel free to open issues or pull -requests like any normal GitHub project, and we'll merge it in. +If you find a typo or you feel like you can improve the HTML, CSS, or JavaScript, we welcome contributions. Feel free to open issues or pull requests like any normal GitHub project, and we'll merge it in. -## Running the Site Locally +Running the Site Locally +------------------------ -Running the site locally is simple. Clone this repo and run the following -commands: +Running the site locally is simple. Clone this repo and run the following commands: ``` $ bundle $ bundle exec middleman server ``` -Then open up `localhost:4567`. Note that some URLs you may need to append -".html" to make them work (in the navigation and such). +Then open up `localhost:4567`. Note that some URLs you may need to append ".html" to make them work (in the navigation and such). + +Building Site +------------- + +Building the static version of the site and running it is simple. Clone this repo and run the following commands: + +``` +$ bundle +$ bundle exec middleman build +$ foreman start +``` + +Then open up `localhost:5000`. + +Alternately, the site can now be deployed to Heroku or Cloud Foundry.