bunto-seo-tag 5.0.0 → 6.0.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/.gitignore +12 -10
- data/.rspec +2 -2
- data/.rubocop.yml +25 -10
- data/.travis.yml +12 -12
- data/Gemfile +7 -16
- data/LICENSE.txt +21 -21
- data/bunto-seo-tag.gemspec +34 -34
- data/docs/README.md +33 -0
- data/docs/_config.yml +10 -0
- data/docs/_layouts/default.html +18 -0
- data/docs/advanced-usage.md +138 -0
- data/docs/installation.md +20 -0
- data/docs/usage.md +67 -0
- data/lib/bunto-seo-tag.rb +80 -66
- data/lib/bunto-seo-tag/drop.rb +280 -0
- data/lib/bunto-seo-tag/filters.rb +12 -13
- data/lib/bunto-seo-tag/json_ld.rb +79 -0
- data/lib/bunto-seo-tag/version.rb +8 -8
- data/lib/template.html +104 -202
- data/script/bootstrap +5 -5
- data/script/cibuild +7 -7
- data/script/release +38 -38
- data/script/site +3 -0
- metadata +39 -45
- data/README.md +0 -155
- data/Rakefile +0 -6
data/script/release
CHANGED
@@ -1,38 +1,38 @@
|
|
1
|
-
#!/bin/sh
|
2
|
-
# Tag and push a release.
|
3
|
-
|
4
|
-
set -e
|
5
|
-
|
6
|
-
# Make sure we're in the project root.
|
7
|
-
|
8
|
-
cd $(dirname "$0")/..
|
9
|
-
|
10
|
-
# Build a new gem archive.
|
11
|
-
|
12
|
-
rm -rf bunto-seo-tag-*.gem
|
13
|
-
gem build -q bunto-seo-tag.gemspec
|
14
|
-
|
15
|
-
# Make sure we're on the master branch.
|
16
|
-
|
17
|
-
(git branch | grep -q '* master') || {
|
18
|
-
echo "Only release from the master branch."
|
19
|
-
exit 1
|
20
|
-
}
|
21
|
-
|
22
|
-
# Figure out what version we're releasing.
|
23
|
-
|
24
|
-
tag=v`ls bunto-seo-tag-*.gem | sed 's/^bunto-seo-tag-\(.*\)\.gem$/\1/'`
|
25
|
-
|
26
|
-
# Make sure we haven't released this version before.
|
27
|
-
|
28
|
-
git fetch -t origin
|
29
|
-
|
30
|
-
(git tag -l | grep -q "$tag") && {
|
31
|
-
echo "Whoops, there's already a '${tag}' tag."
|
32
|
-
exit 1
|
33
|
-
}
|
34
|
-
|
35
|
-
# Tag it and bag it.
|
36
|
-
|
37
|
-
gem push bunto-seo-tag-*.gem && git tag "$tag" &&
|
38
|
-
git push origin master && git push origin "$tag"
|
1
|
+
#!/bin/sh
|
2
|
+
# Tag and push a release.
|
3
|
+
|
4
|
+
set -e
|
5
|
+
|
6
|
+
# Make sure we're in the project root.
|
7
|
+
|
8
|
+
cd $(dirname "$0")/..
|
9
|
+
|
10
|
+
# Build a new gem archive.
|
11
|
+
|
12
|
+
rm -rf bunto-seo-tag-*.gem
|
13
|
+
gem build -q bunto-seo-tag.gemspec
|
14
|
+
|
15
|
+
# Make sure we're on the master branch.
|
16
|
+
|
17
|
+
(git branch | grep -q '* master') || {
|
18
|
+
echo "Only release from the master branch."
|
19
|
+
exit 1
|
20
|
+
}
|
21
|
+
|
22
|
+
# Figure out what version we're releasing.
|
23
|
+
|
24
|
+
tag=v`ls bunto-seo-tag-*.gem | sed 's/^bunto-seo-tag-\(.*\)\.gem$/\1/'`
|
25
|
+
|
26
|
+
# Make sure we haven't released this version before.
|
27
|
+
|
28
|
+
git fetch -t origin
|
29
|
+
|
30
|
+
(git tag -l | grep -q "$tag") && {
|
31
|
+
echo "Whoops, there's already a '${tag}' tag."
|
32
|
+
exit 1
|
33
|
+
}
|
34
|
+
|
35
|
+
# Tag it and bag it.
|
36
|
+
|
37
|
+
gem push bunto-seo-tag-*.gem && git tag "$tag" &&
|
38
|
+
git push origin master && git push origin "$tag"
|
data/script/site
ADDED
metadata
CHANGED
@@ -1,104 +1,90 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: bunto-seo-tag
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version:
|
4
|
+
version: 6.0.0
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Ben Balter
|
8
8
|
- Suriyaa Kudo
|
9
|
-
autorequire:
|
9
|
+
autorequire:
|
10
10
|
bindir: exe
|
11
11
|
cert_chain: []
|
12
|
-
date:
|
12
|
+
date: 2017-08-07 00:00:00.000000000 Z
|
13
13
|
dependencies:
|
14
14
|
- !ruby/object:Gem::Dependency
|
15
|
-
requirement: !ruby/object:Gem::Requirement
|
16
|
-
requirements:
|
17
|
-
- - ">="
|
18
|
-
- !ruby/object:Gem::Version
|
19
|
-
version: '0'
|
20
15
|
name: bunto
|
21
|
-
prerelease: false
|
22
|
-
type: :runtime
|
23
|
-
version_requirements: !ruby/object:Gem::Requirement
|
24
|
-
requirements:
|
25
|
-
- - ">="
|
26
|
-
- !ruby/object:Gem::Version
|
27
|
-
version: '0'
|
28
|
-
- !ruby/object:Gem::Dependency
|
29
16
|
requirement: !ruby/object:Gem::Requirement
|
30
17
|
requirements:
|
31
18
|
- - "~>"
|
32
19
|
- !ruby/object:Gem::Version
|
33
|
-
version: '
|
34
|
-
|
20
|
+
version: '3.4'
|
21
|
+
type: :runtime
|
35
22
|
prerelease: false
|
36
|
-
type: :development
|
37
23
|
version_requirements: !ruby/object:Gem::Requirement
|
38
24
|
requirements:
|
39
25
|
- - "~>"
|
40
26
|
- !ruby/object:Gem::Version
|
41
|
-
version: '
|
27
|
+
version: '3.4'
|
42
28
|
- !ruby/object:Gem::Dependency
|
29
|
+
name: bundler
|
43
30
|
requirement: !ruby/object:Gem::Requirement
|
44
31
|
requirements:
|
45
32
|
- - "~>"
|
46
33
|
- !ruby/object:Gem::Version
|
47
|
-
version: '
|
48
|
-
name: rake
|
49
|
-
prerelease: false
|
34
|
+
version: '1.14'
|
50
35
|
type: :development
|
36
|
+
prerelease: false
|
51
37
|
version_requirements: !ruby/object:Gem::Requirement
|
52
38
|
requirements:
|
53
39
|
- - "~>"
|
54
40
|
- !ruby/object:Gem::Version
|
55
|
-
version: '
|
41
|
+
version: '1.14'
|
56
42
|
- !ruby/object:Gem::Dependency
|
43
|
+
name: rspec
|
57
44
|
requirement: !ruby/object:Gem::Requirement
|
58
45
|
requirements:
|
59
46
|
- - "~>"
|
60
47
|
- !ruby/object:Gem::Version
|
61
|
-
version: '3.
|
62
|
-
name: rspec
|
63
|
-
prerelease: false
|
48
|
+
version: '3.5'
|
64
49
|
type: :development
|
50
|
+
prerelease: false
|
65
51
|
version_requirements: !ruby/object:Gem::Requirement
|
66
52
|
requirements:
|
67
53
|
- - "~>"
|
68
54
|
- !ruby/object:Gem::Version
|
69
|
-
version: '3.
|
55
|
+
version: '3.5'
|
70
56
|
- !ruby/object:Gem::Dependency
|
57
|
+
name: html-proofer
|
71
58
|
requirement: !ruby/object:Gem::Requirement
|
72
59
|
requirements:
|
73
60
|
- - "~>"
|
74
61
|
- !ruby/object:Gem::Version
|
75
|
-
version: '
|
76
|
-
name: html-proofer
|
77
|
-
prerelease: false
|
62
|
+
version: '3.6'
|
78
63
|
type: :development
|
64
|
+
prerelease: false
|
79
65
|
version_requirements: !ruby/object:Gem::Requirement
|
80
66
|
requirements:
|
81
67
|
- - "~>"
|
82
68
|
- !ruby/object:Gem::Version
|
83
|
-
version: '
|
69
|
+
version: '3.6'
|
84
70
|
- !ruby/object:Gem::Dependency
|
71
|
+
name: rubocop
|
85
72
|
requirement: !ruby/object:Gem::Requirement
|
86
73
|
requirements:
|
87
74
|
- - "~>"
|
88
75
|
- !ruby/object:Gem::Version
|
89
|
-
version: '0.
|
90
|
-
name: rubocop
|
91
|
-
prerelease: false
|
76
|
+
version: '0.48'
|
92
77
|
type: :development
|
78
|
+
prerelease: false
|
93
79
|
version_requirements: !ruby/object:Gem::Requirement
|
94
80
|
requirements:
|
95
81
|
- - "~>"
|
96
82
|
- !ruby/object:Gem::Version
|
97
|
-
version: '0.
|
98
|
-
description:
|
83
|
+
version: '0.48'
|
84
|
+
description:
|
99
85
|
email:
|
100
86
|
- ben.balter@github.com
|
101
|
-
-
|
87
|
+
- github@suriyaa.tk
|
102
88
|
executables: []
|
103
89
|
extensions: []
|
104
90
|
extra_rdoc_files: []
|
@@ -109,22 +95,29 @@ files:
|
|
109
95
|
- ".travis.yml"
|
110
96
|
- Gemfile
|
111
97
|
- LICENSE.txt
|
112
|
-
- README.md
|
113
|
-
- Rakefile
|
114
98
|
- bunto-seo-tag.gemspec
|
99
|
+
- docs/README.md
|
100
|
+
- docs/_config.yml
|
101
|
+
- docs/_layouts/default.html
|
102
|
+
- docs/advanced-usage.md
|
103
|
+
- docs/installation.md
|
104
|
+
- docs/usage.md
|
115
105
|
- lib/bunto-seo-tag.rb
|
106
|
+
- lib/bunto-seo-tag/drop.rb
|
116
107
|
- lib/bunto-seo-tag/filters.rb
|
108
|
+
- lib/bunto-seo-tag/json_ld.rb
|
117
109
|
- lib/bunto-seo-tag/version.rb
|
118
110
|
- lib/template.html
|
119
111
|
- script/bootstrap
|
120
112
|
- script/cibuild
|
121
113
|
- script/release
|
114
|
+
- script/site
|
122
115
|
homepage: https://github.com/bunto/bunto-seo-tag
|
123
116
|
licenses:
|
124
117
|
- MIT
|
125
118
|
metadata:
|
126
119
|
allowed_push_host: https://rubygems.org
|
127
|
-
post_install_message:
|
120
|
+
post_install_message:
|
128
121
|
rdoc_options: []
|
129
122
|
require_paths:
|
130
123
|
- lib
|
@@ -139,9 +132,10 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
139
132
|
- !ruby/object:Gem::Version
|
140
133
|
version: '0'
|
141
134
|
requirements: []
|
142
|
-
rubyforge_project:
|
143
|
-
rubygems_version: 2.
|
144
|
-
signing_key:
|
135
|
+
rubyforge_project:
|
136
|
+
rubygems_version: 2.6.12
|
137
|
+
signing_key:
|
145
138
|
specification_version: 4
|
146
|
-
summary: A Bunto plugin to add metadata tags for search engines and social networks
|
139
|
+
summary: A Bunto plugin to add metadata tags for search engines and social networks
|
140
|
+
to better index and display your site's content.
|
147
141
|
test_files: []
|
data/README.md
DELETED
@@ -1,155 +0,0 @@
|
|
1
|
-
# Bunto SEO Tag
|
2
|
-
|
3
|
-
A Bunto plugin to add metadata tags for search engines and social networks to better index and display your site's content.
|
4
|
-
|
5
|
-
[![Gem Version](https://badge.fury.io/rb/bunto-seo-tag.svg)](https://badge.fury.io/rb/bunto-seo-tag) [![Build Status](https://travis-ci.org/bunto/bunto-seo-tag.svg)](https://travis-ci.org/bunto/bunto-seo-tag)
|
6
|
-
|
7
|
-
## What it does
|
8
|
-
|
9
|
-
Bunto SEO Tag adds the following meta tags to your site:
|
10
|
-
|
11
|
-
* Pages title (with site title appended when available)
|
12
|
-
* Page description
|
13
|
-
* Canonical URL
|
14
|
-
* Next and previous URLs for posts
|
15
|
-
* [JSON-LD Site and post metadata](https://developers.google.com/structured-data/) for richer indexing
|
16
|
-
* [Open graph](http://ogp.me/) title, description, site title, and URL (for Facebook, LinkedIn, etc.)
|
17
|
-
* [Twitter summary card](https://dev.twitter.com/cards/overview) metadata
|
18
|
-
|
19
|
-
While you could theoretically add the necessary metadata tags yourself, Bunto SEO Tag provides a battle-tested template of crowdsourced best-practices.
|
20
|
-
|
21
|
-
## What it doesn't do
|
22
|
-
|
23
|
-
Bunto 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 Bunto site's structure and content (e.g., more traditional SEO optimization), take a look at the Bunto-similar gem ["The Jekyll SEO Gem"](https://github.com/pmarsceill/jekyll-seo-gem).
|
24
|
-
|
25
|
-
Bunto 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.
|
26
|
-
|
27
|
-
## Installation
|
28
|
-
|
29
|
-
1. Add the following to your site's `Gemfile`:
|
30
|
-
|
31
|
-
```ruby
|
32
|
-
gem 'bunto-seo-tag'
|
33
|
-
```
|
34
|
-
|
35
|
-
2. Add the following to your site's `_config.yml`:
|
36
|
-
|
37
|
-
```yml
|
38
|
-
gems:
|
39
|
-
- bunto-seo-tag
|
40
|
-
```
|
41
|
-
|
42
|
-
3. Add the following right before `</head>` in your site's template(s):
|
43
|
-
|
44
|
-
```liquid
|
45
|
-
{% seo %}
|
46
|
-
```
|
47
|
-
|
48
|
-
## Usage
|
49
|
-
|
50
|
-
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):
|
51
|
-
|
52
|
-
* `title` - Your site's title (e.g., Suriyaa's awesome site, The GitHub Blog, etc.)
|
53
|
-
* `description` - A short description (e.g., A blog dedicated to reviewing cat gifs)
|
54
|
-
* `url` - The full URL to your site. Note: `site.github.url` will be used by default.
|
55
|
-
* `author` - global author information (see below)
|
56
|
-
* `twitter:username` - The site's Twitter handle. You'll want to describe it like so:
|
57
|
-
|
58
|
-
```yml
|
59
|
-
twitter:
|
60
|
-
username: SuriyaaKudoIsc
|
61
|
-
```
|
62
|
-
|
63
|
-
* `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:
|
64
|
-
|
65
|
-
```yml
|
66
|
-
facebook:
|
67
|
-
app_id: 1234
|
68
|
-
publisher: 1234
|
69
|
-
```
|
70
|
-
|
71
|
-
* `logo` - Relative URL to a site-wide logo (e.g., `/assets/your-company-logo.png`)
|
72
|
-
* `social` - For [specifying social profiles](https://developers.google.com/structured-data/customize/social-profiles). The following properties are available:
|
73
|
-
* `name` - If the user or organization name differs from the site's name
|
74
|
-
* `links` - An array of links to social media profiles.
|
75
|
-
* `google_site_verification` for verifying ownership via Google webmaster tools
|
76
|
-
|
77
|
-
The SEO tag will respect the following YAML front matter if included in a post, page, or document:
|
78
|
-
|
79
|
-
* `title` - The title of the post, page, or document
|
80
|
-
* `description` - A short description of the page's content
|
81
|
-
* `image` - Relative URL to an image associated with the post, page, or document (e.g., `/assets/page-pic.jpg`)
|
82
|
-
* `author` - Page-, post-, or document-specific author information (see below)
|
83
|
-
|
84
|
-
### Disabling `<title>` output
|
85
|
-
|
86
|
-
Bunto 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:
|
87
|
-
|
88
|
-
```
|
89
|
-
{% seo title=false %}
|
90
|
-
```
|
91
|
-
|
92
|
-
### Author information
|
93
|
-
|
94
|
-
Author information is used to propagate the `creator` field of Twitter summary cards. This is should be an author-specific, not site-wide Twitter handle (the site-wide username be stored as `site.twitter.username`).
|
95
|
-
|
96
|
-
*TL;DR: In most cases, put `author: [your Twitter handle]` in the document's front matter, for sites with multiple authors. If you need something more complicated, read on.*
|
97
|
-
|
98
|
-
There are several ways to convey this author-specific information. Author information is found in the following order of priority:
|
99
|
-
|
100
|
-
1. An `author` object, in the documents's front matter, e.g.:
|
101
|
-
|
102
|
-
```yml
|
103
|
-
author:
|
104
|
-
twitter: SuriyaaKudoIsc
|
105
|
-
```
|
106
|
-
|
107
|
-
2. An `author` object, in the site's `_config.yml`, e.g.:
|
108
|
-
|
109
|
-
```yml
|
110
|
-
author:
|
111
|
-
twitter: SuriyaaKudoIsc
|
112
|
-
```
|
113
|
-
|
114
|
-
3. `site.data.authors[author]`, if an author is specified in the document's front matter, and a corresponding key exists in `site.data.authors`. E.g., you have the following in the document's front matter:
|
115
|
-
|
116
|
-
```yml
|
117
|
-
author: SuriyaaKudoIsc
|
118
|
-
```
|
119
|
-
|
120
|
-
And you have the following in `_data/authors.yml`:
|
121
|
-
|
122
|
-
```yml
|
123
|
-
SuriyaaKudoIsc:
|
124
|
-
picture: /img/SuriyaaKudoIsc.png
|
125
|
-
twitter: buntorb
|
126
|
-
|
127
|
-
potus:
|
128
|
-
picture: /img/potus.png
|
129
|
-
twitter: whitehouse
|
130
|
-
```
|
131
|
-
|
132
|
-
In the above example, the author `SuriyaaKudoIsc`'s Twitter handle will be resolved to `@buntorb`. This allows you to centralize author information in a single `_data/authors` file for site with many authors that require more than just the author's username.
|
133
|
-
|
134
|
-
*Pro-tip: If `authors` is present in the document's front matter as an array (and `author` is not), the plugin will use the first author listed, as Twitter supports only one author.*
|
135
|
-
|
136
|
-
4. An author in the document's front matter (the simplest way), e.g.:
|
137
|
-
|
138
|
-
```yml
|
139
|
-
author: SuriyaaKudoIsc
|
140
|
-
```
|
141
|
-
|
142
|
-
5. An author in the site's `_config.yml`, e.g.:
|
143
|
-
|
144
|
-
```yml
|
145
|
-
author: SuriyaaKudoIsc
|
146
|
-
```
|
147
|
-
|
148
|
-
### Customizing JSON-LD output
|
149
|
-
|
150
|
-
The following options can be set for any particular page. While the default options are meant to serve most users in the most common circumstances, there may be situations where more precise control is necessary.
|
151
|
-
|
152
|
-
* `seo`
|
153
|
-
* `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é")
|
154
|
-
* `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.
|
155
|
-
* `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.
|