Home

Awesome

Open Reader API

This is the repo for the Open Reader API and is built with nanoc.

All submissions are encouraged. To submit a change, fork this repository, commit your changes and send a pull request.

Making Contributions

Making contributions or changes is easy. Clone this repo, alter the content within the content folder and submit a pull request.

All content is created in plain text using the Markdown syntax. The folder structure will define the end url path structure so keep that in mind if new files and folders are added.

The final display on http://rss-sync.github.io/Open-Reader-API is updated as needed manually using nanoc.

Style Guide

Markdown file extensions should be .md

A single file should adhere to the following format:

---
title: API Title
---

# API Title

* TOC
{:toc}

## End point

    [VERB] /path

### Parameters

Parameter 1:
: - `option 1`: Option 1's definition
  - `option 2`: Option 2's definition

Parameter 2
: `option 1`, `option 2`, default: `option 3`

### Response

    Example response

Testing Your Changes

Note: Simply changing the Markdown files within /content is enough to make contributions or changes to this repo. The following is only for testing.

If you want to test out your changes to ensure the final generation is correct, you can install the nanoc gem and kramdown gem which is used for Markdown formatting.

view available nanoc commands with:

nanoc -h

Nanoc compiles the site into static files within the output folder. Run the compile with:

nanoc compile

You can use MAMP or a similar setup to view the resulting files or you can install the adsf gem which will work with nanoc. Then you can use:

nanoc view
open http://localhost:3000

Updating the live site

The live site lives in the gh-pages branch. For convenience the gh-pages branch has been added to the main repo as a Git submodule.

To update the live site, update master locally and run nanoc compile. The latest generated output will be in /output/Open-Reader-API/.

Move into /gh-pages folder, clear it's content with git rm -r * and copy the output from the parent folder (cp -r ../output/Open-Reader-API/ .). Add all files and commit the changes.

Pushing the gh-branch will update the live site. After a successful push, don't forget to update the master branch so that it's pointer to the submodule will have the proper commit hash stored.