Gollum::DescendantTree
DescendantTree adds a helper function, similar to Gollum's Table of Contents (TOC), which adds an unordered list of links to all descendants of the current page.
Installation
Add this line to your Gollum application's Gemfile:
gem 'gollum-descendant_tree'
And then execute:
$ bundle install
Or install it yourself as:
$ gem install gollum-descendant_tree
Setup
Then, add to your Gollum app's config.ru
:
require 'gollum/descendant_tree'
Create a custom markup class if you don't already have one, or just include Gollum::DescendantTree
in your existing class.
# lib/gollum/my_markup.rb
class MyMarkup < Gollum::Markup
include Gollum::DescendantTree
end
Finally, in config.ru
, tell Gollum to use your class instead of its default one.
Precious::App.set(:wiki_options, {
:markup_classes => { :markdown => MyMarkup }
})
Usage
Simply add [[_TREE_]]
to any page of your wiki to add an unordered list of descendants to the page. If you're using custom css, you can target ul.tree
for styling the list.
Automated Tests
$ bundle exec rspec spec
Contributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request