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!
To test your changes locally use
# rake
to generate your site in the _site directory, or
# rake server
To start Jekyll server locally.
- 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.
Generate API docs in Foreman
- cd to foreman directory
- rake apipie:cache
Prepare folder for the new version (X.Y)
- cd to theforeman.org/api directory
- cp -r new_version_template X.Y
- edit file X.Y/index.md and set correct version
Copy docs to repo
- cp -r dir/to/foreman/public/apipie-cache/apidoc/* Y.Y/apidoc