This plugin makes it easy to create a list of sites (organized into sections) for your Octopress sidebar. It's nothing you couldn't do with a bit of HTML or Markdown, but this handles sorting (either manually or automatically), and makes entering the sites much quicker.
sidebar.rbfile in the
_pluginsdirectory of your Octopress site.
source/custom/asidesdirectory of your Octopress blog.
sidebar.htmlinto your sidebar configuration through
_sidebarfolder somewhere in your
sourcedirectory and place all the site YAML files in there and enjoy an easy-to-use list of links.
Each file in the _sidebar directory must be a YAML file, named conforming to the scheme
1.my_section_name.yml. The number before the period will be used to order the section, and the rest of the filename (minus the ".yml") will be titlecased to become the section's label.
The files use the following syntax:
--- name: Google url: http://google.com --- name: Yahoo! url: http://www.yahoo.com order: 1 --- name: DuckDuckGo url: http://duckduckgo.com
Each site (separated by "---") needs a name and a URL. Sites will be ordered alphabetically by name unless given an "order" attribute, in which case that number will be used. Sites without an "order" attribute are assumed to have an ordering of 9999.
If you're linking to a group of people, you can use this syntax instead:
--- fname: Linus lname: Torvalds url: https://plus.google.com/+LinusTorvalds --- fname: Bill lname: Gates url: http://www.thegatesnotes.com/ --- fname: Steve lname: Jobs url: http://www.apple.com/stevejobs/
If a record has an "fname" attribute, it will be appended to the front for display purposes, but the last name will be used for sorting. An "order" attribute will override last name sorting.
Licencing, bug reports, patches, etc
This plugin is licenced under the terms of the GNU GPL version 3. If it works for you, great to know I've been of some help. If it doesn't, please feel free to enter an issue on this repo.