jekyll-seo-tag 1.3.3 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 59faf9298ad2055092eb2b9b771ec052e09d9a85
-  data.tar.gz: 3b9bcf03366b9a98ff88b8e4a483cbf5dc35e80f
+  metadata.gz: d212e590808ac3a0f94a2ddaaad78926fa0fbbde
+  data.tar.gz: 75cc4d3aacbdcab6d95db98b1d7f1b69fe5047a2
 SHA512:
-  metadata.gz: 181f5bf7435df0c4a08440f2a0cadeffa7196e2f1f5ca35b4bc242629f8156780a0cef88f48db48380cb711d6d8a4d9f4f44d7ee009b9a24234c9c7c5efb4144
-  data.tar.gz: 9b0cea7232186d07aa61497e8fc4d4b0301ce85de89773957b63f814e22589051df5122a46c97bd99089ad6067592e65c48bbdee97075b31919c9a01c2626725
+  metadata.gz: d2a782da804fa7d6bd0e9a7a60783785d7a6b2d2d9a9fe93b1d9f814fda0da16dbc0d86b508d7933ab766eccb9d8d021a85d896f62cb89156e911cc74977369d
+  data.tar.gz: 9a204dcb6acd686174e898e2df5db91e6722067502cc1de4bc9b878c25c74981f46baff1fdaf1fab8d0decdb284707fc036ce34879d6aaa67816d84ca64e6b21

data/README.md

@@ -68,7 +68,7 @@ The SEO tag will respect any of the following if included in your site's `_confi
     publisher: 1234
    ```
 
-* `logo` - Relative URL to a site-wide logo (e.g., `/assets/your-company-logo.png`)
+* `logo` - URL to a site-wide logo (e.g., `/assets/your-company-logo.png`)
 * `social` - For [specifying social profiles](https://developers.google.com/structured-data/customize/social-profiles). The following properties are available:
   * `name` - If the user or organization name differs from the site's name
   * `links` - An array of links to social media profiles.
@@ -78,12 +78,16 @@ The SEO tag will respect the following YAML front matter if included in a post,
 
 * `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`)
+* `image` - URL to an image associated with the post, page, or document (e.g., `/assets/page-pic.jpg`)
 * `author` - Page-, post-, or document-specific author information (see below)
 
+## Advanced usage
+
+Jekyll SEO Tag is designed to implement SEO best practices by default and to be the right fit for most sites right out of the box. If for some reason, you need more control over the output, read on:
+
 ### Disabling `<title>` output
 
-Jekyll SEO Tag is designed to implement SEO best practices by default. If for some reason, you don't want the plugin to output `<title>` tags on each page, simply invoke the plugin within your template like so:
+If for some reason, you don't want the plugin to output `<title>` tags on each page, simply invoke the plugin within your template like so:
 
 ```
 {% seo title=false %}
@@ -153,3 +157,23 @@ The following options can be set for any particular page. While the default opti
   * `name` - If the name of the thing that the page represents is different from the page title. (i.e.: "Frank's Café" vs "Welcome to Frank's Café")
   * `type` - The type of things that the page represents. This must be a [Schema.org type](http://schema.org/docs/schemas.html), and will probably usually be something like [`BlogPosting`](http://schema.org/BlogPosting), [`NewsArticle`](http://schema.org/NewsArticle), [`Person`](http://schema.org/Person), [`Organization`](http://schema.org/Organization), etc.
   * `links` - An array of other URLs that represent the same thing that this page represents. For instance, Jane's bio page might include links to Jane's GitHub and Twitter profiles.
+
+### Customizing image output
+
+For most users, setting `image: [path-to-image]` on a per-page basis should be enough. If you need more control over how images are represented, the `image` property can also be an object, with the following options:
+
+* `path` - The relative path to the image. Same as `image: [path-to-image]`
+* `twitter` - The relative path to a Twitter-specific image.
+* `facebook` - The relative path to a Facebook-specific image.
+* `height` - The height of the Facebook (`og:image`) image
+* `width` - The width of the Facebook (`og:image`) image
+
+You can use any of the above, optional properties, like so:
+
+```yml
+image:
+  twitter: /img/twitter.png
+  facebook: /img/facebook.png
+  height: 100
+  width: 100
+```

data/lib/jekyll-seo-tag/version.rb

@@ -3,6 +3,6 @@ module Liquid; class Tag; end; end
 
 module Jekyll
   class SeoTag < Liquid::Tag
-    VERSION = '1.3.3'.freeze
+    VERSION = '1.4.0'.freeze
   end
 end

data/lib/template.html

@@ -85,11 +85,19 @@
 {% endif %}
 
 {% if site.logo %}
-    {% assign seo_site_logo = site.logo | prepend: seo_url | escape %}
+  {% assign seo_site_logo = site.logo %}
+  {% unless seo_site_logo contains "://" %}
+    {% assign seo_site_logo = seo_site_logo | prepend: seo_url %}
+  {% endunless %}
+  {% assign seo_site_logo = seo_site_logo | escape %}
 {% endif %}
 
 {% if page.image %}
-    {% assign seo_page_image = page.image | prepend: seo_url | escape %}
+  {% assign seo_page_image = page.image.path | default: page.image.facebook | default: page.image %}
+  {% unless seo_page_image contains "://" %}
+    {% assign seo_page_image = seo_page_image | prepend: seo_url %}
+  {% endunless %}
+  {% assign seo_page_image = seo_page_image | escape %}
 {% endif %}
 
 {% if seo_tag.title and seo_title %}
@@ -115,7 +123,17 @@
 {% endif %}
 
 {% if seo_page_image %}
-  <meta property="og:image" content="{{ seo_page_image }}" />
+<meta property="og:image" content="{{ seo_page_image }}" />
+  {% if page.image.height %}
+    <meta property="og:image:height" content="{{ page.image.height }}" />
+  {% endif %}
+  {% if page.image.width %}
+    <meta property="og:image:width" content="{{ page.image.width }}" />
+  {% endif %}
+{% endif %}
+
+{% if page.image.twitter %}
+  <meta name="twitter:image" content="{{ page.image.twitter | prepend: seo_url | escape }}" />
 {% endif %}
 
 {% if page.date %}
@@ -132,7 +150,7 @@
 {% endif %}
 
 {% if site.twitter %}
-  {% if seo_page_image %}
+  {% if seo_page_image or page.image.twitter %}
     <meta name="twitter:card" content="summary_large_image" />
   {% else %}
     <meta name="twitter:card" content="summary" />

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-seo-tag
 version: !ruby/object:Gem::Version
-  version: 1.3.3
+  version: 1.4.0
 platform: ruby
 authors:
 - Ben Balter
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-03-25 00:00:00.000000000 Z
+date: 2016-04-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll