mirror of https://github.com/joshbuchea/HEAD.git
Merged
This commit is contained in:
commit
479e6295d9
21
LICENSE
21
LICENSE
|
@ -1,21 +0,0 @@
|
|||
The MIT License (MIT)
|
||||
|
||||
Copyright (c) 2016 Josh Buchea
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to deal
|
||||
in the Software without restriction, including without limitation the rights
|
||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||
copies of the Software, and to permit persons to whom the Software is
|
||||
furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in all
|
||||
copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||
SOFTWARE.
|
573
README.md
573
README.md
|
@ -1,121 +1,336 @@
|
|||
# HEAD
|
||||
|
||||
A collection of HTML head elements.
|
||||
A list of everything that could go in the `<head>` of your document
|
||||
|
||||
## Elements
|
||||
## Table of Contents
|
||||
|
||||
``` html
|
||||
<title>Page Title</title>
|
||||
<base href="https://example.com/page.html">
|
||||
<style>
|
||||
body { color: red; }
|
||||
</style>
|
||||
<script src="script.js"></script>
|
||||
```
|
||||
- [Recommended Minimum](#recommended-minimum)
|
||||
- [Elements](#elements)
|
||||
- [Meta](#meta)
|
||||
- [Meta: Not Recommended](#meta-not-recommended)
|
||||
- [Link](#link)
|
||||
- [Link: Not Recommended](#link-not-recommended)
|
||||
- [Favicons](#favicons)
|
||||
- [Social](#social)
|
||||
- [Facebook / Open Graph](#facebook--open-graph)
|
||||
- [Facebook / Instant Articles](#facebook--instant-articles)
|
||||
- [Twitter](#twitter)
|
||||
- [Google+ / Schema.org](#google--schemaorg)
|
||||
- [OEmbed](#oembed)
|
||||
- [Browsers / Platforms](#browsers--platforms)
|
||||
- [Apple iOS](#apple-ios)
|
||||
- [Apple Safari](#apple-safari)
|
||||
- [Google Android](#google-android)
|
||||
- [Google Chrome](#google-chrome)
|
||||
- [Microsoft Internet Explorer](#microsoft-internet-explorer)
|
||||
- [Microsoft Internet Explorer: Legacy, Do Not Use!](#microsoft-internet-explorer-legacy-do-not-use)
|
||||
- [Browsers (Chinese)](#browsers-chinese)
|
||||
- [360 Browser](#360-browser)
|
||||
- [QQ Mobile Browser](#qq-mobile-browser)
|
||||
- [UC Mobile Browser](#uc-mobile-browser)
|
||||
- [App Links](#app-links)
|
||||
- [Notes](#notes)
|
||||
- [Performance](#performance)
|
||||
- [Other Resources](#other-resources)
|
||||
- [Related Projects](#related-projects)
|
||||
- [Other Formats](#other-formats)
|
||||
- [Translations](#translations)
|
||||
- [Contributing](#contributing)
|
||||
- [Author](#author)
|
||||
- [License](#license)
|
||||
|
||||
## Meta Element
|
||||
## Recommended Minimum
|
||||
|
||||
``` html
|
||||
Below are the essential tags for basic, minimalist websites:
|
||||
|
||||
```html
|
||||
<meta charset="utf-8">
|
||||
<meta http-equiv="x-ua-compatible" content="ie=edge">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<!-- The above 3 meta tags *must* come first in the head; any other head content must come *after* these tags -->
|
||||
<meta name="keywords" content="your,keywords,here,comma,separated,no,spaces">
|
||||
<meta name="description" content="150 chars">
|
||||
<meta name="subject" content="your website's subject">
|
||||
<meta name="language" content="en">
|
||||
<meta name="robots" content="index,follow">
|
||||
<meta name="googlebot" content="index,follow">
|
||||
<title>Page Title</title>
|
||||
```
|
||||
|
||||
## Elements
|
||||
|
||||
``` html
|
||||
<!-- Document Title -->
|
||||
<title>Page Title</title>
|
||||
|
||||
<!-- Base URL to use for all relative URLs contained within the document -->
|
||||
<base href="https://example.com/page.html">
|
||||
|
||||
<!-- External CSS -->
|
||||
<link rel="stylesheet" href="styles.css">
|
||||
|
||||
<!-- In-document CSS -->
|
||||
<style>
|
||||
/* ... */
|
||||
</style>
|
||||
|
||||
<!-- JavaScript -->
|
||||
<script src="script.js"></script>
|
||||
<noscript><!--no JS alternative--></noscript>
|
||||
```
|
||||
|
||||
## Meta
|
||||
|
||||
``` html
|
||||
<meta charset="utf-8"> <!-- set character encoding for the document -->
|
||||
<meta http-equiv="x-ua-compatible" content="ie=edge">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
|
||||
<!-- The above 3 meta tags *must* come first in the head; any other head content must come *after* these tags -->
|
||||
|
||||
<!-- Allows control over where resources are loaded from -->
|
||||
<meta http-equiv="Content-Security-Policy" content="default-src 'self'">
|
||||
<!-- Place as early in the document as possible -->
|
||||
<!-- Only applies to content below this tag -->
|
||||
|
||||
<!-- Name of web application (only should be used if the website is used as an app) -->
|
||||
<meta name="application-name" content="Application Name">
|
||||
|
||||
<!-- Short description of the page (limit to 150 characters) -->
|
||||
<!-- In *some* situations this description is used as a part of the snippet shown in the search results. -->
|
||||
<meta name="description" content="A description of the page">
|
||||
|
||||
<!-- Control the behavior of search engine crawling and indexing -->
|
||||
<meta name="robots" content="index,follow,noodp"><!-- All Search Engines -->
|
||||
<meta name="googlebot" content="index,follow"><!-- Google Specific -->
|
||||
|
||||
<!-- Tells Google not to show the sitelinks search box -->
|
||||
<meta name="google" content="nositelinkssearchbox">
|
||||
|
||||
<!-- Tells Google not to provide a translation for this page -->
|
||||
<meta name="google" content="notranslate">
|
||||
|
||||
<!-- Verify ownership for Google Search Console -->
|
||||
<meta name="google-site-verification" content="verification_token">
|
||||
|
||||
<!-- Verify ownership for Yandex -->
|
||||
<meta name="yandex-verification" content="verification_token">
|
||||
|
||||
<!-- Verify ownership for Bing -->
|
||||
<meta name="msvalidate.01" content="verification_token">
|
||||
|
||||
<!-- Verify ownership for Alexa -->
|
||||
<meta name="alexaVerifyID" content="verification_token">
|
||||
|
||||
<!-- Verify ownership for Pinterest -->
|
||||
<meta name="p:domain_verify" content="code from pinterest">
|
||||
|
||||
<!-- Verify ownership for Norton -->
|
||||
<meta name="norton-safeweb-site-verification" content="norton code">
|
||||
<meta name="revised" content="Sunday, July 18th, 2010, 5:15 pm">
|
||||
|
||||
<!-- Used to name software used to build the website (i.e. - WordPress, Dreamweaver) -->
|
||||
<meta name="generator" content="program">
|
||||
|
||||
<!-- Short description of your site's subject -->
|
||||
<meta name="subject" content="your website's subject">
|
||||
|
||||
<!-- Very short (10 words or less) description. Primarily for academic papers -->
|
||||
<meta name="abstract" content="">
|
||||
<meta name="topic" content="">
|
||||
<meta name="summary" content="">
|
||||
<meta name="classification" content="business">
|
||||
|
||||
<!-- Full domain name or web address -->
|
||||
<meta name="url" content="https://example.com/">
|
||||
|
||||
<meta name="directory" content="submission">
|
||||
|
||||
<!-- Gives a general age rating based on sites content -->
|
||||
<meta name="rating" content="General">
|
||||
|
||||
<!-- Allows control over how referrer information is passed -->
|
||||
<meta name="referrer" content="no-referrer">
|
||||
|
||||
<!-- Disable automatic detection and formatting of possible phone numbers -->
|
||||
<meta name="format-detection" content="telephone=no">
|
||||
|
||||
<!-- Completely opt out of DNS prefetching by setting to 'off' -->
|
||||
<meta http-equiv="x-dns-prefetch-control" content="off">
|
||||
|
||||
<!-- Stores cookie on the client web browser for client identification -->
|
||||
<meta http-equiv="set-cookie" content="name=value; expires=date; path=url">
|
||||
|
||||
<!-- Specifies the page to appear in a specific frame -->
|
||||
<meta http-equiv="Window-Target" content="_value">
|
||||
|
||||
<!-- Geo tags -->
|
||||
<meta name="ICBM" content="latitude, longitude">
|
||||
<meta name="geo.position" content="latitude;longitude">
|
||||
<meta name="geo.region" content="country[-state]"><!-- Country code (ISO 3166-1): mandatory, state code (ISO 3166-2): optional; eg. content="US" / content="US-NY" -->
|
||||
<meta name="geo.placename" content="city/town"><!-- eg. content="New York City" -->
|
||||
```
|
||||
|
||||
- [Meta tags that Google understands](https://support.google.com/webmasters/answer/79812?hl=en)
|
||||
- [WHATWG Wiki: MetaExtensions](https://wiki.whatwg.org/wiki/MetaExtensions)
|
||||
- [ICBM on Wikipedia](https://en.wikipedia.org/wiki/ICBM_address#Modern_use)
|
||||
- [Geotagging on Wikipedia](https://en.wikipedia.org/wiki/Geotagging#HTML_pages)
|
||||
|
||||
### Meta: Not Recommended
|
||||
Below are the meta attributes which are not recommended for use as they had low adoption rate, or have been deprecated:
|
||||
|
||||
```html
|
||||
<!-- Used to declare the document language, but not well supported. Better to use <html lang=""> -->
|
||||
<meta name="language" content="en">
|
||||
|
||||
<!-- Google disregards & Bing considers it an indicator of spam -->
|
||||
<meta name="keywords" content="your,keywords,here,comma,separated,no,spaces">
|
||||
<!-- No evidence of current use in any search engines -->
|
||||
<meta name="revised" content="Sunday, July 18th, 2010, 5:15 pm">
|
||||
|
||||
<!-- Provides an easy way for spam bots to harvest email addresses -->
|
||||
<meta name="reply-to" content="email@example.com">
|
||||
|
||||
<!-- Better to use <link rel="author"> or humans.txt file -->
|
||||
<meta name="author" content="name, email@example.com">
|
||||
<meta name="designer" content="">
|
||||
<meta name="reply-to" content="email@example.com">
|
||||
<meta name="owner" content="">
|
||||
<meta name="url" content="https://example.com/">
|
||||
<meta name="identifier-URL" content="https://example.com/">
|
||||
<meta name="directory" content="submission">
|
||||
<meta name="category" content="">
|
||||
<meta name="coverage" content="Worldwide">
|
||||
<meta name="distribution" content="Global">
|
||||
<meta name="rating" content="General">
|
||||
<meta name="referrer" content="never">
|
||||
|
||||
<!-- Tells search bots to revisit the page after a period. This is not supported because most Search Engines now use random intervals for re-crawling a webpage -->
|
||||
<meta name="revisit-after" content="7 days">
|
||||
<meta http-equiv="refresh" content="300;url=https://example.com/">
|
||||
<meta http-equiv="Content-Security-Policy" content="default-src 'self'">
|
||||
|
||||
<!-- Sends user to a new URL after a certain amount of time -->
|
||||
<!-- The W3C recommends that this tag not be used. Google recommends using a server-side 301 redirect instead. -->
|
||||
<meta http-equiv="refresh" content="300; url=https://example.com/">
|
||||
|
||||
<!-- Describes the topic of the website -->
|
||||
<meta name="topic" content="">
|
||||
|
||||
<!-- Brief summary of the company or purpose of the website -->
|
||||
<meta name="summary" content="">
|
||||
|
||||
<!-- A deprecated tag that does the same as the keywords meta tag -->
|
||||
<meta name="classification" content="business">
|
||||
|
||||
<!-- Does the same as URL, older and not supported -->
|
||||
<meta name="identifier-URL" content="https://example.com/">
|
||||
|
||||
<!-- Similar function to the keywords tag -->
|
||||
<meta name="category" content="">
|
||||
|
||||
<!-- Makes sure your website shows up in all countries and languages -->
|
||||
<meta name="coverage" content="Worldwide">
|
||||
|
||||
<!-- Does the same as the coverage tag -->
|
||||
<meta name="distribution" content="Global">
|
||||
|
||||
<!-- Controls what user can access on the internet -->
|
||||
<meta http-equiv="Pics-label" content="value">
|
||||
|
||||
<!-- Cache Control -->
|
||||
<!-- Better to configure cache control server side -->
|
||||
<meta http-equiv="Expires" content="0">
|
||||
<meta http-equiv="Pragma" content="no-cache">
|
||||
<meta http-equiv="Cache-Control" content="no-cache">
|
||||
```
|
||||
|
||||
## Link Element
|
||||
## Link
|
||||
|
||||
``` html
|
||||
<link rel="copyright" href="copyright.html">
|
||||
<!-- Helps prevent duplicate content issues -->
|
||||
<link rel="canonical" href="https://example.com/2010/06/9-things-to-do-before-entering-social-media.html">
|
||||
|
||||
<!-- Used to be included before the icon link, but is deprecated and no longer is used -->
|
||||
<link rel="shortlink" href="https://example.com/?p=42">
|
||||
|
||||
<!-- Links to an AMP HTML version of the current document -->
|
||||
<link rel="amphtml" href="https://example.com/path/to/amp-version.html">
|
||||
|
||||
<!-- Points to a CSS stylesheet -->
|
||||
<link rel="stylesheet" href="https://example.com/styles.css">
|
||||
<link rel="alternate" href="https://feeds.feedburner.com/martini" type="application/rss+xml" title="RSS">
|
||||
<link rel="alternate" href="https://example.com/feed.atom" type="application/atom+xml" title="Atom 0.3">
|
||||
|
||||
<!-- Links to a JSON file that specifies "installation" credentials for web applications -->
|
||||
<link rel="manifest" href="manifest.json">
|
||||
|
||||
<!-- Links to the author of the document -->
|
||||
<link rel="author" href="humans.txt">
|
||||
|
||||
<!-- Refers to a copyright statement that applies to the links context -->
|
||||
<link rel="copyright" href="copyright.html">
|
||||
|
||||
<!-- Gives a reference to a location in your document that may be in another language -->
|
||||
<link rel="alternate" href="https://es.example.com/" hreflang="es">
|
||||
|
||||
<!-- Gives information about an author or another person -->
|
||||
<link rel="me" href="https://google.com/profiles/thenextweb" type="text/html">
|
||||
<link rel="me" href="mailto:name@example.com">
|
||||
<link rel="me" href="sms:+15035550125">
|
||||
|
||||
<!-- Links to a document that contains an archive link to the current document -->
|
||||
<link rel="archives" href="https://example.com/2003/05/" title="May 2003">
|
||||
|
||||
<!-- Links to top level resource in an hierarchical structure -->
|
||||
<link rel="index" href="https://example.com/" title="DeWitt Clinton">
|
||||
|
||||
<!-- Gives the starting point of the document -->
|
||||
<link rel="start" href="https://example.com/photos/pattern_recognition_1_about/" title="Pattern Recognition 1">
|
||||
|
||||
<!-- Leads to the preceding resource of the sequence the current document is in -->
|
||||
<link rel="prev" href="https://example.com/opensearch/opensearch-and-openid-a-sure-way-to-get-my-attention/" title="OpenSearch and OpenID? A sure way to get my attention.">
|
||||
<link rel="search" href="/open-search.xml" type="application/opensearchdescription+xml" title="Search Title">
|
||||
|
||||
<!-- Gives a self reference - useful when the document has multiple possible references -->
|
||||
<link rel="self" type="application/atom+xml" href="https://example.com/atomFeed.php?page=3">
|
||||
|
||||
<!-- The first, next, previous, and last documents in a series of documents, respectively -->
|
||||
<link rel="first" href="https://example.com/atomFeed.php">
|
||||
<link rel="next" href="https://example.com/atomFeed.php?page=4">
|
||||
<link rel="previous" href="https://example.com/atomFeed.php?page=2">
|
||||
<link rel="last" href="https://example.com/atomFeed.php?page=147">
|
||||
<link rel="shortlink" href="https://example.com/?p=43625">
|
||||
<link rel="canonical" href="https://example.com/2010/06/9-things-to-do-before-entering-social-media.html">
|
||||
<link rel="amphtml" href="https://www.example.com/url/to/amp-version.html">
|
||||
|
||||
<!-- Used when using a 3rd party service to maintain a blog -->
|
||||
<link rel="EditURI" href="https://example.com/xmlrpc.php?rsd" type="application/rsd+xml" title="RSD">
|
||||
|
||||
<!-- Forms an automated comment when another WordPress blog links to your WordPress blog or post -->
|
||||
<link rel="pingback" href="https://example.com/xmlrpc.php">
|
||||
|
||||
<!-- Notifies a url when you link to it on your site -->
|
||||
<link rel="webmention" href="https://example.com/webmention">
|
||||
<link rel="manifest" href="manifest.json">
|
||||
<link rel="author" href="humans.txt">
|
||||
|
||||
<!-- Loads in an external HTML file into the current HTML file -->
|
||||
<link rel="import" href="component.html">
|
||||
|
||||
<!-- Open Search -->
|
||||
<link rel="search" href="/open-search.xml" type="application/opensearchdescription+xml" title="Search Title">
|
||||
|
||||
<!-- Feeds -->
|
||||
<link rel="alternate" href="https://feeds.feedburner.com/example" type="application/rss+xml" title="RSS">
|
||||
<link rel="alternate" href="https://example.com/feed.atom" type="application/atom+xml" title="Atom 0.3">
|
||||
|
||||
<!-- Prefetching, preloading, prebrowsing -->
|
||||
<link rel="dns-prefetch" href="//example.com/">
|
||||
<link rel="preconnect" href="https://www.example.com/">
|
||||
<link rel="prefetch" href="https://www.example.com/">
|
||||
<link rel="prerender" href="https://example.com/">
|
||||
<link rel="subresource" href="styles.css">
|
||||
<link rel="preload" href="image.png">
|
||||
<link rel="preload" href="image.png" as="image">
|
||||
<!-- More info: https://css-tricks.com/prefetching-preloading-prebrowsing/ -->
|
||||
```
|
||||
|
||||
### Link: Not Recommended
|
||||
Below are the link relations which are not recommended for use:
|
||||
|
||||
```html
|
||||
<link rel="shortcut icon" href="path/to/favicon.ico">
|
||||
|
||||
<!-- Not useful, proprietary and buggy, see https://groups.google.com/a/chromium.org/forum/#!msg/blink-dev/Y_2eFRh9BOs/gULYapoRBwAJ -->
|
||||
<link rel="subresource" href="styles.css">
|
||||
```
|
||||
|
||||
### Favicons
|
||||
|
||||
``` html
|
||||
<!-- For IE 10 and below -->
|
||||
<!-- For IE 10 and below -->
|
||||
<!-- No link, just place a file called favicon.ico in the root directory -->
|
||||
|
||||
<!-- For IE 11, Chrome, Firefox, Safari, Opera -->
|
||||
<!-- For IE 11, Chrome, Firefox, Safari, Opera -->
|
||||
<link rel="icon" href="path/to/favicon-16.png" sizes="16x16" type="image/png">
|
||||
<link rel="icon" href="path/to/favicon-32.png" sizes="32x32" type="image/png">
|
||||
<link rel="icon" href="path/to/favicon-48.png" sizes="48x48" type="image/png">
|
||||
<link rel="icon" href="path/to/favicon-62.png" sizes="62x62" type="image/png">
|
||||
<link rel="icon" href="path/to/favicon-192.png" sizes="192x192" type="image/png">
|
||||
<!-- More info: https://bitsofco.de/all-about-favicons-and-touch-icons/ -->
|
||||
```
|
||||
|
||||
- [All About Favicons (And Touch Icons)](https://bitsofco.de/all-about-favicons-and-touch-icons/)
|
||||
- [Favicon Cheat Sheet](https://github.com/audreyr/favicon-cheat-sheet)
|
||||
|
||||
## Social
|
||||
|
||||
|
@ -138,6 +353,22 @@ A collection of HTML head elements.
|
|||
- [Facebook Open Graph Markup](https://developers.facebook.com/docs/sharing/webmasters#markup)
|
||||
- [Open Graph protocol](http://ogp.me/)
|
||||
|
||||
### Facebook / Instant Articles
|
||||
|
||||
``` html
|
||||
<meta charset="utf-8">
|
||||
<meta property="op:markup_version" content="v1.0">
|
||||
|
||||
<!-- The URL of the web version of your article -->
|
||||
<link rel="canonical" href="http://example.com/article.html">
|
||||
|
||||
<!-- The style to be used for this article -->
|
||||
<meta property="fb:article_style" content="myarticlestyle">
|
||||
```
|
||||
|
||||
- [Facebook Instant Articles: Creating Articles](https://developers.facebook.com/docs/instant-articles/guides/articlecreate)
|
||||
- [Instant Articles: Format Reference](https://developers.facebook.com/docs/instant-articles/reference)
|
||||
|
||||
### Twitter
|
||||
|
||||
``` html
|
||||
|
@ -153,18 +384,39 @@ A collection of HTML head elements.
|
|||
```
|
||||
|
||||
- [Twitter Cards: Getting Started Guide](https://dev.twitter.com/cards/getting-started)
|
||||
- [Twitter Card Validator](https://dev.twitter.com/docs/cards/validation/validator)
|
||||
- [Twitter Card Validator](https://cards-dev.twitter.com/validator)
|
||||
|
||||
### Google+ / Schema.org
|
||||
|
||||
``` html
|
||||
<link href="https://plus.google.com/+YourPage" rel="publisher">
|
||||
<meta itemprop="name" content="Content Title">
|
||||
<meta itemprop="description" content="Content description less than 200 characters">
|
||||
<meta itemprop="image" content="https://example.com/image.jpg">
|
||||
```
|
||||
|
||||
## Browser/Platform
|
||||
### Pinterest
|
||||
|
||||
Pinterest lets you prevent people from saving things from your website, according [to their help center](https://help.pinterest.com/en/articles/prevent-people-saving-things-pinterest-your-site). The `description` is optional.
|
||||
|
||||
``` html
|
||||
<meta name="pinterest" content="nopin" description="Sorry, you can't save from my website!">
|
||||
```
|
||||
|
||||
### OEmbed
|
||||
|
||||
``` html
|
||||
<link rel="alternate" type="application/json+oembed"
|
||||
href="http://example.com/services/oembed?url=http%3A%2F%2Fexample.com%2Ffoo%2F&format=json"
|
||||
title="oEmbed Profile: JSON">
|
||||
<link rel="alternate" type="text/xml+oembed"
|
||||
href="http://example.com/services/oembed?url=http%3A%2F%2Fexample.com%2Ffoo%2F&format=xml"
|
||||
title="oEmbed Profile: XML">
|
||||
```
|
||||
|
||||
- [oEmbed format](http://oembed.com/)
|
||||
|
||||
## Browsers / Platforms
|
||||
|
||||
### Apple iOS
|
||||
|
||||
|
@ -181,15 +433,24 @@ A collection of HTML head elements.
|
|||
<meta name="apple-mobile-web-app-title" content="App Title">
|
||||
|
||||
<!-- Touch Icons -->
|
||||
<link rel="apple-touch-icon" href="apple-touch-icon.png">
|
||||
<link rel="apple-touch-icon-precomposed" href="apple-touch-icon-precomposed.png">
|
||||
<link rel="apple-touch-icon" href="path/to/apple-touch-icon.png">
|
||||
<link rel="apple-touch-icon-precomposed" href="path/to/apple-touch-icon-precomposed.png">
|
||||
<!-- iOS 8+ no longer support precomposed, only apple-touch-icon is required -->
|
||||
|
||||
<!-- In most cases, one 180×180px touch icon in the head is enough -->
|
||||
<!-- If you use art-direction and/or want to have different content for each device, you can add more touch icons -->
|
||||
<!-- Utilize the different icon sizes if you would want unique icons -->
|
||||
<!-- determined by device. -->
|
||||
<link rel="apple-touch-icon" sizes="57x57" href="path/to/icon@57.png">
|
||||
<link rel="apple-touch-icon" sizes="72x72" href="path/to/icon@72.png">
|
||||
<link rel="apple-touch-icon" sizes="114x114" href="path/to/icon@114.png">
|
||||
<link rel="apple-touch-icon" sizes="144x144" href="path/to/icon@144.png">
|
||||
|
||||
<!-- Startup Image -->
|
||||
<link rel="apple-touch-startup-image" href="startup.png">
|
||||
<!-- Startup Image ( Deprecated ) -->
|
||||
<link rel="apple-touch-startup-image" href="path/to/startup.png">
|
||||
|
||||
<!-- More info: https://developer.apple.com/safari/library/documentation/appleapplications/reference/safarihtmlref/articles/metatags.html -->
|
||||
<!-- iOS app deep linking -->
|
||||
<meta name="apple-itunes-app" content="app-id=APP-ID, app-argument=http/url-sample.com">
|
||||
<link rel="alternate" href="ios-app://APP-ID/http/url-sample.com">
|
||||
```
|
||||
|
||||
- [Apple Meta Tags](https://developer.apple.com/library/safari/documentation/AppleApplications/Reference/SafariHTMLRef/Articles/MetaTags.html)
|
||||
|
@ -198,7 +459,7 @@ A collection of HTML head elements.
|
|||
|
||||
```html
|
||||
<!-- Pinned Site -->
|
||||
<link rel="mask-icon" href="icon.svg" color="red">
|
||||
<link rel="mask-icon" href="path/to/icon.svg" color="red">
|
||||
```
|
||||
|
||||
### Google Android
|
||||
|
@ -206,9 +467,13 @@ A collection of HTML head elements.
|
|||
``` html
|
||||
<meta name="theme-color" content="#E64545">
|
||||
|
||||
<!-- Add to homescreen -->
|
||||
<!-- Add to home screen -->
|
||||
<meta name="mobile-web-app-capable" content="yes">
|
||||
<!-- More info: https://developer.chrome.com/multidevice/android/installtohomescreen -->
|
||||
|
||||
<!-- Android app deep linking -->
|
||||
<meta name="google-play-app" content="app-id=package-name">
|
||||
<link rel="alternate" href="android-app://package-name/http/url-sample.com">
|
||||
```
|
||||
|
||||
### Google Chrome
|
||||
|
@ -219,6 +484,27 @@ A collection of HTML head elements.
|
|||
<!-- Disable translation prompt -->
|
||||
<meta name="google" value="notranslate">
|
||||
```
|
||||
### Google Chrome Mobile (Android Only)
|
||||
|
||||
Since Chrome 31, you can set up your web app to "app mode" like Safari.
|
||||
|
||||
``` html
|
||||
<!-- Link to a manifest and define the manifest metadata. -->
|
||||
<!-- The example of manifest.json could be found in the link below. -->
|
||||
<link rel="manifest" href="manifest.json">
|
||||
|
||||
<!-- Define your web page as a web app -->
|
||||
<meta name="mobile-web-app-capable" content="yes">
|
||||
|
||||
<!-- The first one is the official recommended format. -->
|
||||
<link rel="icon" sizes="192x192" href="nice-highres.png">
|
||||
<link rel="icon" sizes="128x128" href="niceicon.png">
|
||||
<!-- Formats with Apple prefix will be deprecated. -->
|
||||
<link rel="apple-touch-icon" sizes="128x128" href="niceicon.png">
|
||||
<link rel="apple-touch-icon-precomposed" sizes="128x128" href="niceicon.png">
|
||||
```
|
||||
|
||||
[Google Developer](https://developer.chrome.com/multidevice/android/installtohomescreen)
|
||||
|
||||
### Microsoft Internet Explorer
|
||||
|
||||
|
@ -227,60 +513,49 @@ A collection of HTML head elements.
|
|||
<meta http-equiv="cleartype" content="on">
|
||||
<meta name="skype_toolbar" content="skype_toolbar_parser_compatible">
|
||||
|
||||
<!-- Pinned Site -->
|
||||
<!-- IE 10 / Windows 8 -->
|
||||
<meta name="msapplication-TileImage" content="pinned-tile-144.png">
|
||||
<meta name="msapplication-TileColor" content="#009900">
|
||||
<!-- IE 11 / Windows 9.1 -->
|
||||
<meta name="msapplication-config" content="ieconfig.xml">
|
||||
<!-- Disable link highlighting on IE 10 on Windows Phone (https://blogs.windows.com/buildingapps/2012/11/15/adapting-your-webkit-optimized-site-for-internet-explorer-10/) -->
|
||||
<meta name="msapplication-tap-highlight" content="no">
|
||||
|
||||
<!-- Pinned sites (https://msdn.microsoft.com/en-us/library/dn255024(v=vs.85).aspx) -->
|
||||
<meta name="application-name" content="Contoso Pinned Site Caption">
|
||||
<meta name="msapplication-tooltip" content="Example Tooltip Text">
|
||||
<meta name="msapplication-starturl" content="/">
|
||||
|
||||
<meta name="msapplication-config" content="http://example.com/browserconfig.xml">
|
||||
|
||||
<meta name="msapplication-allowDomainApiCalls" content="true">
|
||||
<meta name="msapplication-allowDomainMetaTags" content="true">
|
||||
<meta name="msapplication-badge" content="frequency=30; polling-uri=http://example.com/id45453245/polling.xml">
|
||||
<meta name="msapplication-navbutton-color" content="#FF3300">
|
||||
<meta name="msapplication-notification" content="frequency=60;polling-uri=http://example.com/livetile">
|
||||
<meta name="msapplication-square150x150logo" content="path/to/logo.png">
|
||||
<meta name="msapplication-square310x310logo" content="path/to/largelogo.png">
|
||||
<meta name="msapplication-square70x70logo" content="path/to/tinylogo.png">
|
||||
<meta name="msapplication-wide310x150logo" content="path/to/widelogo.png">
|
||||
<meta name="msapplication-task" content="name=Check Order Status;action-uri=./orderStatus.aspx?src=IE9;icon-uri=./favicon.ico">
|
||||
<meta name="msapplication-task-separator" content="1">
|
||||
<meta name="msapplication-TileColor" content="#FF3300">
|
||||
<meta name="msapplication-TileImage" content="path/to/tileimage.jpg">
|
||||
<meta name="msapplication-window" content="width=1024;height=768">
|
||||
```
|
||||
|
||||
### Microsoft Internet Explorer (LEGACY DO NOT USE)
|
||||
### Microsoft Internet Explorer: Legacy, Do Not Use!
|
||||
|
||||
``` html
|
||||
<!-- Legacy Tags (DO NOT USE) -->
|
||||
<meta name="mssmarttagspreventparsing" content="true">
|
||||
<meta http-equiv="page-enter" content="revealtrans(duration=2,transition=2)">
|
||||
<meta http-equiv="page-exit" content="revealtrans(duration=3,transition=12)">
|
||||
```
|
||||
<!-- Disable the image toolbar when you mouse over images in IE 6 (https://msdn.microsoft.com/en-us/library/ms532986(v=vs.85).aspx) -->
|
||||
<meta http-equiv="imagetoolbar" content="no">
|
||||
|
||||
### 360 Browser
|
||||
<!-- Disable Windows theming to form inputs/buttons (https://support.microsoft.com/en-us/kb/322240) -->
|
||||
<meta name="MSThemeCompatible" content="no">
|
||||
|
||||
``` html
|
||||
<!-- select rendering engine in order -->
|
||||
<meta name="renderer" content="webkit|ie-comp|ie-stand">
|
||||
```
|
||||
<!-- Disable a feature that only appeared on IE 6 beta (https://stackoverflow.com/q/2167301) -->
|
||||
<meta name="MSSmartTagsPreventParsing" content="true">
|
||||
|
||||
### UC Mobile Browser
|
||||
|
||||
``` html
|
||||
<!-- Locks the screen into the specified orientation -->
|
||||
<meta name="screen-orientation" content="landscape/portrait">
|
||||
<!-- Display this page in fullscreen -->
|
||||
<meta name="full-screen" content="yes">
|
||||
<!-- UC browser will display images even if in "text mode" -->
|
||||
<meta name="imagemode" content="force">
|
||||
<!-- Page will be displayed in "application mode"(fullsreen,forbiding gesture, etc.) -->
|
||||
<meta name="browsermode" content="application">
|
||||
<!-- Disabled the UC browser's "night mode" in this page -->
|
||||
<meta name="nightmode" content="disable">
|
||||
<!-- Simplify the page to reduce data transfer -->
|
||||
<meta name="layoutmode" content="fitscreen">
|
||||
<!-- Disable the UC browser's feature of "scaling font up when there are many words in this page" -->
|
||||
<meta name="wap-font-scale" content="no">
|
||||
```
|
||||
|
||||
- [UC Browser Docs](http://www.uc.cn/download/UCBrowser_U3_API.doc)
|
||||
|
||||
### QQ Mobile Browser
|
||||
|
||||
``` html
|
||||
<!-- Locks the screen into the specified orientation -->
|
||||
<meta name="x5-orientation" content="landscape/portrait">
|
||||
<!-- Display this page in fullscreen -->
|
||||
<meta name="x5-fullscreen" content="true">
|
||||
<!-- Page will be displayed in "application mode"(fullsreen,etc.) -->
|
||||
<meta name="x5-page-mode" content="app">
|
||||
<!-- Interpage Transitions (https://msdn.microsoft.com/en-us/library/ms532847(v=vs.85).aspx) -->
|
||||
<meta http-equiv="Page-Enter" content="revealtrans(duration=2,transition=2)">
|
||||
<meta http-equiv="Page-Exit" content="revealtrans(duration=3,transition=12)">
|
||||
<meta http-equiv="Site-Enter" content="revealtrans(duration=2,transition=2)">
|
||||
<meta http-equiv="Site-Exit" content="revealtrans(duration=3,transition=12)">
|
||||
```
|
||||
|
||||
## App Links
|
||||
|
@ -301,21 +576,103 @@ A collection of HTML head elements.
|
|||
|
||||
- [App Links Docs](http://applinks.org/documentation/)
|
||||
|
||||
## Browsers (Chinese)
|
||||
|
||||
### 360 Browser
|
||||
|
||||
``` html
|
||||
<!-- select rendering engine in order -->
|
||||
<meta name="renderer" content="webkit|ie-comp|ie-stand">
|
||||
```
|
||||
|
||||
### QQ Mobile Browser
|
||||
|
||||
``` html
|
||||
<!-- Locks the screen into the specified orientation -->
|
||||
<meta name="x5-orientation" content="landscape/portrait">
|
||||
<!-- Display this page in fullscreen -->
|
||||
<meta name="x5-fullscreen" content="true">
|
||||
<!-- Page will be displayed in "application mode"(fullscreen,etc.) -->
|
||||
<meta name="x5-page-mode" content="app">
|
||||
```
|
||||
|
||||
### UC Mobile Browser
|
||||
|
||||
``` html
|
||||
<!-- Locks the screen into the specified orientation -->
|
||||
<meta name="screen-orientation" content="landscape/portrait">
|
||||
<!-- Display this page in fullscreen -->
|
||||
<meta name="full-screen" content="yes">
|
||||
<!-- UC browser will display images even if in "text mode" -->
|
||||
<meta name="imagemode" content="force">
|
||||
<!-- Page will be displayed in "application mode"(fullscreen,forbiding gesture, etc.) -->
|
||||
<meta name="browsermode" content="application">
|
||||
<!-- Disabled the UC browser's "night mode" in this page -->
|
||||
<meta name="nightmode" content="disable">
|
||||
<!-- Simplify the page to reduce data transfer -->
|
||||
<meta name="layoutmode" content="fitscreen">
|
||||
<!-- Disable the UC browser's feature of "scaling font up when there are many words in this page" -->
|
||||
<meta name="wap-font-scale" content="no">
|
||||
```
|
||||
|
||||
- [UC Browser Docs](http://www.uc.cn/download/UCBrowser_U3_API.doc)
|
||||
|
||||
## Notes
|
||||
|
||||
### Performance
|
||||
Moving the `href` attribute to the beginning of an element improves compression when GZIP is enabled, because the `href` attribute is used in `a`, `base` and `link` tags.
|
||||
|
||||
Example:
|
||||
|
||||
``` html
|
||||
<link href="https://fonts.googleapis.com/css?family=Open+Sans:400,700" rel="stylesheet">
|
||||
```
|
||||
|
||||
## Other Resources
|
||||
|
||||
- [HTML5 Boilerplate Docs: The HTML](https://github.com/h5bp/html5-boilerplate/blob/master/dist/doc/html.md)
|
||||
- [HTML5 Boilerplate Docs: Extend and customize](https://github.com/h5bp/html5-boilerplate/blob/master/dist/doc/extend.md)
|
||||
|
||||
## Related Projects
|
||||
|
||||
- [Atom HTML Head Snippets](https://github.com/joshbuchea/atom-html-head-snippets) - Atom package for `HEAD` snippets
|
||||
- [Sublime Text HTML Head Snippets](https://github.com/marcobiedermann/sublime-head-snippets) - Sublime Text package for `HEAD` snippets
|
||||
- [head-it](https://github.com/hemanth/head-it) - CLI interface for `HEAD` snippets
|
||||
- [vue-head](https://github.com/ktquez/vue-head) - Manipulating the meta information of the `HEAD` tag for Vue.js
|
||||
|
||||
## Other Formats
|
||||
|
||||
- [PDF](https://gitprint.com/joshbuchea/HEAD/blob/master/README.md)
|
||||
|
||||
## Translations
|
||||
|
||||
- [Brazilian Portuguese](https://github.com/Webschool-io/HEAD)
|
||||
- [Chinese (Simplified)](https://github.com/Amery2010/HEAD)
|
||||
- [Italian](https://github.com/Fakkio/HEAD)
|
||||
- [Japanese](http://coliss.com/articles/build-websites/operation/work/collection-of-html-head-elements.html)
|
||||
- [Russian/Русский](https://github.com/Konfuze/HEAD)
|
||||
|
||||
## Contributing
|
||||
|
||||
Open an issue or a pull request to suggest changes or additions.
|
||||
|
||||
Please follow these steps for pull requests:
|
||||
|
||||
- Modify only one tag, or one related set of tags at a time
|
||||
- Use double quotes on attributes
|
||||
- Don't include a trailing slash in self-closing elements — the HTML5 spec says they're optional
|
||||
- Consider including a link to documentation that supports your change
|
||||
|
||||
### Contributors
|
||||
|
||||
Check out all the super awesome [contributors](https://github.com/joshbuchea/HEAD/graphs/contributors).
|
||||
|
||||
## Author
|
||||
|
||||
**Josh Buchea**
|
||||
- <https://github.com/joshbuchea>
|
||||
- <https://twitter.com/joshbuchea>
|
||||
**[Josh Buchea](http://joshbuchea.com/)**
|
||||
|
||||
## License
|
||||
|
||||
[MIT License](LICENSE)
|
||||
[![CC0](http://i.creativecommons.org/p/zero/1.0/88x31.png)](http://creativecommons.org/publicdomain/zero/1.0/)
|
||||
|
||||
To the extent possible under law, [Josh Buchea](http://joshbuchea.com) has waived all copyright and related or neighboring rights to this work.
|
||||
|
|
Loading…
Reference in New Issue