RDO Project Website
HTML CSS Ruby JavaScript Python CoffeeScript Other
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
data purge obsolete dashboard data Jul 5, 2018
lib removed wiki monkeypatches Nov 22, 2016
scripts
source Replace RDO infra core list with link to Gerrit group Aug 14, 2018
.gitignore planet: adapt directories to deployment Apr 3, 2018
.gitmodules first pass at rh-events integration Sep 24, 2015
.travis.yml Workaround travis breakage Sep 20, 2017
Dockerfile added Dockerfile and script in case someone finds it useful for build… Jun 23, 2016
Gemfile
LICENSE.md created LICENSE.md file Jul 3, 2014
README.md Clarify website instructions readme Jun 20, 2017
config.rb
create-post.rb fixed create-post.rb default help info (#582) May 24, 2016
docker.sh added Dockerfile and script in case someone finds it useful for build… Jun 23, 2016
planet.ini removed Diane Mueller's blog due to no RDO content May 7, 2018
run-server.sh warn if setup was not done Jan 11, 2018
setup.sh red hat summit Jun 7, 2016

README.md

RDO website

To get started, just fork a copy of this repository, make your changes and create a pull request.

  1. Forking a github repository
  2. Making changes
  3. Pull Requests

Run your own copy

PLEASE NOTE: There is no requirement to run your own copy, the following is just a reference for those who may wish to do so.

To get started, you need to have Ruby and Ruby Gems installed, as well as "bundler".

Initial setup

Clone this repository and run the setup.sh script located in the checked out repository directory.

The script will initialize and update the git submodules, install system dependencies, and run a bundle install.

It is expected that you are on a YUM based system with sudo access.

cd website
./setup.sh

Running a local server

  1. Start a local Middleman server:

    ./run-server.sh

    This will update your locally installed gems and start a Middleman development server.

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

  3. Edit!

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

Customizing your site

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

Adding a Post

To add a post to the community blog use:

./create-post.rb "TITLE"

Build your static site

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

NOTE: On CentOS / RHEL 7 you will be presented with a warning that ImageMagick is less than the recommended 6.8.0.

bundle exec middleman build

Deploying

Setting up deployment

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

Actual deployment

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

Add new features (parsers, etc.)

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

More info

For more information, please check the excellent Middleman documentation.