We use Middleman to generate the website content. This requires Ruby.
Install bundler if you don't already have it:
gem install bundler
Install gems required by website (includes middleman):
bundle install
Middleman includes a server that can be run locally. When making changes to the website it is usually good practice to run the server to see what the changes look like in a browser.
bundle exec middleman
Now visit http://localhost:4567/ to see the website in action.
The static content can be built with:
bundle exec middleman build
This will produces the content in the /build
directory.
The static website content is located in another repo:
svn co https://svn.apache.org/repos/asf/incubator/datafu apache-datafu-website
In the apache-datafu-website
folder, delete the old content, which we will be replacing with new content:
cd apache-datafu-website rm -rf site
Now copy the built content to the apache-datafu-website
folder, replacing the old site
folder:
cp -r ~/Projects/incubator-datafu/site/build site
Check what has changed:
svn status
If you have added or removed files, you may need to run svn add
or svn rm
.
Once you are satisfied with the changes you can commit.