A Jekyll plugin to add metadata tags for search engines and social networks to better index and display your site's content. This fork deals with the issue JSON-LD Alt Property Not Recognized.
Go to file
Ben Balter b55443e8bd fix gemfile to use github-pages version 2016-02-09 16:30:01 -05:00
lib Merge pull request #46 from benbalter/facebook-meta 2016-02-09 16:20:46 -05:00
script initial commit 2015-10-25 17:21:46 -04:00
spec Merge pull request #44 from boturnbow/relative_image_tag 2016-02-03 12:31:02 -05:00
.gitignore fix gemspec 2015-10-30 12:18:13 -04:00
.rspec initial commit 2015-10-25 17:21:46 -04:00
.travis.yml initial commit 2015-10-25 17:21:46 -04:00
Gemfile fix gemfile to use github-pages version 2016-02-09 16:30:01 -05:00
LICENSE.txt initial commit 2015-10-25 17:21:46 -04:00
README.md add facebook meta 2016-02-03 12:54:48 -05:00
Rakefile initial commit 2015-10-25 17:21:46 -04:00
jekyll-seo-tag.gemspec move version to its own file for easier bumping 2016-01-07 18:19:53 -05:00

README.md

Jekyll SEO Tag

A Jekyll plugin to add metadata tags for search engines and social networks to better index and display your site's content.

Gem Version Build Status

What it does

Jekyll SEO Tag adds the following meta tags to your site:

While you could theoretically add the necessary metadata tags yourself, Jekyll SEO Tag provides a battle-tested template of crowdsourced best-practices.

What it doesn't do

Jekyll SEO tag is designed to output machine-readable metadata for search engines and social networks to index and display. If you're looking for something to analyze your Jekyll site's structure and content (e.g., more traditional SEO optimization), take a look at The Jekyll SEO Gem.

Jekyll SEO tag isn't designed to accommodate every possible use case. It should work for most site out of the box and without a laundry list of configuration options that serve only to confuse most users.

Installation

  1. Add the following to your site's Gemfile:
gem 'jekyll-seo-tag'
  1. Add the following to your site's _config.yml:
gems:
  - jekyll-seo-tag
  1. Add the following right before </head> in your site's template(s):
  {% seo %}

Usage

The SEO tag will respect any of the following if included in your site's _config.yml (and simply not include them if they're not defined):

  • title - Your site's title (e.g., Ben's awesome site, The GitHub Blog, etc.)
  • description - A short description (e.g., A blog dedicated to reviewing cat gifs)
  • url - The full URL to your site. Note: site.github.url will be used by default.
  • twitter:username - The site's Twitter handle. You'll want to describe it like so:
    twitter:
      username: benbalter
    
  • facebook:app_id (A Facebook app ID for Facebook insights), and/or facebook:publisher (A Facebook page URL or ID of the publishing entity). You'll want to describe one or both like so:
    facebook:
      app_id: 1234
      publisher: 1234
    
  • logo - Relative URL to a site-wide logo (e.g., assets/your-company-logo.png)
  • social - For specifying social profiles. The following properties are available:
    • type - Either person or organization (defaults to person)
    • name - If the user or organization name differs from the site's name
    • links - An array of links to social media profiles.

The SEO tag will respect the following YAML front matter if included in a post, page, or document:

  • title - The title of the post, page, or document
  • description - A short description of the page's content
  • image - Relative URL to an image associated with the post, page, or document (e.g., assets/page-pic.jpg)
  • author - The username of the post, page, or document author