DigitalGov Search

How to add a new post

1. Clone the source branch.
2. Create a new file in the drafts directory using the following naming convention: YYYY-MM-DD-post-filename-title.md
3. Add the YAML block to the top of the file. You can use the following sample file as a starting point.
4. Add the content of your new post below the YAML block. Feel free to use HTML, Markdown or Liquid Extension.
5. Add, commit and push your new post back to the repository.
6. After roughly 3 minutes, visit http://usasearch.howto.gov/drafts/post-filename-title.html to preview your post. If you added a permalink config in your post, visit http://usasearch.howto.gov/drafts/your-permalink.html
7. When you are ready to publish your post, move the file from from drafts to the _posts directory.

Setup development environment

Ruby

You will need Ruby 1.9.3.

Gems

We use bundler to manage gems. You can install bundler and other required gems like this:

$ gem install bundler
$ bundle install

Running it

Start a server and try it out:

$ bundle exec compass watch
$ bundle exec jekyll

http://127.0.0.1:4000

For more information about Jekyll, visit the wiki pages.