├── LICENSE
└── README.md


/LICENSE:
--------------------------------------------------------------------------------
 1 | The MIT License (MIT)
 2 | 
 3 | Copyright (c) 2016 Josh Buchea
 4 | 
 5 | Permission is hereby granted, free of charge, to any person obtaining a copy
 6 | of this software and associated documentation files (the "Software"), to deal
 7 | in the Software without restriction, including without limitation the rights
 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 | 
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 | 
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
  1 | # HEAD
  2 | 
  3 | A collection of HTML head elements.
  4 | 
  5 | ## Elements
  6 | 
  7 | ``` html
  8 | <title>Page Title</title>
  9 | <base href="https://example.com/page.html">
 10 | <style>
 11 |   body { color: red; }
 12 | </style>
 13 | <script src="script.js"></script>
 14 | ```
 15 | 
 16 | ## Meta Element
 17 | 
 18 | > 标签提供关于HTML文档的元数据。元数据不会显示在页面上，但是对于机器是可读的。它可用于浏览器（如何显示内容或重新加载页面），搜索引擎（关键词），或其他 web 服务。 —— W3School
 19 | 
 20 | ``` html
 21 | <!-- content-Type(设定网页字符集) -->
 22 | <meta http-equiv="content-Type" content="text/html;charset=utf-8">  <!-- 旧的HTML，不推荐 -->
 23 | <meta charset="utf-8">
 24 | <!-- 优先使用 IE 最新版本和 Chrome -->
 25 | <meta http-equiv="x-ua-compatible" content="ie=edge">
 26 | <!--
 27 |     浏览器内核控制：国内浏览器很多都是双内核（webkit和Trident），
 28 |     webkit内核高速浏览，IE内核兼容网页和旧版网站。
 29 |     而添加meta标签的网站可以控制浏览器选择何种内核渲染。
 30 | -->
 31 | <meta name="renderer" content="webkit|ie-comp|ie-stand">
 32 | <!--
 33 |     viewport：能优化移动浏览器的显示。如果不是响应式网站，不要使用initial-scale或者禁用缩放。
 34 |     width：宽度（数值 / device-width）（范围从200 到10,000，默认为980 像素）
 35 |     height：高度（数值 / device-height）（范围从223 到10,000）
 36 |     initial-scale：初始的缩放比例 （范围从>0 到10）
 37 |     minimum-scale：允许用户缩放到的最小比例
 38 |     maximum-scale：允许用户缩放到的最大比例
 39 |     user-scalable：用户是否可以手动缩 (no,yes)
 40 |     minimal-ui：可以在页面加载时最小化上下状态栏。（已弃用）
 41 |     注意，很多人使用initial-scale=1到非响应式网站上，这会让网站以100%宽度渲染，
 42 |     用户需要手动移动页面或者缩放。如果和initial-scale=1同时使用user-scalable=no或maximum-scale=1，
 43 |     则用户将不能放大/缩小网页来看到全部的内容。
 44 |  -->
 45 | <meta name="viewport" content="width=device-width, initial-scale=1">
 46 | 
 47 | <!--
 48 |     页面关键词，每个网页应具有描述该网页内容的一组唯一的关键字。
 49 |     使用人们可能会搜索，并准确描述网页上所提供信息的描述性和代表性关键字及短语。
 50 |     标记内容太短，则搜索引擎可能不会认为这些内容相关。另外标记不应超过 874 个字符。
 51 |  -->
 52 | <meta name="keywords" content="your,keywords,here,comma,separated,no,spaces">
 53 | <!-- 页面描述，每个网页都应有一个不超过 150 个字符且能准确反映网页内容的描述标签 -->
 54 | <meta name="description" content="150 chars">
 55 | <meta name="subject" content="your website's subject">
 56 | <meta name="language" content="en">
 57 | 
 58 | <!--
 59 |     搜索引擎
 60 |     all：文件将被检索，且页面上的链接可以被查询；
 61 |     none：文件将不被检索，且页面上的链接不可以被查询；
 62 |     index：文件将被检索；
 63 |     follow：页面上的链接可以被查询；
 64 |     noindex：文件将不被检索；
 65 |     nofollow：页面上的链接不可以被查询。
 66 |  -->
 67 | <meta name="robots" content="index,follow">
 68 | <meta name="googlebot" content="index,follow">
 69 | <meta name="google" content="nositelinkssearchbox">
 70 | <meta name="google-site-verification" content="verification_token">
 71 | <meta name="revised" content="Sunday, July 18th, 2010, 5:15 pm">
 72 | <meta name="abstract" content="">
 73 | <meta name="topic" content="">
 74 | <meta name="summary" content="">
 75 | <meta name="classification" content="business">
 76 | <meta name="author" content="name, email@example.com">
 77 | <meta name="designer" content="">
 78 | <meta name="reply-to" content="email@example.com">
 79 | <meta name="owner" content="">
 80 | <meta name="url" content="https://example.com/">
 81 | <meta name="identifier-URL" content="https://example.com/">
 82 | <meta name="directory" content="submission">
 83 | <meta name="category" content="">
 84 | <meta name="coverage" content="Worldwide">
 85 | <meta name="distribution" content="Global">
 86 | <meta name="rating" content="General">
 87 | <meta name="referrer" content="never">
 88 | <meta name="revisit-after" content="7 days">
 89 | <!--
 90 |     页面重定向和刷新：content内的数字代表时间（秒），既多少时间后刷新。如果加url,则会重定向到指定网页（搜索引擎能够自动检测，也很容易被引擎视作误导而受到惩罚）。
 91 |  -->
 92 | <meta http-equiv="refresh" content="300;url=https://example.com/">
 93 | <meta http-equiv="refresh" content="url=https://example.com/">
 94 | 
 95 | <!--
 96 |     Cache Control: 指定请求和响应遵循的缓存机制, 指导浏览器如何缓存某个响应以及缓存多长时间.
 97 |     no-cache: 先发送请求，与服务器确认该资源是否被更改，如果未被更改，则使用缓存。
 98 |     no-store: 不允许缓存，每次都要去服务器上，下载完整的响应。（安全措施）
 99 |     public: 缓存所有响应，但并非必须。因为max-age也可以做到相同效果
100 |     private: 只为单个用户缓存，因此不允许任何中继进行缓存。（比如说CDN就不允许缓存private的响应）
101 |     maxage: 表示当前请求开始，该响应在多久内能被缓存和重用，而不去服务器重新请求。
102 |             例如：max-age=60表示响应可以再缓存和重用 60 秒。
103 | 
104 |  -->
105 | <meta http-equiv="Pragma" content="no-cache">
106 | <meta http-equiv="Cache-Control" content="no-cache">
107 | <!-- 转码申明：用百度打开网页可能会对其进行转码（比如贴广告），避免转码可添加如下meta -->
108 | <meta http-equiv="Cache-Control" content="no-siteapp" />
109 | <!-- expires(网页到期时间):用于设定网页的到期时间，过期后网页必须到服务器上重新传输。 -->
110 | <meta http-equiv="Expires" content="0">
111 | <meta http-equiv="Expires" content="Sunday 26 October 2016 01:00 GMT" />
112 | ```
113 | 
114 | ## 移动设备相关
115 | ```html
116 | <!-- 针对手持设备优化，主要是针对一些老的不识别viewport的浏览器，比如黑莓 -->
117 | <meta name="HandheldFriendly" content="true">
118 | <!-- 微软的老式浏览器 -->
119 | <meta name="MobileOptimized" content="320">
120 | <!-- uc强制竖屏 -->
121 | <meta name="screen-orientation" content="portrait">
122 | <!-- QQ强制竖屏 -->
123 | <meta name="x5-orientation" content="portrait">
124 | <!-- UC强制全屏 -->
125 | <meta name="full-screen" content="yes">
126 | <!-- QQ强制全屏 -->
127 | <meta name="x5-fullscreen" content="true">
128 | <!-- UC应用模式 -->
129 | <meta name="browsermode" content="application">
130 | <!-- QQ应用模式 -->
131 | <meta name="x5-page-mode" content="app">
132 | <!-- windows phone 点击无高光 -->
133 | <meta name="msapplication-tap-highlight" content="no">
134 | ```
135 | 
136 | ## Link Element
137 | 
138 | ``` html
139 | <link rel="copyright" href="copyright.html">
140 | <link rel="stylesheet" href="https://example.com/styles.css">
141 | <link rel="alternate" href="https://feeds.feedburner.com/martini" type="application/rss+xml" title="RSS">
142 | <link rel="alternate" href="https://example.com/feed.atom" type="application/atom+xml" title="Atom 0.3">
143 | <link rel="alternate" href="https://es.example.com/" hreflang="es">
144 | <link rel="me" href="https://google.com/profiles/thenextweb" type="text/html">
145 | <link rel="archives" href="https://example.com/2003/05/" title="May 2003">
146 | <link rel="index" href="https://example.com/" title="DeWitt Clinton">
147 | <link rel="start" href="https://example.com/photos/pattern_recognition_1_about/" title="Pattern Recognition 1">
148 | <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.">
149 | <link rel="search" href="/search.xml" type="application/opensearchdescription+xml" title="Viatropos">
150 | <link rel="self" type="application/atom+xml" href="https://example.com/atomFeed.php?page=3">
151 | <link rel="first" href="https://example.com/atomFeed.php">
152 | <link rel="next" href="https://example.com/atomFeed.php?page=4">
153 | <link rel="previous" href="https://example.com/atomFeed.php?page=2">
154 | <link rel="last" href="https://example.com/atomFeed.php?page=147">
155 | <link rel="shortlink" href="https://example.com/?p=43625">
156 | <link rel="canonical" href="https://example.com/2010/06/9-things-to-do-before-entering-social-media.html">
157 | <link rel="amphtml" href="https://www.example.com/url/to/amp-version.html">
158 | <link rel="EditURI" href="https://example.com/xmlrpc.php?rsd" type="application/rsd+xml" title="RSD">
159 | <link rel="pingback" href="https://example.com/xmlrpc.php">
160 | <link rel="webmention" href="https://example.com/webmention">
161 | <link rel="manifest" href="manifest.json">
162 | <link rel="author" href="humans.txt">
163 | <link rel="import" href="component.html">
164 | 
165 | <!-- Prefetching, preloading, prebrowsing -->
166 | <link rel="dns-prefetch" href="//example.com/">
167 | <link rel="preconnect" href="https://www.example.com/">
168 | <link rel="prefetch" href="https://www.example.com/">
169 | <link rel="prerender" href="https://example.com/">
170 | <link rel="subresource" href="styles.css">
171 | <link rel="preload" href="image.png">
172 | <!-- More info: https://css-tricks.com/prefetching-preloading-prebrowsing/ -->
173 | ```
174 | 
175 | ### Favicons
176 | 
177 | ``` html
178 | <link rel="icon" href="path/to/favicon-16.png" sizes="16x16" type="image/png">
179 | <link rel="icon" href="path/to/favicon-32.png" sizes="32x32" type="image/png">
180 | <link rel="icon" href="path/to/favicon-48.png" sizes="48x48" type="image/png">
181 | <link rel="icon" href="path/to/favicon-62.png" sizes="62x62" type="image/png">
182 | <!-- More info: https://bitsofco.de/all-about-favicons-and-touch-icons/ -->
183 | ```
184 | 
185 | - [All About Favicons (And Touch Icons)](https://bitsofco.de/all-about-favicons-and-touch-icons/)
186 | 
187 | 
188 | 
189 | ## Browser/Platform
190 | 
191 | 
192 | ### Apple iOS
193 | 
194 | ``` html
195 | <!-- Smart App Banner -->
196 | <!-- 添加智能 App 广告条 Smart App Banner：告诉浏览器这个网站对应的app，并在页面上显示下载banner -->
197 | <meta name="apple-itunes-app" content="app-id=APP_ID,affiliate-data=AFFILIATE_ID,app-argument=SOME_TEXT">
198 | 
199 | <!-- Disable automatic detection and formatting of possible phone numbers -->
200 | <!--  忽略数字自动识别为电话号码 -->
201 | <meta name="format-detection" content="telephone=no">
202 | <!-- 忽略识别邮箱 -->
203 | <meta name="format-detection" content="email=no">
204 | 
205 | <!-- Add to Home Screen -->
206 | <!-- WebApp全屏模式：伪装app，离线应用。-->
207 | <meta name="apple-mobile-web-app-capable" content="yes"> <!-- 启用 WebApp 全屏模式 -->
208 | <!-- 隐藏状态栏/设置状态栏颜色：只有在开启WebApp全屏模式时才生效。content的值为default | black | black-translucent -->
209 | <meta name="apple-mobile-web-app-status-bar-style" content="black">
210 | <!-- 添加到主屏后的标题 -->
211 | <meta name="apple-mobile-web-app-title" content="App Title">
212 | 
213 | <!-- Touch Icons -->
214 | <link rel="apple-touch-icon" href="apple-touch-icon.png">
215 | <link rel="apple-touch-icon-precomposed" href="apple-touch-icon-precomposed.png">
216 | <!-- In most cases, one 180×180px touch icon in the head is enough -->
217 | <!-- If you use art-direction and/or want to have different content for each device, you can add more touch icons -->
218 | 
219 | <!-- Startup Image -->
220 | <link rel="apple-touch-startup-image" href="startup.png">
221 | 
222 | <!-- More info: https://developer.apple.com/safari/library/documentation/appleapplications/reference/safarihtmlref/articles/metatags.html -->
223 | ```
224 | 
225 | - [Apple Meta Tags](https://developer.apple.com/library/safari/documentation/AppleApplications/Reference/SafariHTMLRef/Articles/MetaTags.html)
226 | 
227 | ### Apple Safari
228 | 
229 | ```html
230 | <!-- Pinned Site -->
231 | <link rel="mask-icon" href="icon.svg" color="red">
232 | ```
233 | 
234 | ### Google Android
235 | 
236 | ``` html
237 | <meta name="theme-color" content="#E64545">
238 | 
239 | <!-- Add to homescreen -->
240 | <meta name="mobile-web-app-capable" content="yes">
241 | <!-- More info: https://developer.chrome.com/multidevice/android/installtohomescreen -->
242 | ```
243 | 
244 | ### Google Chrome
245 | 
246 | ``` html
247 | <link rel="chrome-webstore-item" href="https://chrome.google.com/webstore/detail/APP_ID">
248 | 
249 | <!-- Disable translation prompt -->
250 | <meta name="google" value="notranslate">
251 | ```
252 | 
253 | ### Microsoft Internet Explorer
254 | 
255 | ``` html
256 | <meta http-equiv="x-ua-compatible" content="ie=edge">
257 | <meta http-equiv="cleartype" content="on">
258 | <meta name="skype_toolbar" content="skype_toolbar_parser_compatible">
259 | 
260 | <!-- Pinned Site -->
261 | <!-- IE 10 / Windows 8 -->
262 | <meta name="msapplication-TileImage" content="pinned-tile-144.png">
263 | <meta name="msapplication-TileColor" content="#009900">
264 | <!-- IE 11 / Windows 9.1 -->
265 | <meta name="msapplication-config" content="ieconfig.xml">
266 | ```
267 | 
268 | ### Microsoft Internet Explorer (LEGACY DO NOT USE)
269 | 
270 | ``` html
271 | <!-- Legacy Tags (DO NOT USE) -->
272 | <meta name="mssmarttagspreventparsing" content="true">
273 | <meta http-equiv="page-enter" content="revealtrans(duration=2,transition=2)">
274 | <meta http-equiv="page-exit" content="revealtrans(duration=3,transition=12)">
275 | ```
276 | 
277 | ## App Links
278 | 
279 | ``` html
280 | <!-- iOS -->
281 | <meta property="al:ios:url" content="applinks://docs">
282 | <meta property="al:ios:app_store_id" content="12345">
283 | <meta property="al:ios:app_name" content="App Links">
284 | <!-- Android -->
285 | <meta property="al:android:url" content="applinks://docs">
286 | <meta property="al:android:app_name" content="App Links">
287 | <meta property="al:android:package" content="org.applinks">
288 | <!-- Web Fallback -->
289 | <meta property="al:web:url" content="http://applinks.org/documentation">
290 | <!-- More info: http://applinks.org/documentation/ -->
291 | ```
292 | 
293 | ## Social
294 | 
295 | ### Facebook / Open Graph
296 | 
297 | ``` html
298 | <meta property="fb:app_id" content="123456789">
299 | <meta property="og:url" content="https://example.com/page.html">
300 | <meta property="og:type" content="website">
301 | <meta property="og:title" content="Content Title">
302 | <meta property="og:image" content="https://example.com/image.jpg">
303 | <meta property="og:description" content="Description Here">
304 | <meta property="og:site_name" content="Site Name">
305 | <meta property="og:locale" content="en_US">
306 | <meta property="article:author" content="">
307 | <!-- Facebook: https://developers.facebook.com/docs/sharing/webmasters#markup -->
308 | <!-- Open Graph: http://ogp.me/ -->
309 | ```
310 | 
311 | - [Facebook Open Graph Markup](https://developers.facebook.com/docs/sharing/webmasters#markup)
312 | - [Open Graph protocol](http://ogp.me/)
313 | 
314 | ### Twitter
315 | 
316 | ``` html
317 | <meta name="twitter:card" content="summary">
318 | <meta name="twitter:site" content="@site_account">
319 | <meta name="twitter:creator" content="@individual_account">
320 | <meta name="twitter:url" content="https://example.com/page.html">
321 | <meta name="twitter:title" content="Content Title">
322 | <meta name="twitter:description" content="Content description less than 200 characters">
323 | <meta name="twitter:image" content="https://example.com/image.jpg">
324 | <!-- More info: https://dev.twitter.com/cards/getting-started -->
325 | <!-- Validate: https://dev.twitter.com/docs/cards/validation/validator -->
326 | ```
327 | 
328 | - [Twitter Cards: Getting Started Guide](https://dev.twitter.com/cards/getting-started)
329 | - [Twitter Card Validator](https://dev.twitter.com/docs/cards/validation/validator)
330 | 
331 | ### Google+ / Schema.org
332 | 
333 | ``` html
334 | <meta itemprop="name" content="Content Title">
335 | <meta itemprop="description" content="Content description less than 200 characters">
336 | <meta itemprop="image" content="https://example.com/image.jpg">
337 | ```
338 | 
339 | - [App Links Docs](http://applinks.org/documentation/)
340 | 
341 | ## 参考资料
342 | 
343 | - [HTML5 Boilerplate Docs: The HTML](https://github.com/h5bp/html5-boilerplate/blob/master/dist/doc/html.md)
344 | - [HTML5 Boilerplate Docs: Extend and customize](https://github.com/h5bp/html5-boilerplate/blob/master/dist/doc/extend.md)
345 | - [MDN Meta](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/meta)
346 | - [常用meta整理](https://segmentfault.com/a/1190000002407912)
347 | - [HTML meta标签总结与属性使用介绍](https://segmentfault.com/a/1190000004279791)
348 | 
349 | ## Author
350 | 
351 | **Josh Buchea**
352 | - <https://github.com/joshbuchea>
353 | - <https://github.com/xiaoyu2er>
354 | 
355 | ## License
356 | 
357 | [MIT License](LICENSE)
358 | 


--------------------------------------------------------------------------------