Skip to content
flapjack.io content
JavaScript CSS HTML Ruby Shell
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
_plugins
bin
lib
source
.gitignore
.ruby-version
.travis.yml
CHANGELOG.md
CONTRIBUTING.md
Dockerfile
Gemfile
Gemfile.lock
LICENSE
README.md
Rakefile
config.rb
find_broken_doclinks.rb

README.md

This is the entire site and documentation for flapjack.io and packages.flapjack.io

flapjack.io

Update the exported swagger documentation

Retrieve the exported swagger documentation from a running instance of Flapjack v2+'s JSONAPI, e.g.:

wget http://localhost:3081/doc -O flapjack_swagger.json

You should probably install swagger-tools and use that to validate the exported file. (You may also need to use a prettifier like json_pp if the file fails validation, as it's not output in a particularly readable format.)

swagger-tools validate flapjack_swagger.json

Move/copy the generated file to lib/swagger/api.json in this repo and build/publish as normal.

mv flapjack_swagger.json lib/swagger/api.json

Building

From your checkout of the Flapjack.io repository:

bundle exec middleman build
bundle exec middleman server

Middleman will monitor all files in source/ and trigger a build on change.

View your changes at http://localhost:4567/.

Publishing

When you want to push updated documentation to flapjack.io, run:

# stop the middleman server if it's running and then:

git commit
git push
rm -rf build && bundle exec rake publish

This will build the content from source/ and copy the files to the gh-pages branch on GitHub.

Default version

The default version of the documentation is specified in the config.rb in the top-level directory.

To update all the links, update the following variables:

set :default_version, 1.0
set :layout, "1.0"

packages.flapjack.io

Refer the README under source/packages.flapjack.io

You can’t perform that action at this time.