a Jekyll Plugin that generates a JSON file with data for all the Pages in your Site
Ruby CSS HTML
Latest commit b6de4f6 Aug 28, 2016 @afeld afeld committed on GitHub Merge pull request #38 from mike-burns/metadata
Add frontmatter to the JSON result
Permalink
Failed to load latest commit information.
bin
gemfiles Support more jekyll versions May 19, 2016
lib Add frontmatter to the JSON result Aug 28, 2016
spec
.gitignore Ignore Vim swap files May 25, 2015
.rspec add rspec Jan 25, 2015
.travis.yml Support more jekyll versions May 19, 2016
Appraisals Support more jekyll versions May 19, 2016
CONTRIBUTING.md add instructions for running tests against jekyll 3 Mar 6, 2015
Gemfile Support more jekyll versions May 19, 2016
LICENSE.md switch to CC0 license Jan 25, 2015
README.md Document the new meta key Aug 28, 2016
Rakefile Support more jekyll versions May 19, 2016
jekyll_pages_api.gemspec run tests against jekyll 2 and 3 Mar 6, 2015

README.md

Jekyll Pages API Build Status Code Climate

Join the chat at https://gitter.im/18F/jekyll_pages_api

Jekyll Pages API is a Jekyll Plugin gem that generates a JSON file with data for all the Pages, Posts, Documents (i.e. "collections") and StaticFiles in your Site. Jekyll, if you're not familiar, is a static website generator written in Ruby.

Usage

Add this line to your application's Gemfile:

group :jekyll_plugins do
  gem 'jekyll_pages_api'
end

If you're creating a new Gemfile in your Jekyll project, make sure to include a source at the top:

source 'https://rubygems.org'

And then execute:

bundle
bundle exec jekyll serve

You can then see the generated JSON file at http://localhost:4000/api/v1/pages.json, which will look like this:

{
  "entries": [
    {
      "title": "18F Hub",
      // the page path
      "url": "/",
      // the content of the page, with the HTML tags stripped and the whitespace condensed
      "body": "18F is a digital services team within GSA...",
      "meta": {
        // all the frontmatter for the page
        "title": "18F Hub",
        "url": "/",
        "layout": "page",
        "permalink": "/",
      }
    },
    // ...
  ]
}

This endpoint will be re-generated any time your site is rebuilt.

Skipping the index

The Jekyll Pages API Search plugin uses this plugin to build a search index. Add skip_index: true to the front matter of any documents you wish to exclude from this index.

Running standalone

If you wish to generate a pages.json file when using a site generation tool other than Jekyll, you can run the jekyll_pages_api executable as a post-generation step. Run jekyll_pages_api -h for instructions.

Developing

Important Note: This gem uses the Appraisal Gem to ensure that it's tests pass against all supported versions of Jekyll. It uses the appraisal command - you can read more in the documentation.

  • Run bundle to install any necessary gems.
  • Run bundle exec rake -T to get a list of build commands and descriptions.
  • Run bundle exec rake spec to run the tests.
  • Run appraisal install to install the correct Jekyll dependencies.
  • Run appraisal rake spec to run all of the appraisals.
  • Run bundle exec rake build to ensure the entire gem can build.
  • Commit an update to bump the version number of lib/jekyll_pages_api/version.rb before running bundle exec rake release.

While developing this gem, add this to the Gemfile of any project using the gem to try out your changes (presuming the project's working directory is a sibling of the gem's working directory):

group :jekyll_plugins do
  gem 'jekyll_pages_api', :path => '../jekyll_pages_api'
end

See also

Additional means of turning your site content into data: