Adds link blogging features, along with some other niceties to any Jekyll site.
Add this gem to your site's Gemfile in the :jekyll_plugins
group:
group :jekyll_plugins do
gem 'octopress-linkblog'
end
Then install the gem with Bundler
$ bundle
$ gem install octopress-linkblog
Then add the gem to your Jekyll configuration.
gems:
- octopress-linkblog
With the gem installed, your site's posts will automatically have new data attributes.
post.title
- The post title, properly capitalized with titlecase.post.title_html
- The post title, unorphaned and with html wrapping any post markers.post.title_text
- The post title with markers, but all in plain text (great for RSS).post.title_url
- The URL that post titles should link to.post.title_link
- A<a>
tag filled with thetitle_html
pointing to thetitle_url
.post.permalink
- A<a>
tag containing your configuration'spearmalink_label
pointing to the post's URL.post.linkpost
- A boolean indicating whether the post is a link post.
Here is an example. Given the following YAML front-matter:
---
title: cats are awesome
external_url: http://cats.example.com
---
The post would have these attributes:
title => Cats Are Awesome
title_html => Cats Are Awesome <span class='post-marker post-marker-after'>→</span>
title_text => Cats Are Awesome →
title_url => http://cats.example.com
title_link => <a href='http://cats.example.com' class='article-link linkpost'>...</a>
permalink => <a href='http://your-site.com/posts/1' class='permalink'>Permalink</a>
linkpost => true
Note: the <a>
in this demo has been shortened, but it will contain the title_html
.
In addition, the site payload will have two new post arrays:
site.articles
- Will contain standard posts only.site.linkposts
- Will contain only posts with anexternal_url
This may have many uses, but one in particular is the option to allow RSS feeds for each type of post.
You can configure this plugin in your site's _config.yml
under the linkblog
key. Here are the defaults.
linkblog:
linkpost:
marker: →
marker_position: after
posts:
marker: false
marker_position: before
titlecase: true
unorphan: true
permalink_label: Permalink
- Fork it ( https://github.com/octopress/linkblog/fork )
- 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 a new Pull Request