version 3.0 of the theme -- complete overhaul

This commit is contained in:
Tom Johnson
2015-08-11 16:48:17 -07:00
parent 95fa839f0c
commit 6cab011d1b
181 changed files with 4747 additions and 10289 deletions

33
doc_collections.md Normal file
View File

@ -0,0 +1,33 @@
---
title: Collections
tags: []
keywords:
audience:
last_updated:
summary:
---
{% include linkrefs.html %}
## What are collections
Collections are custom content types different from pages and posts. You might create a collection if you want to treat a specific set of articles in a unique way, such as with a custom layout or listing. For more detail on collections, see [Ben Balter's explanation of collections here](http://ben.balter.com/2015/02/20/jekyll-collections/).
## Create a collection
To create a collection, add the following in your configuration file:
```
collections:
tooltips:
output: true
```
In this example, tooltips is the name of the collection.
## Interacting with collections
You can interact with collections by using the `site.collection_namespace` path, where `collection_namespace` is what you've configured. In this case, if I wanted to loop through all tooltips, I would use `site.tooltips` instead of `site.pages` or `site.posts`.
See [Collections in the Jekyll documentation](http://jekyllrb.com/docs/collections/) for more information.
## How to use collections
I haven't found a huge use for collections in normal documentation. However, I did find a use for collections in generating a tooltip file that would be used for delivering tooltips to a user interface from text files in the documentation.