search

Yago / Cortana

Nice theme for Trulia's Hologram styleguide generator
http://yago.github.io/Cortana-example
MIT License
71 stars 24 forks source link

readme

!Developement stopped, to benefit of Toolbox generator! Feel free to fork and keep maintaining :wink:

Cortana : a sexy Hologram theme

Cortana is a nice theme for Trulia's Hologram, the ruby front-end doc generator, and inspired by PebbleRoad's Tapestry.

Check the Demo

Usage

To install the last version of Hologram (required) :

$ gem install hologram

To install Cortana, use Bower :

$ bower install --save-dev Cortana

Your hologram_config.yml should look like :

# Directory to parse
source: ./your-code

# Directory to build the styleguide
destination: ./styleguide

# Hologram theme
documentation_assets: ./bower_components/Cortana
custom_markdown: ./bower_components/Cortana/CortanaMarkdownRenderer.rb

# To have a custom index page build with your README.md
index: README

# List all css to include for the styleguide render examples (path from styleguide directory)
css_include:
  - '../assets/css/vendors.css'
  - '../assets/css/styles.css'

# List all js to include for the styleguide render examples (path from styleguide directory)
js_include:
  - 'http://code.jquery.com/jquery-1.10.2.min.js'
  - '../assets/js/main.js'

# String who is used to split the category name and create category wrapper
name_scope: ' - '

We recomand to place a README.md in the root of your source directory to build a custom styleguide index page.

To have add a custom category wrapper like in the example, just add it before your category name with space-space and before all the other categories in the same wrapper. This name_scope can be change in the hologram_config.yml. You will have something like this :

/*doc
---
title: My Title
name: myname
category: General - Button
---

Some Markdown comment and markup...

*/

Edition

To edit Cortana you will need Bower, npm and NodeJS

To setup the project :

$ npm install
$ bower install
$ gulp

@TODO

Dependencies