Hologram Github Theme

This is a very simple Github Styleguide inspired theme for Trulia's Hologram, the ruby front-end doc generator.

Preview

!Example

Visit example styleguide

Usage

Install Hologram:

``$ gem install hologram`

Add this theme to your project using NPM:

`$ npm install --save-dev hologram-github-theme`

Alternatively you may use Bower:

`$ bower install --save-dev hologram-github-theme`

Define the theme in your hologram_config.yml:

`Relative path(s) to your source files`


source: app/styles
Relative path where you want the documentation to be built

destination: styleguide
The path that contains supporting assets for the documentation page

documentation_assets: node_modules/hologram-github-theme
Category that will be used as the index.html (optional)

index: styleguide
A list of relative paths to folders containing any dependencies to copy

dependencies:
  - 'dist'
The CSS files to be included in the styleguide

css_include:
  - 'dist/styles/vendor.css'
  - 'dist/styles/main.css'
The JavaScript files to included in the styleguide

js_include:
  - 'dist/scripts/main.js'
The global title that is displayed at the top of the pages

global_title: Styleguide

In this example the markdown file app/styles/styleguide.md is used for the content on the index page. Also, if you're using Bower, adjust the package path accordingly: `documentation_assets: bower_components/hologram-github-theme`.

For more details on the options, checkout the Hologram documentation

Finally, build the styleguide:

`hologram -c hologram_config.yml``

Authors

The Hologram Github Theme has been created by Mathis Hofer. Many thanks to Maurice Kühlborn and Oscar for their contributions.

License

The Hologram Github Theme is licensed under the MIT License