meta-tags 2.13.0 → 2.19.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- checksums.yaml.gz.sig +0 -0
- data/Appraisals +25 -0
- data/CHANGELOG.md +158 -78
- data/CONTRIBUTING.md +6 -6
- data/Gemfile +5 -19
- data/README.md +174 -137
- data/Rakefile +44 -6
- data/Steepfile +13 -0
- data/certs/kpumuk.pem +19 -18
- data/gemfiles/rails_5.1.gemfile +8 -0
- data/gemfiles/rails_5.1.gemfile.lock +200 -0
- data/gemfiles/rails_5.2.gemfile +8 -0
- data/gemfiles/rails_5.2.gemfile.lock +200 -0
- data/gemfiles/rails_6.0.gemfile +8 -0
- data/gemfiles/rails_6.0.gemfile.lock +202 -0
- data/gemfiles/rails_6.1.gemfile +8 -0
- data/gemfiles/rails_6.1.gemfile.lock +201 -0
- data/gemfiles/rails_7.0.gemfile +8 -0
- data/gemfiles/rails_7.0.gemfile.lock +201 -0
- data/gemfiles/rails_7.1.gemfile +8 -0
- data/gemfiles/rails_7.1.gemfile.lock +231 -0
- data/lib/generators/meta_tags/install_generator.rb +1 -1
- data/lib/meta-tags.rb +1 -1
- data/lib/meta_tags/configuration.rb +23 -16
- data/lib/meta_tags/controller_helper.rb +4 -4
- data/lib/meta_tags/meta_tags_collection.rb +31 -22
- data/lib/meta_tags/railtie.rb +4 -4
- data/lib/meta_tags/renderer.rb +55 -28
- data/lib/meta_tags/tag.rb +1 -1
- data/lib/meta_tags/text_normalizer.rb +44 -39
- data/lib/meta_tags/version.rb +1 -1
- data/lib/meta_tags/view_helper.rb +7 -7
- data/lib/meta_tags.rb +13 -10
- data/meta-tags.gemspec +41 -22
- data/sig/lib/_internal/rails.rbs +58 -0
- data/sig/lib/meta_tags/configuration.rbs +19 -0
- data/sig/lib/meta_tags/content_tag.rbs +5 -0
- data/sig/lib/meta_tags/controller_helper.rbs +14 -0
- data/sig/lib/meta_tags/meta_tags_collection.rbs +41 -0
- data/sig/lib/meta_tags/renderer.rbs +50 -0
- data/sig/lib/meta_tags/tag.rbs +12 -0
- data/sig/lib/meta_tags/text_normalizer.rbs +36 -0
- data/sig/lib/meta_tags/version.rbs +4 -0
- data/sig/lib/meta_tags/view_helper.rbs +57 -0
- data/sig/lib/meta_tags.rbs +18 -0
- data.tar.gz.sig +0 -0
- metadata +165 -35
- metadata.gz.sig +0 -0
data/README.md
CHANGED
|
@@ -2,29 +2,30 @@
|
|
|
2
2
|
|
|
3
3
|
[](https://circleci.com/gh/kpumuk/meta-tags)
|
|
4
4
|
[](https://badge.fury.io/rb/meta-tags)
|
|
5
|
+
[](https://github.com/testdouble/standard)
|
|
5
6
|
[](https://codeclimate.com/github/kpumuk/meta-tags)
|
|
6
7
|
[](https://codeclimate.com/github/kpumuk/meta-tags/coverage)
|
|
7
8
|
[](https://badge.fury.io/rb/meta-tags)
|
|
8
|
-
[](https://github.com/kpumuk/meta-tags/blob/
|
|
9
|
+
[](https://github.com/kpumuk/meta-tags/blob/main/CHANGELOG.md)
|
|
9
10
|
|
|
10
11
|
Search Engine Optimization (SEO) plugin for Ruby on Rails applications.
|
|
11
12
|
|
|
12
13
|
## Ruby on Rails
|
|
13
14
|
|
|
14
|
-
MetaTags
|
|
15
|
-
major Rails releases up to
|
|
15
|
+
MetaTags main branch fully supports Ruby on Rails 5.1+, and is tested against all
|
|
16
|
+
major Rails releases up to 7.1.
|
|
16
17
|
|
|
17
|
-
Ruby versions older than 2.
|
|
18
|
+
Ruby versions older than 2.7 are no longer officially supported.
|
|
18
19
|
|
|
19
|
-
_Please note_ that we
|
|
20
|
-
Ruby on Rails older than
|
|
20
|
+
_Please note_ that we no longer support Ruby versions older than 2.6.0 and
|
|
21
|
+
Ruby on Rails older than 5.1, because they reached their [End of Life](https://endoflife.date/ruby).
|
|
21
22
|
|
|
22
23
|
## Installation
|
|
23
24
|
|
|
24
25
|
Add the "meta-tags" gem to your `Gemfile`.
|
|
25
26
|
|
|
26
27
|
```ruby
|
|
27
|
-
gem
|
|
28
|
+
gem "meta-tags"
|
|
28
29
|
```
|
|
29
30
|
|
|
30
31
|
And run `bundle install` command.
|
|
@@ -55,14 +56,14 @@ First, add this code to your main layout:
|
|
|
55
56
|
|
|
56
57
|
```erb
|
|
57
58
|
<head>
|
|
58
|
-
<%= display_meta_tags site:
|
|
59
|
+
<%= display_meta_tags site: "My website" %>
|
|
59
60
|
</head>
|
|
60
61
|
```
|
|
61
62
|
|
|
62
63
|
Then, to set the page title, add this to each of your views (see below for other options):
|
|
63
64
|
|
|
64
65
|
```erb
|
|
65
|
-
<h1><%= title
|
|
66
|
+
<h1><%= title "My page title" %></h1>
|
|
66
67
|
```
|
|
67
68
|
|
|
68
69
|
When views are rendered, the page title will be included in the right spots:
|
|
@@ -83,17 +84,19 @@ You can find allowed options for `display_meta_tags` method below.
|
|
|
83
84
|
You can define following instance variables:
|
|
84
85
|
|
|
85
86
|
```ruby
|
|
86
|
-
@page_title
|
|
87
|
-
@page_description =
|
|
88
|
-
@page_keywords
|
|
87
|
+
@page_title = "Member Login"
|
|
88
|
+
@page_description = "Member login page."
|
|
89
|
+
@page_keywords = "Site, Login, Members"
|
|
89
90
|
```
|
|
90
91
|
|
|
91
92
|
Also you could use `set_meta_tags` method to define all meta tags simultaneously:
|
|
92
93
|
|
|
93
94
|
```ruby
|
|
94
|
-
set_meta_tags
|
|
95
|
-
|
|
96
|
-
|
|
95
|
+
set_meta_tags(
|
|
96
|
+
title: "Member Login",
|
|
97
|
+
description: "Member login page.",
|
|
98
|
+
keywords: "Site, Login, Members"
|
|
99
|
+
)
|
|
97
100
|
```
|
|
98
101
|
|
|
99
102
|
You can find allowed options for `set_meta_tags` method below.
|
|
@@ -103,9 +106,9 @@ You can find allowed options for `set_meta_tags` method below.
|
|
|
103
106
|
To set meta tags you can use following methods:
|
|
104
107
|
|
|
105
108
|
```erb
|
|
106
|
-
<% title
|
|
107
|
-
<% description
|
|
108
|
-
<% keywords
|
|
109
|
+
<% title "Member Login" %>
|
|
110
|
+
<% description "Member login page." %>
|
|
111
|
+
<% keywords "Site, Login, Members" %>
|
|
109
112
|
<% nofollow %>
|
|
110
113
|
<% noindex %>
|
|
111
114
|
<% refresh 3 %>
|
|
@@ -114,9 +117,13 @@ To set meta tags you can use following methods:
|
|
|
114
117
|
Also there is `set_meta_tags` method exists:
|
|
115
118
|
|
|
116
119
|
```erb
|
|
117
|
-
<%
|
|
118
|
-
|
|
119
|
-
|
|
120
|
+
<%
|
|
121
|
+
set_meta_tags(
|
|
122
|
+
title: "Member Login",
|
|
123
|
+
description: "Member login page.",
|
|
124
|
+
keywords: "Site, Login, Members"
|
|
125
|
+
)
|
|
126
|
+
%>
|
|
120
127
|
```
|
|
121
128
|
|
|
122
129
|
You can pass an object that implements `#to_meta_tags` method and returns a Hash:
|
|
@@ -126,7 +133,7 @@ class Document < ApplicationRecord
|
|
|
126
133
|
def to_meta_tags
|
|
127
134
|
{
|
|
128
135
|
title: title,
|
|
129
|
-
description: summary
|
|
136
|
+
description: summary
|
|
130
137
|
}
|
|
131
138
|
end
|
|
132
139
|
end
|
|
@@ -139,43 +146,43 @@ The `title` method returns title itself, so you can use it to show the title
|
|
|
139
146
|
somewhere on the page:
|
|
140
147
|
|
|
141
148
|
```erb
|
|
142
|
-
<h1><%= title
|
|
149
|
+
<h1><%= title "Member Login" %></h1>
|
|
143
150
|
```
|
|
144
151
|
|
|
145
152
|
If you want to set the title and display another text, use this:
|
|
146
153
|
|
|
147
154
|
```erb
|
|
148
|
-
<h1><%= title
|
|
155
|
+
<h1><%= title "Member Login", "Here you can login to the site:" %></h1>
|
|
149
156
|
```
|
|
150
157
|
|
|
151
158
|
### Allowed options for `display_meta_tags` and `set_meta_tags` methods
|
|
152
159
|
|
|
153
160
|
Use these options to customize the title format:
|
|
154
161
|
|
|
155
|
-
| Option | Description
|
|
156
|
-
| -------------- |
|
|
157
|
-
| `:site` | site title
|
|
158
|
-
| `:title` | page title
|
|
159
|
-
| `:description` | page description
|
|
160
|
-
| `:keywords` | page keywords
|
|
161
|
-
| `:charset` | page character set
|
|
162
|
-
| `:prefix` | text between site name and separator
|
|
163
|
-
| `:separator` | text used to separate website name from page title
|
|
164
|
-
| `:suffix` | text between separator and page title
|
|
165
|
-
| `:lowercase` | when true, the page name will be lowercase
|
|
166
|
-
| `:reverse` | when true, the page and site names will be reversed
|
|
167
|
-
| `:noindex` | add noindex meta tag; when true,
|
|
168
|
-
| `:index` | add index meta tag; when true,
|
|
169
|
-
| `:nofollow` | add nofollow meta tag; when true,
|
|
170
|
-
| `:follow` | add follow meta tag; when true,
|
|
171
|
-
| `:noarchive` | add noarchive meta tag; when true,
|
|
172
|
-
| `:canonical` | add canonical link tag
|
|
173
|
-
| `:prev` | add prev link tag
|
|
174
|
-
| `:next` | add next link tag
|
|
175
|
-
| `:image_src` | add image_src link tag
|
|
176
|
-
| `:og` | add Open Graph tags (Hash)
|
|
177
|
-
| `:twitter` | add Twitter tags (Hash)
|
|
178
|
-
| `:refresh` | refresh interval and optionally url to redirect to
|
|
162
|
+
| Option | Description |
|
|
163
|
+
| -------------- | -------------------------------------------------------------------------------------------------------------------- |
|
|
164
|
+
| `:site` | site title |
|
|
165
|
+
| `:title` | page title |
|
|
166
|
+
| `:description` | page description |
|
|
167
|
+
| `:keywords` | page keywords |
|
|
168
|
+
| `:charset` | page character set |
|
|
169
|
+
| `:prefix` | text between site name and separator |
|
|
170
|
+
| `:separator` | text used to separate website name from page title |
|
|
171
|
+
| `:suffix` | text between separator and page title |
|
|
172
|
+
| `:lowercase` | when true, the page name will be lowercase |
|
|
173
|
+
| `:reverse` | when true, the page and site names will be reversed |
|
|
174
|
+
| `:noindex` | add noindex meta tag; when true, "robots" will be used; accepts a string with a robot name, or an array of strings |
|
|
175
|
+
| `:index` | add index meta tag; when true, "robots" will be used; accepts a string with a robot name, or an array of strings |
|
|
176
|
+
| `:nofollow` | add nofollow meta tag; when true, "robots" will be used; accepts a string with a robot name, or an array of strings |
|
|
177
|
+
| `:follow` | add follow meta tag; when true, "robots" will be used; accepts a string with a robot name, or an array of strings |
|
|
178
|
+
| `:noarchive` | add noarchive meta tag; when true, "robots" will be used; accepts a string with a robot name, or an array of strings |
|
|
179
|
+
| `:canonical` | add canonical link tag |
|
|
180
|
+
| `:prev` | add prev link tag |
|
|
181
|
+
| `:next` | add next link tag |
|
|
182
|
+
| `:image_src` | add image_src link tag |
|
|
183
|
+
| `:og` | add Open Graph tags (Hash) |
|
|
184
|
+
| `:twitter` | add Twitter tags (Hash) |
|
|
185
|
+
| `:refresh` | refresh interval and optionally url to redirect to |
|
|
179
186
|
|
|
180
187
|
And here are a few examples to give you ideas.
|
|
181
188
|
|
|
@@ -184,8 +191,8 @@ And here are a few examples to give you ideas.
|
|
|
184
191
|
<%= display_meta_tags prefix: false, separator: ":" %>
|
|
185
192
|
<%= display_meta_tags lowercase: true %>
|
|
186
193
|
<%= display_meta_tags reverse: true, prefix: false %>
|
|
187
|
-
<%= display_meta_tags og: { title:
|
|
188
|
-
<%= display_meta_tags alternate: {
|
|
194
|
+
<%= display_meta_tags og: { title: "The Rock", type: "video.movie" } %>
|
|
195
|
+
<%= display_meta_tags alternate: { "zh-Hant" => "http://example.com.tw/base/url" } %>
|
|
189
196
|
```
|
|
190
197
|
|
|
191
198
|
### Allowed values
|
|
@@ -193,16 +200,16 @@ And here are a few examples to give you ideas.
|
|
|
193
200
|
You can specify `:title` as a string or array:
|
|
194
201
|
|
|
195
202
|
```ruby
|
|
196
|
-
set_meta_tags title: [
|
|
203
|
+
set_meta_tags title: ["part1", "part2"], site: "site"
|
|
197
204
|
# site | part1 | part2
|
|
198
|
-
set_meta_tags title: [
|
|
205
|
+
set_meta_tags title: ["part1", "part2"], reverse: true, site: "site"
|
|
199
206
|
# part2 | part1 | site
|
|
200
207
|
```
|
|
201
208
|
|
|
202
209
|
Keywords can be passed as string of comma-separated values, or as an array:
|
|
203
210
|
|
|
204
211
|
```ruby
|
|
205
|
-
set_meta_tags keywords: [
|
|
212
|
+
set_meta_tags keywords: ["tag1", "tag2"]
|
|
206
213
|
# tag1, tag2
|
|
207
214
|
```
|
|
208
215
|
|
|
@@ -219,7 +226,7 @@ Say, you have the following in your application layout:
|
|
|
219
226
|
```ruby
|
|
220
227
|
display_meta_tags og: {
|
|
221
228
|
title: :title,
|
|
222
|
-
site_name: :site
|
|
229
|
+
site_name: :site
|
|
223
230
|
}
|
|
224
231
|
```
|
|
225
232
|
|
|
@@ -227,7 +234,7 @@ The value of `og[:title]` is a symbol and therefore references the value of the
|
|
|
227
234
|
top level `title` meta tag. With the following in any view:
|
|
228
235
|
|
|
229
236
|
```ruby
|
|
230
|
-
title
|
|
237
|
+
title "my great view"
|
|
231
238
|
```
|
|
232
239
|
|
|
233
240
|
You get this open graph meta tag for free:
|
|
@@ -261,10 +268,10 @@ code duplication, you can define a helper in `application_helper.rb`:
|
|
|
261
268
|
```ruby
|
|
262
269
|
def default_meta_tags
|
|
263
270
|
{
|
|
264
|
-
title:
|
|
265
|
-
description:
|
|
266
|
-
keywords:
|
|
267
|
-
separator:
|
|
271
|
+
title: "Member Login",
|
|
272
|
+
description: "Member login page.",
|
|
273
|
+
keywords: "Site, Login, Members",
|
|
274
|
+
separator: "—".html_safe
|
|
268
275
|
}
|
|
269
276
|
end
|
|
270
277
|
```
|
|
@@ -295,11 +302,11 @@ browser are displayed in the title bar. The search engines look at
|
|
|
295
302
|
the title bar to determine what the page is all about.
|
|
296
303
|
|
|
297
304
|
```ruby
|
|
298
|
-
set_meta_tags title:
|
|
305
|
+
set_meta_tags title: "Member Login"
|
|
299
306
|
# <title>Member Login</title>
|
|
300
|
-
set_meta_tags site:
|
|
307
|
+
set_meta_tags site: "Site Title", title: "Member Login"
|
|
301
308
|
# <title>Site Title | Member Login</title>
|
|
302
|
-
set_meta_tags site:
|
|
309
|
+
set_meta_tags site: "Site Title", title: "Member Login", reverse: true
|
|
303
310
|
# <title>Member Login | Site Title</title>
|
|
304
311
|
```
|
|
305
312
|
|
|
@@ -307,7 +314,7 @@ Recommended title tag length: up to <b>70 characters</b>, <b>10 words</b>.
|
|
|
307
314
|
|
|
308
315
|
Further reading:
|
|
309
316
|
|
|
310
|
-
|
|
317
|
+
- [Title Tag](https://moz.com/learn/seo/title-tag)
|
|
311
318
|
|
|
312
319
|
### Description
|
|
313
320
|
|
|
@@ -325,8 +332,8 @@ Recommended description tag length: up to <b>300 characters</b>.
|
|
|
325
332
|
|
|
326
333
|
Further reading:
|
|
327
334
|
|
|
328
|
-
|
|
329
|
-
|
|
335
|
+
- [Meta Description](https://moz.com/learn/seo/meta-description)
|
|
336
|
+
- [How Long Should Your Meta Description Be? (2018 Edition)](https://moz.com/blog/how-long-should-your-meta-description-be-2018)
|
|
330
337
|
|
|
331
338
|
### Keywords
|
|
332
339
|
|
|
@@ -352,7 +359,7 @@ include specific pages in their indexes.
|
|
|
352
359
|
```ruby
|
|
353
360
|
set_meta_tags noindex: true
|
|
354
361
|
# <meta name="robots" content="noindex">
|
|
355
|
-
set_meta_tags noindex:
|
|
362
|
+
set_meta_tags noindex: "googlebot"
|
|
356
363
|
# <meta name="googlebot" content="noindex">
|
|
357
364
|
```
|
|
358
365
|
|
|
@@ -360,12 +367,12 @@ This is useful for pages like login, password reset, privacy policy, etc.
|
|
|
360
367
|
|
|
361
368
|
Further reading:
|
|
362
369
|
|
|
363
|
-
|
|
364
|
-
|
|
370
|
+
- [Blocking Google](http://www.google.com/support/webmasters/bin/answer.py?hl=en&answer=93708)
|
|
371
|
+
- [Using meta tags to block access to your site](http://www.google.com/support/webmasters/bin/answer.py?hl=en&answer=93710)
|
|
365
372
|
|
|
366
373
|
### Index
|
|
367
374
|
|
|
368
|
-
Although it is not required to add
|
|
375
|
+
Although it is not required to add "index" to "robots" as it is default value for Google, some SEO specialists recommend to add it to website
|
|
369
376
|
|
|
370
377
|
```ruby
|
|
371
378
|
set_meta_tags index: true
|
|
@@ -382,18 +389,18 @@ still arrives at your undesired page.
|
|
|
382
389
|
```ruby
|
|
383
390
|
set_meta_tags nofollow: true
|
|
384
391
|
# <meta name="robots" content="nofollow">
|
|
385
|
-
set_meta_tags nofollow:
|
|
392
|
+
set_meta_tags nofollow: "googlebot"
|
|
386
393
|
# <meta name="googlebot" content="nofollow">
|
|
387
394
|
```
|
|
388
395
|
|
|
389
396
|
Further reading:
|
|
390
397
|
|
|
391
|
-
|
|
392
|
-
|
|
398
|
+
- [About rel="nofollow"](http://www.google.com/support/webmasters/bin/answer.py?answer=96569)
|
|
399
|
+
- [Meta tags](http://www.google.com/support/webmasters/bin/answer.py?hl=en&answer=79812)
|
|
393
400
|
|
|
394
401
|
### Follow
|
|
395
402
|
|
|
396
|
-
Follow will work with Noindex
|
|
403
|
+
Follow will work with Noindex meta tag
|
|
397
404
|
|
|
398
405
|
```ruby
|
|
399
406
|
set_meta_tags noindex: true, follow: true
|
|
@@ -409,6 +416,9 @@ Canonical link element tells a search engine what is the canonical or main URL
|
|
|
409
416
|
for a content which have multiple URLs. The search engine will always return
|
|
410
417
|
that URL, and link popularity and authority will be applied to that URL.
|
|
411
418
|
|
|
419
|
+
Note: If you like follow a hint of John Mueller that you shouldn't mix canonical with noindex, then you can
|
|
420
|
+
set `MetaTags.config.skip_canonical_links_on_noindex = true` and we'll handle it for you.
|
|
421
|
+
|
|
412
422
|
```ruby
|
|
413
423
|
set_meta_tags canonical: "http://yoursite.com/canonical/url"
|
|
414
424
|
# <link rel="canonical" href="http://yoursite.com/canonical/url">
|
|
@@ -416,8 +426,8 @@ set_meta_tags canonical: "http://yoursite.com/canonical/url"
|
|
|
416
426
|
|
|
417
427
|
Further reading:
|
|
418
428
|
|
|
419
|
-
|
|
420
|
-
|
|
429
|
+
- [About rel="canonical"](http://www.google.com/support/webmasters/bin/answer.py?hl=en&answer=139394)
|
|
430
|
+
- [Canonicalization](http://www.google.com/support/webmasters/bin/answer.py?hl=en&answer=139066)
|
|
421
431
|
|
|
422
432
|
### Icon
|
|
423
433
|
|
|
@@ -426,13 +436,13 @@ icon, tab icon or bookmark icon, is a file containing one or more small icons,
|
|
|
426
436
|
most commonly 16×16 pixels, associated with a particular website or web page.
|
|
427
437
|
|
|
428
438
|
```ruby
|
|
429
|
-
set_meta_tags icon:
|
|
439
|
+
set_meta_tags icon: "/favicon.ico"
|
|
430
440
|
# <link rel="icon" href="/favicon.ico" type="image/x-icon">
|
|
431
|
-
set_meta_tags icon:
|
|
441
|
+
set_meta_tags icon: "/favicon.png", type: "image/png"
|
|
432
442
|
# <link rel="icon" href="/favicon.png" type="image/png">
|
|
433
443
|
set_meta_tags icon: [
|
|
434
|
-
{
|
|
435
|
-
{
|
|
444
|
+
{href: "/images/icons/icon_96.png", sizes: "32x32 96x96", type: "image/png"},
|
|
445
|
+
{href: "/images/icons/icon_itouch_precomp_32.png", rel: "apple-touch-icon-precomposed", sizes: "32x32", type: "image/png"}
|
|
436
446
|
]
|
|
437
447
|
# <link rel="icon" href="/images/icons/icon_96.png" type="image/png" sizes="32x32 96x96">
|
|
438
448
|
# <link rel="apple-touch-icon-precomposed" href="/images/icons/icon_itouch_precomp_32.png" type="image/png" sizes="32x32">
|
|
@@ -440,9 +450,8 @@ set_meta_tags icon: [
|
|
|
440
450
|
|
|
441
451
|
Further reading:
|
|
442
452
|
|
|
443
|
-
|
|
444
|
-
|
|
445
|
-
|
|
453
|
+
- [Favicon](https://www.wikiwand.com/en/Favicon)
|
|
454
|
+
- [Touch Icons](https://mathiasbynens.be/notes/touch-icons)
|
|
446
455
|
|
|
447
456
|
### Multi-regional and multilingual URLs, RSS and mobile links
|
|
448
457
|
|
|
@@ -450,11 +459,11 @@ Alternate link elements tell a search engine when there is content that's
|
|
|
450
459
|
translated or targeted to users in a certain region.
|
|
451
460
|
|
|
452
461
|
```ruby
|
|
453
|
-
set_meta_tags alternate: {
|
|
462
|
+
set_meta_tags alternate: {"fr" => "http://yoursite.fr/alternate/url"}
|
|
454
463
|
# <link rel="alternate" href="http://yoursite.fr/alternate/url" hreflang="fr">
|
|
455
464
|
|
|
456
|
-
set_meta_tags alternate: {
|
|
457
|
-
|
|
465
|
+
set_meta_tags alternate: {"fr" => "http://yoursite.fr/alternate/url",
|
|
466
|
+
"de" => "http://yoursite.de/alternate/url"}
|
|
458
467
|
# <link rel="alternate" href="http://yoursite.fr/alternate/url" hreflang="fr">
|
|
459
468
|
# <link rel="alternate" href="http://yoursite.de/alternate/url" hreflang="de">
|
|
460
469
|
```
|
|
@@ -463,17 +472,17 @@ If you need more than just multi-lingual links, you can use an alternative synta
|
|
|
463
472
|
|
|
464
473
|
```ruby
|
|
465
474
|
set_meta_tags alternate: [
|
|
466
|
-
|
|
467
|
-
|
|
468
|
-
|
|
469
|
-
|
|
475
|
+
{href: "http://example.fr/base/url", hreflang: "fr"},
|
|
476
|
+
{href: "http://example.com/feed.rss", type: "application/rss+xml", title: "RSS"},
|
|
477
|
+
{href: "http://m.example.com/page-1", media: "only screen and (max-width: 640px)"}
|
|
478
|
+
]
|
|
470
479
|
```
|
|
471
480
|
|
|
472
481
|
Further reading:
|
|
473
482
|
|
|
474
|
-
|
|
475
|
-
|
|
476
|
-
|
|
483
|
+
- [Multi-regional and multilingual sites](https://support.google.com/webmasters/answer/182192)
|
|
484
|
+
- [About rel="alternate" hreflang="x"](http://www.google.com/support/webmasters/bin/answer.py?hl=en&answer=189077)
|
|
485
|
+
- [Separate URLs](https://developers.google.com/webmasters/mobile-sites/mobile-seo/configurations/separate-urls#annotation-in-the-html)
|
|
477
486
|
|
|
478
487
|
### Pagination links
|
|
479
488
|
|
|
@@ -490,8 +499,8 @@ set_meta_tags next: "http://yoursite.com/url?page=3"
|
|
|
490
499
|
|
|
491
500
|
Further reading:
|
|
492
501
|
|
|
493
|
-
|
|
494
|
-
|
|
502
|
+
- [Pagination](http://support.google.com/webmasters/bin/answer.py?hl=en&answer=1663744)
|
|
503
|
+
- [Pagination with rel="next" and rel="prev"](http://googlewebmastercentral.blogspot.ca/2011/09/pagination-with-relnext-and-relprev.html)
|
|
495
504
|
|
|
496
505
|
### image_src links
|
|
497
506
|
|
|
@@ -518,8 +527,17 @@ set_meta_tags amphtml: url_for(format: :amp, only_path: false)
|
|
|
518
527
|
|
|
519
528
|
To link back to normal version, use `canonical`.
|
|
520
529
|
|
|
521
|
-
|
|
522
|
-
|
|
530
|
+
- [What Is AMP?](https://www.ampproject.org/learn/about-amp/)
|
|
531
|
+
- [Make Your Page Discoverable](https://www.ampproject.org/docs/guides/discovery)
|
|
532
|
+
|
|
533
|
+
### Manifest links
|
|
534
|
+
|
|
535
|
+
```ruby
|
|
536
|
+
set_meta_tags manifest: "manifest.json"
|
|
537
|
+
# <link rel="manifest" href="manifest.json">
|
|
538
|
+
```
|
|
539
|
+
|
|
540
|
+
- [What is manifest?](https://developer.mozilla.org/en-US/docs/Web/Manifest)
|
|
523
541
|
|
|
524
542
|
### Refresh interval and redirect URL
|
|
525
543
|
|
|
@@ -533,15 +551,14 @@ meta refresh to be used as a method of URL redirection.
|
|
|
533
551
|
```ruby
|
|
534
552
|
set_meta_tags refresh: 5
|
|
535
553
|
# <meta content="5" http-equiv="refresh">
|
|
536
|
-
set_meta_tags refresh:
|
|
554
|
+
set_meta_tags refresh: "5;url=http://example.com"
|
|
537
555
|
# <meta content="5;url=http://example.com" http-equiv="refresh">
|
|
538
556
|
```
|
|
539
557
|
|
|
540
558
|
Further reading:
|
|
541
559
|
|
|
542
|
-
|
|
543
|
-
|
|
544
|
-
|
|
560
|
+
- [Meta refresh](http://en.wikipedia.org/wiki/Meta_refresh)
|
|
561
|
+
- [What is the Meta Refresh Tag](http://webdesign.about.com/od/metataglibraries/a/aa080300a.htm)
|
|
545
562
|
|
|
546
563
|
### Open Search
|
|
547
564
|
|
|
@@ -550,15 +567,15 @@ Open Search link element to describe a search engine in a standard and accessibl
|
|
|
550
567
|
```ruby
|
|
551
568
|
set_meta_tags open_search: {
|
|
552
569
|
title: "Open Search",
|
|
553
|
-
href:
|
|
570
|
+
href: "/opensearch.xml"
|
|
554
571
|
}
|
|
555
572
|
# <link href="/opensearch.xml" rel="search" title="Open Search" type="application/opensearchdescription+xml">
|
|
556
573
|
```
|
|
557
574
|
|
|
558
575
|
Further reading:
|
|
559
576
|
|
|
560
|
-
|
|
561
|
-
|
|
577
|
+
- [OpenSearch specs](http://www.opensearch.org/Specifications/OpenSearch/1.1)
|
|
578
|
+
- [OpenSearch wiki](http://en.wikipedia.org/wiki/OpenSearch)
|
|
562
579
|
|
|
563
580
|
### Hashes
|
|
564
581
|
|
|
@@ -581,7 +598,7 @@ Repeated meta tags can be built just using an Array inside a Hash. For example:
|
|
|
581
598
|
|
|
582
599
|
```ruby
|
|
583
600
|
set_meta_tags og: {
|
|
584
|
-
|
|
601
|
+
image: ["http://example.com/rock.jpg", "http://example.com/rock2.jpg"]
|
|
585
602
|
}
|
|
586
603
|
# <meta property="og:image" content="http://example.com/rock.jpg">
|
|
587
604
|
# <meta property="og:image" content="http://example.com/rock2.jpg">
|
|
@@ -596,13 +613,13 @@ and in the future. Here's an example for a movie page:
|
|
|
596
613
|
|
|
597
614
|
```ruby
|
|
598
615
|
set_meta_tags og: {
|
|
599
|
-
title:
|
|
600
|
-
type:
|
|
601
|
-
url:
|
|
602
|
-
image:
|
|
603
|
-
video:
|
|
604
|
-
director:
|
|
605
|
-
writer:
|
|
616
|
+
title: "The Rock",
|
|
617
|
+
type: "video.movie",
|
|
618
|
+
url: "http://www.imdb.com/title/tt0117500/",
|
|
619
|
+
image: "http://ia.media-imdb.com/rock.jpg",
|
|
620
|
+
video: {
|
|
621
|
+
director: "http://www.imdb.com/name/nm0000881/",
|
|
622
|
+
writer: ["http://www.imdb.com/name/nm0918711/", "http://www.imdb.com/name/nm0177018/"]
|
|
606
623
|
}
|
|
607
624
|
}
|
|
608
625
|
# <meta property="og:title" content="The Rock">
|
|
@@ -618,19 +635,21 @@ Multiple images declared as an **array** (look at the `_` character):
|
|
|
618
635
|
|
|
619
636
|
```ruby
|
|
620
637
|
set_meta_tags og: {
|
|
621
|
-
title:
|
|
622
|
-
type:
|
|
623
|
-
url:
|
|
624
|
-
image:
|
|
625
|
-
|
|
626
|
-
|
|
627
|
-
|
|
628
|
-
|
|
629
|
-
|
|
630
|
-
|
|
631
|
-
|
|
632
|
-
|
|
633
|
-
|
|
638
|
+
title: "Two structured image properties",
|
|
639
|
+
type: "website",
|
|
640
|
+
url: "view-source:http://examples.opengraphprotocol.us/image-array.html",
|
|
641
|
+
image: [
|
|
642
|
+
{
|
|
643
|
+
_: "http://examples.opengraphprotocol.us/media/images/75.png",
|
|
644
|
+
width: 75,
|
|
645
|
+
height: 75
|
|
646
|
+
},
|
|
647
|
+
{
|
|
648
|
+
_: "http://examples.opengraphprotocol.us/media/images/50.png",
|
|
649
|
+
width: 50,
|
|
650
|
+
height: 50
|
|
651
|
+
}
|
|
652
|
+
]
|
|
634
653
|
}
|
|
635
654
|
# <meta property="og:title" content="Two structured image properties">
|
|
636
655
|
# <meta property="og:type" content="website">
|
|
@@ -647,10 +666,10 @@ Article meta tags are supported too:
|
|
|
647
666
|
|
|
648
667
|
```ruby
|
|
649
668
|
set_meta_tags article: {
|
|
650
|
-
published_time:
|
|
651
|
-
modified_time:
|
|
652
|
-
section:
|
|
653
|
-
tag:
|
|
669
|
+
published_time: "2013-09-17T05:59:00+01:00",
|
|
670
|
+
modified_time: "2013-09-16T19:08:47+01:00",
|
|
671
|
+
section: "Article Section",
|
|
672
|
+
tag: "Article Tag"
|
|
654
673
|
}
|
|
655
674
|
# <meta property="article:published_time" content="2013-09-17T05:59:00+01:00">
|
|
656
675
|
# <meta property="article:modified_time" content="2013-09-16T19:08:47+01:00">
|
|
@@ -660,8 +679,8 @@ set_meta_tags article: {
|
|
|
660
679
|
|
|
661
680
|
Further reading:
|
|
662
681
|
|
|
663
|
-
|
|
664
|
-
|
|
682
|
+
- [Open Graph protocol](http://developers.facebook.com/docs/opengraph/)
|
|
683
|
+
- [Must-Have Social Meta Tags for Twitter, Google+, Facebook and More](https://moz.com/blog/meta-data-templates-123)
|
|
665
684
|
|
|
666
685
|
### Twitter Cards
|
|
667
686
|
|
|
@@ -683,11 +702,11 @@ When you need to generate a [Twitter Photo card](https://dev.twitter.com/docs/ca
|
|
|
683
702
|
|
|
684
703
|
```ruby
|
|
685
704
|
set_meta_tags twitter: {
|
|
686
|
-
card:
|
|
705
|
+
card: "photo",
|
|
687
706
|
image: {
|
|
688
|
-
_:
|
|
689
|
-
width:
|
|
690
|
-
height: 100
|
|
707
|
+
_: "http://example.com/1.png",
|
|
708
|
+
width: 100,
|
|
709
|
+
height: 100
|
|
691
710
|
}
|
|
692
711
|
}
|
|
693
712
|
# <meta name="twitter:card" content="photo">
|
|
@@ -696,9 +715,27 @@ set_meta_tags twitter: {
|
|
|
696
715
|
# <meta name="twitter:image:height" content="100">
|
|
697
716
|
```
|
|
698
717
|
|
|
718
|
+
Special parameter `itemprop` can be used on a "anonymous" tag "\_" to generate "itemprop" HTML attribute:
|
|
719
|
+
|
|
720
|
+
```ruby
|
|
721
|
+
set_meta_tags twitter: {
|
|
722
|
+
card: "photo",
|
|
723
|
+
image: {
|
|
724
|
+
_: "http://example.com/1.png",
|
|
725
|
+
width: 100,
|
|
726
|
+
height: 100,
|
|
727
|
+
itemprop: "image"
|
|
728
|
+
}
|
|
729
|
+
}
|
|
730
|
+
# <meta name="twitter:card" content="photo">
|
|
731
|
+
# <meta name="twitter:image" content="http://example.com/1.png" itemprop="image">
|
|
732
|
+
# <meta name="twitter:image:width" content="100">
|
|
733
|
+
# <meta name="twitter:image:height" content="100">
|
|
734
|
+
```
|
|
735
|
+
|
|
699
736
|
Further reading:
|
|
700
737
|
|
|
701
|
-
|
|
738
|
+
- [Twitter Cards Documentation](https://dev.twitter.com/cards/)
|
|
702
739
|
|
|
703
740
|
### App Links
|
|
704
741
|
|
|
@@ -719,7 +756,7 @@ set_meta_tags al: {
|
|
|
719
756
|
|
|
720
757
|
Further reading:
|
|
721
758
|
|
|
722
|
-
|
|
759
|
+
- [App Links Documentation](https://developers.facebook.com/docs/applinks)
|
|
723
760
|
|
|
724
761
|
### Custom meta tags
|
|
725
762
|
|
|
@@ -737,7 +774,7 @@ You can also specify value as an Array, and values will be displayed as a list
|
|
|
737
774
|
of `meta` tags:
|
|
738
775
|
|
|
739
776
|
```ruby
|
|
740
|
-
set_meta_tags author: [
|
|
777
|
+
set_meta_tags author: ["Dmytro Shteflyuk", "John Doe"]
|
|
741
778
|
# <meta name="author" content="Dmytro Shteflyuk">
|
|
742
779
|
# <meta name="author" content="John Doe">
|
|
743
780
|
```
|