search.gov

How to add a new post

1. Clone the master 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 https://search.digitalgov.gov/drafts/post-filename-title.html to preview your post. If you added a permalink config in your post, visit https://search.digitalgov.gov/drafts/your-permalink.html
7. When you're ready to publish your post, move the file from from drafts to the _posts directory.

How to set up your development environment

Open a Terminal window. Start homebrew.

$ brew update
$ brew doctor

We use bundler to manage gems. cd into the local repo. Install bundler and other required gems.

$ gem install bundler
$ bundle install

Start a server and try it out. From the root directory, run:

$ bundle exec compass watch (ctrl+c to stop)
$ bundle exec jekyll serve

Go to http://localhost:4000. The site should have the expected content & formatting of the Search.gov homepage.

---

• For more information about Jekyll, visit the wiki pages.

• If you don't already have it, you'll need the Ruby version specified in .ruby-version. RVM is recommended to install Ruby on your development environment. Verify that your path points to the correct version of Ruby:

  $ ruby -v ruby 2.5.5p157 (2019-03-15 revision 67260) [x86_64-darwin18]