theforeman.org
This repo contains the source code for theforeman.org. All of the site's content is written in Markdown. If you're not familiar with it, fear not; it's easy to learn and to become rapidly productive!
Everything you push into the gh-pages branch goes live immediately!
Testing locally
To test your changes locally use
# rake
to generate your site in the _site directory, or
# rake server
To start Jekyll server locally.
Contributing
- Fork this repo to your account.
- Clone the fork.
- Run
bundle install
in the root of the freshly cloned repo. This will install Jekyll, the tool we use to build the site. - Run
jekyll serve --watch
and open your browser to http://localhost:4000. - Make some changes, refresh your browser to preview them.
- Submit a pull request.
Updating API Auto-Generated Docs by apipie
Generate API docs in Foreman
- cd to foreman directory
- rake apipie:cache
Copy docs to repo
- cd to theforeman.org directory
- cp -r dir/to/foreman/public/apipie-cache/apidoc api/
- cp dir/to/foreman/public/apipie-cache/apidoc.* api/