mirror of
https://github.com/h5bp/html5-boilerplate.git
synced 2026-01-13 16:48:02 -05:00
Compare commits
12 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
85d79ed6cc | ||
|
|
fee2238978 | ||
|
|
a91fea4cd6 | ||
|
|
bf141af507 | ||
|
|
c0665f0989 | ||
|
|
dd6ec22ea5 | ||
|
|
2de99b2ba3 | ||
|
|
d35a8e9020 | ||
|
|
7463646b48 | ||
|
|
0d9f00826a | ||
|
|
6ee34e1ced | ||
|
|
907838737b |
10
CHANGELOG.md
10
CHANGELOG.md
@@ -1,3 +1,13 @@
|
||||
### 5.2.0 (May 1, 2015)
|
||||
|
||||
* Update jQuery to `v1.11.3`
|
||||
([#1699](https://github.com/h5bp/html5-boilerplate/issues/1699)).
|
||||
* Deprecate protocol-relative URLs
|
||||
([#1694](https://github.com/h5bp/html5-boilerplate/issues/1694)).
|
||||
* Update high resolution media query
|
||||
([#1474](https://github.com/h5bp/html5-boilerplate/issues/1474)).
|
||||
* Update Apache Server Configs to `v2.14.0`.
|
||||
|
||||
### 5.1.0 (April 1, 2015)
|
||||
|
||||
* Update Normalize.css to `v3.0.3`.
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Contributing to HTML5 Boilerplate
|
||||
|
||||
♥ [HTML5 Boilerplate](http://html5boilerplate.com) and want to get involved?
|
||||
♥ [HTML5 Boilerplate](https://html5boilerplate.com) and want to get involved?
|
||||
Thanks! There are plenty of ways you can help!
|
||||
|
||||
Please take a moment to review this document in order to make the contribution
|
||||
@@ -48,7 +48,7 @@ Guidelines for bug reports:
|
||||
latest `master` or development branch in the repository.
|
||||
|
||||
3. **Isolate the problem** — ideally create a [reduced test
|
||||
case](http://css-tricks.com/6263-reduced-test-cases/) and a live example.
|
||||
case](https://css-tricks.com/reduced-test-cases/) and a live example.
|
||||
|
||||
A good bug report shouldn't leave others needing to chase you up for more
|
||||
information. Please try to be as detailed as possible in your report. What is
|
||||
@@ -102,7 +102,7 @@ accurate comments, etc.) and any other requirements (such as test coverage).
|
||||
Adhering to the following process is the best way to get your work
|
||||
included in the project:
|
||||
|
||||
1. [Fork](https://help.github.com/articles/fork-a-repo) the project, clone your
|
||||
1. [Fork](https://help.github.com/articles/fork-a-repo/) the project, clone your
|
||||
fork, and configure the remotes:
|
||||
|
||||
```bash
|
||||
@@ -131,7 +131,7 @@ included in the project:
|
||||
4. Commit your changes in logical chunks. Please adhere to these [git commit
|
||||
message guidelines](http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html)
|
||||
or your code is unlikely be merged into the main project. Use Git's
|
||||
[interactive rebase](https://help.github.com/articles/about-git-rebase)
|
||||
[interactive rebase](https://help.github.com/articles/about-git-rebase/)
|
||||
feature to tidy up your commits before making them public.
|
||||
|
||||
5. Locally merge (or rebase) the upstream development branch into your topic branch:
|
||||
@@ -149,5 +149,5 @@ included in the project:
|
||||
7. [Open a Pull Request](https://help.github.com/articles/using-pull-requests/)
|
||||
with a clear title and description.
|
||||
|
||||
**IMPORTANT**: By submitting a patch, you agree to allow the project owners to
|
||||
license your work under the terms of the [MIT License](LICENSE.md).
|
||||
**IMPORTANT**: By submitting a patch, you agree to allow the project
|
||||
owners to license your work under the terms of the [MIT License](LICENSE.txt).
|
||||
|
||||
71
README.md
71
README.md
@@ -3,15 +3,16 @@
|
||||
[](https://travis-ci.org/h5bp/html5-boilerplate)
|
||||
[](https://david-dm.org/h5bp/html5-boilerplate#info=devDependencies)
|
||||
|
||||
HTML5 Boilerplate is a professional front-end template for building fast,
|
||||
robust, and adaptable web apps or sites.
|
||||
HTML5 Boilerplate is a professional front-end template for building
|
||||
fast, robust, and adaptable web apps or sites.
|
||||
|
||||
This project is the product of many years of iterative development and combined
|
||||
community knowledge. It does not impose a specific development philosophy or
|
||||
framework, so you're free to architect your code in the way that you want.
|
||||
This project is the product of many years of iterative development and
|
||||
combined community knowledge. It does not impose a specific development
|
||||
philosophy or framework, so you're free to architect your code in the
|
||||
way that you want.
|
||||
|
||||
* Source: [https://github.com/h5bp/html5-boilerplate](https://github.com/h5bp/html5-boilerplate)
|
||||
* Homepage: [https://html5boilerplate.com](https://html5boilerplate.com)
|
||||
* Source: [https://github.com/h5bp/html5-boilerplate](https://github.com/h5bp/html5-boilerplate)
|
||||
* Twitter: [@h5bp](https://twitter.com/h5bp)
|
||||
|
||||
|
||||
@@ -20,30 +21,32 @@ framework, so you're free to architect your code in the way that you want.
|
||||
Choose one of the following options:
|
||||
|
||||
1. Download the latest stable release from
|
||||
[html5boilerplate.com](https://html5boilerplate.com/) or a custom build from
|
||||
[Initializr](http://www.initializr.com).
|
||||
[html5boilerplate.com](https://html5boilerplate.com/) or create a
|
||||
custom build using [Initializr](http://www.initializr.com).
|
||||
2. Clone the git repo — `git clone
|
||||
https://github.com/h5bp/html5-boilerplate.git` - and checkout the [tagged
|
||||
release](https://github.com/h5bp/html5-boilerplate/releases) you'd like to
|
||||
use.
|
||||
https://github.com/h5bp/html5-boilerplate.git` - and checkout the
|
||||
[tagged release](https://github.com/h5bp/html5-boilerplate/releases)
|
||||
you'd like to use.
|
||||
|
||||
|
||||
## Features
|
||||
|
||||
* HTML5 ready. Use the new elements with confidence.
|
||||
* Designed with progressive enhancement in mind.
|
||||
* Includes [Normalize.css](http://necolas.github.com/normalize.css/) for CSS
|
||||
normalizations and common bug fixes.
|
||||
* The latest [jQuery](https://jquery.com/) via CDN, with a local fallback.
|
||||
* The latest [Modernizr](http://modernizr.com/) build for feature detection.
|
||||
* Includes:
|
||||
* [`Normalize.css`](https://necolas.github.com/normalize.css/)
|
||||
for CSS normalizations and common bug fixes
|
||||
* [`jQuery`](https://jquery.com/) via CDN, with a local fallback
|
||||
* A custom build of [`Modernizr`](http://modernizr.com/) for feature
|
||||
detection
|
||||
* [`Apache Server Configs`](https://github.com/h5bp/server-configs-apache)
|
||||
that, among other, improve the web site's performance and security
|
||||
* Placeholder CSS Media Queries.
|
||||
* Useful CSS helpers.
|
||||
* Default print CSS, performance optimized.
|
||||
* Protection against any stray `console` statements causing JavaScript errors
|
||||
in older browsers.
|
||||
* An optimized Google Analytics snippet.
|
||||
* Apache server caching, compression, and other configuration defaults for
|
||||
Grade-A performance.
|
||||
* Useful CSS helper classes.
|
||||
* Default print styles, performance optimized.
|
||||
* An optimized version of the Google Universal Analytics snippet.
|
||||
* Protection against any stray `console` statements causing JavaScript
|
||||
errors in older browsers.
|
||||
* "Delete-key friendly." Easy to strip out parts you don't need.
|
||||
* Extensive inline and accompanying documentation.
|
||||
|
||||
@@ -59,23 +62,29 @@ Choose one of the following options:
|
||||
*This doesn't mean that HTML5 Boilerplate cannot be used in older browsers,
|
||||
just that we'll ensure compatibility with the ones mentioned above.*
|
||||
|
||||
If you need legacy browser support (IE 6+, Firefox 3.6+, Safari 4+) you can use
|
||||
[HTML5 Boilerplate v4](https://github.com/h5bp/html5-boilerplate/tree/v4), but
|
||||
is no longer actively developed.
|
||||
If you need legacy browser support (IE 6+, Firefox 3.6+, Safari 4+) you
|
||||
can use [HTML5 Boilerplate v4](https://github.com/h5bp/html5-boilerplate/tree/v4),
|
||||
but is no longer actively developed.
|
||||
|
||||
|
||||
## Documentation
|
||||
|
||||
Take a look at the [documentation table of contents](dist/doc/TOC.md). This
|
||||
documentation is bundled with the project, which makes it readily available for
|
||||
offline reading and provides a useful starting point for any documentation you
|
||||
want to write about your project.
|
||||
Take a look at the [documentation table of contents](dist/doc/TOC.md).
|
||||
This documentation is bundled with the project, which makes it readily
|
||||
available for offline reading and provides a useful starting point for
|
||||
any documentation you want to write about your project.
|
||||
|
||||
|
||||
## Contributing
|
||||
|
||||
Anyone and everyone is welcome to [contribute](CONTRIBUTING.md). Hundreds of
|
||||
developers have helped make the HTML5 Boilerplate what it is today.
|
||||
Hundreds of developers have helped make the HTML5 Boilerplate what it is
|
||||
today. Anyone and everyone is welcome to [contribute](CONTRIBUTING.md),
|
||||
however, if you decide to get involved, please take a moment to review
|
||||
the [guidelines](CONTRIBUTING.md):
|
||||
|
||||
* [Bug reports](CONTRIBUTING.md#bugs)
|
||||
* [Feature requests](CONTRIBUTING.md#features)
|
||||
* [Pull requests](CONTRIBUTING.md#pull-requests)
|
||||
|
||||
|
||||
## License
|
||||
|
||||
64
dist/.htaccess
vendored
64
dist/.htaccess
vendored
@@ -1,4 +1,4 @@
|
||||
# Apache Server Configs v2.13.0 | MIT License
|
||||
# Apache Server Configs v2.14.0 | MIT License
|
||||
# https://github.com/h5bp/server-configs-apache
|
||||
|
||||
# (!) Using `.htaccess` files slows down Apache, therefore, if you have
|
||||
@@ -130,7 +130,7 @@ Options -MultiViews
|
||||
# the `X-UA-Compatible` response header should be send only for
|
||||
# HTML documents and not for the other resources.
|
||||
|
||||
<FilesMatch "\.(appcache|atom|bbaw|bmp|crx|css|cur|eot|f4[abpv]|flv|geojson|gif|htc|ico|jpe?g|js|json(ld)?|m4[av]|manifest|map|mp4|oex|og[agv]|opus|otf|pdf|png|rdf|rss|safariextz|svgz?|swf|topojson|tt[cf]|txt|vcard|vcf|vtt|webapp|web[mp]|woff2?|xloc|xml|xpi)$">
|
||||
<FilesMatch "\.(appcache|atom|bbaw|bmp|crx|css|cur|eot|f4[abpv]|flv|geojson|gif|htc|ico|jpe?g|js|json(ld)?|m4[av]|manifest|map|mp4|oex|og[agv]|opus|otf|pdf|png|rdf|rss|safariextz|svgz?|swf|topojson|tt[cf]|txt|vcard|vcf|vtt|webapp|web[mp]|webmanifest|woff2?|xloc|xml|xpi)$">
|
||||
Header unset X-UA-Compatible
|
||||
</FilesMatch>
|
||||
|
||||
@@ -185,37 +185,7 @@ Options -MultiViews
|
||||
|
||||
# Manifest files
|
||||
|
||||
# If you are providing a web application manifest file (see
|
||||
# the specification: https://w3c.github.io/manifest/), it is
|
||||
# recommended that you serve it with the `application/manifest+json`
|
||||
# media type.
|
||||
#
|
||||
# Because the web application manifest file doesn't have its
|
||||
# own unique file extension, you can set its media type either
|
||||
# by matching:
|
||||
#
|
||||
# 1) the exact location of the file (this can be done using a
|
||||
# directive such as `<Location>`, but it will NOT work in
|
||||
# the `.htaccess` file, so you will have to do it in the main
|
||||
# server configuration file or inside of a `<VirtualHost>`
|
||||
# container)
|
||||
#
|
||||
# e.g.:
|
||||
#
|
||||
# <Location "/.well-known/manifest.json">
|
||||
# AddType application/manifest+json json
|
||||
# </Location>
|
||||
#
|
||||
# 2) the filename (this can be problematic as you will need to
|
||||
# ensure that you don't have any other file with the same name
|
||||
# as the one you gave to your web application manifest file)
|
||||
#
|
||||
# e.g.:
|
||||
#
|
||||
# <Files "manifest.json">
|
||||
# AddType application/manifest+json json
|
||||
# </Files>
|
||||
|
||||
AddType application/manifest+json webmanifest
|
||||
AddType application/x-web-app-manifest+json webapp
|
||||
AddType text/cache-manifest appcache
|
||||
|
||||
@@ -297,11 +267,13 @@ AddDefaultCharset utf-8
|
||||
.js \
|
||||
.json \
|
||||
.jsonld \
|
||||
.manifest \
|
||||
.rdf \
|
||||
.rss \
|
||||
.topojson \
|
||||
.vtt \
|
||||
.webapp \
|
||||
.webmanifest \
|
||||
.xloc \
|
||||
.xml
|
||||
</IfModule>
|
||||
@@ -475,7 +447,7 @@ AddDefaultCharset utf-8
|
||||
# # the `X-Frame-Options` response header should be send only for
|
||||
# # HTML documents and not for the other resources.
|
||||
|
||||
# <FilesMatch "\.(appcache|atom|bbaw|bmp|crx|css|cur|eot|f4[abpv]|flv|geojson|gif|htc|ico|jpe?g|js|json(ld)?|m4[av]|manifest|map|mp4|oex|og[agv]|opus|otf|pdf|png|rdf|rss|safariextz|svgz?|swf|topojson|tt[cf]|txt|vcard|vcf|vtt|webapp|web[mp]|woff2?|xloc|xml|xpi)$">
|
||||
# <FilesMatch "\.(appcache|atom|bbaw|bmp|crx|css|cur|eot|f4[abpv]|flv|geojson|gif|htc|ico|jpe?g|js|json(ld)?|m4[av]|manifest|map|mp4|oex|og[agv]|opus|otf|pdf|png|rdf|rss|safariextz|svgz?|swf|topojson|tt[cf]|txt|vcard|vcf|vtt|webapp|web[mp]|webmanifest|woff2?|xloc|xml|xpi)$">
|
||||
# Header unset X-Frame-Options
|
||||
# </FilesMatch>
|
||||
|
||||
@@ -510,7 +482,7 @@ AddDefaultCharset utf-8
|
||||
# # the `Content-Security-Policy` response header should be send
|
||||
# # only for HTML documents and not for the other resources.
|
||||
|
||||
# <FilesMatch "\.(appcache|atom|bbaw|bmp|crx|css|cur|eot|f4[abpv]|flv|geojson|gif|htc|ico|jpe?g|js|json(ld)?|m4[av]|manifest|map|mp4|oex|og[agv]|opus|otf|pdf|png|rdf|rss|safariextz|svgz?|swf|topojson|tt[cf]|txt|vcard|vcf|vtt|webapp|web[mp]|woff2?|xloc|xml|xpi)$">
|
||||
# <FilesMatch "\.(appcache|atom|bbaw|bmp|crx|css|cur|eot|f4[abpv]|flv|geojson|gif|htc|ico|jpe?g|js|json(ld)?|m4[av]|manifest|map|mp4|oex|og[agv]|opus|otf|pdf|png|rdf|rss|safariextz|svgz?|swf|topojson|tt[cf]|txt|vcard|vcf|vtt|webapp|web[mp]|webmanifest|woff2?|xloc|xml|xpi)$">
|
||||
# Header unset Content-Security-Policy
|
||||
# </FilesMatch>
|
||||
|
||||
@@ -678,7 +650,7 @@ AddDefaultCharset utf-8
|
||||
# # the `X-XSS-Protection` response header should be send only for
|
||||
# # HTML documents and not for the other resources.
|
||||
|
||||
# <FilesMatch "\.(appcache|atom|bbaw|bmp|crx|css|cur|eot|f4[abpv]|flv|geojson|gif|htc|ico|jpe?g|js|json(ld)?|m4[av]|manifest|map|mp4|oex|og[agv]|opus|otf|pdf|png|rdf|rss|safariextz|svgz?|swf|topojson|tt[cf]|txt|vcard|vcf|vtt|webapp|web[mp]|woff2?|xloc|xml|xpi)$">
|
||||
# <FilesMatch "\.(appcache|atom|bbaw|bmp|crx|css|cur|eot|f4[abpv]|flv|geojson|gif|htc|ico|jpe?g|js|json(ld)?|m4[av]|manifest|map|mp4|oex|og[agv]|opus|otf|pdf|png|rdf|rss|safariextz|svgz?|swf|topojson|tt[cf]|txt|vcard|vcf|vtt|webapp|web[mp]|webmanifest|woff2?|xloc|xml|xpi)$">
|
||||
# Header unset X-XSS-Protection
|
||||
# </FilesMatch>
|
||||
|
||||
@@ -878,9 +850,12 @@ FileETag None
|
||||
ExpiresDefault "access plus 1 month"
|
||||
|
||||
# CSS
|
||||
|
||||
ExpiresByType text/css "access plus 1 year"
|
||||
|
||||
|
||||
# Data interchange
|
||||
|
||||
ExpiresByType application/atom+xml "access plus 1 hour"
|
||||
ExpiresByType application/rdf+xml "access plus 1 hour"
|
||||
ExpiresByType application/rss+xml "access plus 1 hour"
|
||||
@@ -892,25 +867,33 @@ FileETag None
|
||||
ExpiresByType application/xml "access plus 0 seconds"
|
||||
ExpiresByType text/xml "access plus 0 seconds"
|
||||
|
||||
|
||||
# Favicon (cannot be renamed!) and cursor images
|
||||
|
||||
ExpiresByType image/vnd.microsoft.icon "access plus 1 week"
|
||||
ExpiresByType image/x-icon "access plus 1 week"
|
||||
|
||||
# HTML
|
||||
|
||||
ExpiresByType text/html "access plus 0 seconds"
|
||||
|
||||
|
||||
# JavaScript
|
||||
|
||||
ExpiresByType application/javascript "access plus 1 year"
|
||||
ExpiresByType application/x-javascript "access plus 1 year"
|
||||
ExpiresByType text/javascript "access plus 1 year"
|
||||
|
||||
# Manifest files
|
||||
ExpiresByType application/manifest+json "access plus 1 year"
|
||||
|
||||
# Manifest files
|
||||
|
||||
ExpiresByType application/manifest+json "access plus 1 week"
|
||||
ExpiresByType application/x-web-app-manifest+json "access plus 0 seconds"
|
||||
ExpiresByType text/cache-manifest "access plus 0 seconds"
|
||||
|
||||
|
||||
# Media files
|
||||
|
||||
ExpiresByType audio/ogg "access plus 1 month"
|
||||
ExpiresByType image/bmp "access plus 1 month"
|
||||
ExpiresByType image/gif "access plus 1 month"
|
||||
@@ -922,6 +905,7 @@ FileETag None
|
||||
ExpiresByType video/ogg "access plus 1 month"
|
||||
ExpiresByType video/webm "access plus 1 month"
|
||||
|
||||
|
||||
# Web fonts
|
||||
|
||||
# Embedded OpenType (EOT)
|
||||
@@ -942,7 +926,9 @@ FileETag None
|
||||
# Web Open Font Format (WOFF) 2.0
|
||||
ExpiresByType application/font-woff2 "access plus 1 month"
|
||||
|
||||
|
||||
# Other
|
||||
|
||||
ExpiresByType text/x-cross-domain-policy "access plus 1 week"
|
||||
|
||||
</IfModule>
|
||||
@@ -994,5 +980,5 @@ FileETag None
|
||||
# <IfModule mod_rewrite.c>
|
||||
# RewriteEngine On
|
||||
# RewriteCond %{REQUEST_FILENAME} !-f
|
||||
# RewriteRule ^(.+)\.(\d+)\.(bmp|css|cur|gif|ico|jpe?g|js|png|svgz?|webp)$ $1.$3 [L]
|
||||
# RewriteRule ^(.+)\.(\d+)\.(bmp|css|cur|gif|ico|jpe?g|js|png|svgz?|webp|webmanifest)$ $1.$3 [L]
|
||||
# </IfModule>
|
||||
|
||||
3
dist/css/main.css
vendored
3
dist/css/main.css
vendored
@@ -1,4 +1,4 @@
|
||||
/*! HTML5 Boilerplate v5.1.0 | MIT License | https://html5boilerplate.com/ */
|
||||
/*! HTML5 Boilerplate v5.2.0 | MIT License | https://html5boilerplate.com/ */
|
||||
|
||||
/*
|
||||
* What follows is the result of much research on cross-browser styling.
|
||||
@@ -197,6 +197,7 @@ textarea {
|
||||
|
||||
@media print,
|
||||
(-webkit-min-device-pixel-ratio: 1.25),
|
||||
(min-resolution: 1.25dppx),
|
||||
(min-resolution: 120dpi) {
|
||||
/* Style adjustments for high resolution devices */
|
||||
}
|
||||
|
||||
6
dist/doc/extend.md
vendored
6
dist/doc/extend.md
vendored
@@ -87,7 +87,7 @@ your site, for example) then you can queue up a domain name to be prefetched.
|
||||
|
||||
```html
|
||||
<link rel="dns-prefetch" href="//example.com">
|
||||
<link rel="dns-prefetch" href="//ajax.googleapis.com">
|
||||
<link rel="dns-prefetch" href="https://ajax.googleapis.com">
|
||||
```
|
||||
|
||||
You can use as many of these as you need, but it's best if they are all
|
||||
@@ -107,7 +107,7 @@ Amazon S3:
|
||||
Google APIs:
|
||||
|
||||
```html
|
||||
<link rel="dns-prefetch" href="//ajax.googleapis.com">
|
||||
<link rel="dns-prefetch" href="https://ajax.googleapis.com">
|
||||
```
|
||||
|
||||
Microsoft Ajax Content Delivery Network:
|
||||
@@ -356,7 +356,7 @@ value is boolean rather than a color. It's all or nothing.
|
||||
```
|
||||
|
||||
You can read about this useful element and more techniques in
|
||||
[Microsoft's documentation on adapting WebKit-oriented apps for IE10](http://blogs.windows.com/buildingapps/2012/11/15/adapting-your-webkit-optimized-site-for-internet-explorer-10/)
|
||||
[Microsoft's documentation on adapting WebKit-oriented apps for IE10](https://blogs.windows.com/buildingapps/2012/11/15/adapting-your-webkit-optimized-site-for-internet-explorer-10/)
|
||||
|
||||
## Search
|
||||
|
||||
|
||||
35
dist/doc/faq.md
vendored
35
dist/doc/faq.md
vendored
@@ -3,8 +3,6 @@ table of contents](TOC.md)
|
||||
|
||||
# Frequently asked questions
|
||||
|
||||
* [Why is the URL for jQuery without
|
||||
`http`?](#why-is-the-url-for-jquery-without-http)
|
||||
* [Why don't you automatically load the latest version of jQuery from the Google
|
||||
CDN?](#why-dont-you-automatically-load-the-latest-version-of-jquery-from-the-google-cdn)
|
||||
* [Why is the Google Analytics code at the bottom? Google recommends it be
|
||||
@@ -18,35 +16,6 @@ table of contents](TOC.md)
|
||||
|
||||
--
|
||||
|
||||
### Why is the URL for jQuery without `http`?
|
||||
|
||||
It is because of the use of [protocol-relative
|
||||
URLs](http://paulirish.com/2010/the-protocol-relative-url/).
|
||||
|
||||
**N.B.** If you try to view the local web page directly in the browser, the
|
||||
browser will fail to load the assets specified using protocol-relative URLs
|
||||
as it will attempt to fetch them from the local file system. We recommend you
|
||||
use a local HTTP server to test your web pages, or a file hosting service that
|
||||
allows you to preview your web pages online (e.g.
|
||||
[Dropbox](https://www.dropbox.com/)).
|
||||
|
||||
Setting up a local HTTP server can be done using there various
|
||||
[one-liners](https://gist.github.com/willurd/5720255):
|
||||
|
||||
* PHP 5.4.0+ by running
|
||||
[`php -S localhost:8080`](https://php.net/manual/en/features.commandline.webserver.php)
|
||||
from your local directory
|
||||
* Python 2.x by running `python -m SimpleHTTPServer` from your local directory
|
||||
* Python 3.x by running `python -m http.server` from your local directory
|
||||
* Ruby 1.9.2+ by running `ruby -run -ehttpd . -p8080` from your local directory
|
||||
* Node.js by installing and running either
|
||||
[`static -p 8080`](https://www.npmjs.org/package/node-static)
|
||||
or [`http-server -p 8080`](https://www.npmjs.org/package/http-server)
|
||||
|
||||
A list of more complex HTTP servers can be found
|
||||
[here](misc.md#servers-and-stacks).
|
||||
|
||||
|
||||
### Why don't you automatically load the latest version of jQuery from the Google CDN?
|
||||
|
||||
The [file](https://ajax.googleapis.com/ajax/libs/jquery/1/jquery.js) to which
|
||||
@@ -67,12 +36,12 @@ include a URL that will always point to the latest version, as that version:
|
||||
The main advantage of placing it in the `<head>` is that you will track the
|
||||
user's `pageview` even if they leave the page before it has been fully loaded.
|
||||
However, having the code at the bottom of the page [helps improve
|
||||
performance](http://stevesouders.com/efws/inline-scripts-bottom.php).
|
||||
performance](https://stevesouders.com/efws/inline-scripts-bottom.php).
|
||||
|
||||
|
||||
### How can I integrate [Bootstrap](http://getbootstrap.com/) with HTML5 Boilerplate?
|
||||
|
||||
One simple way is to use [Initializr](http://initializr.com) and create a
|
||||
One simple way is to use [Initializr](http://www.initializr.com/) and create a
|
||||
custom build that includes both HTML5 Boilerplate and
|
||||
[Bootstrap](http://getbootstrap.com/).
|
||||
|
||||
|
||||
6
dist/doc/html.md
vendored
6
dist/doc/html.md
vendored
@@ -18,7 +18,7 @@ By default, HTML5 Boilerplate provides two `html` pages:
|
||||
The `no-js` class is provided in order to allow you to more easily and
|
||||
explicitly add custom styles based on whether JavaScript is disabled
|
||||
(`.no-js`) or enabled (`.js`). Using this technique also helps [avoid the
|
||||
FOUC](http://paulirish.com/2009/avoiding-the-fouc-v3/).
|
||||
FOUC](https://www.paulirish.com/2009/avoiding-the-fouc-v3/).
|
||||
|
||||
|
||||
## Language attribute
|
||||
@@ -145,8 +145,8 @@ using some polyfill CDN service, like [cdn.polyfill.io](https://cdn.polyfill.io/
|
||||
just put it before the other scripts in the bottom of the page:
|
||||
|
||||
```html
|
||||
<script src="//cdn.polyfill.io/v1/polyfill.min.js"></script>
|
||||
<script src="//ajax.googleapis.com/ajax/libs/jquery/1.11.2/jquery.min.js"></script>
|
||||
<script src="https://cdn.polyfill.io/v1/polyfill.min.js"></script>
|
||||
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.2/jquery.min.js"></script>
|
||||
<script>window.jQuery || document.write('<script src="js/vendor/jquery-1.11.2.min.js"><\/script>')</script>
|
||||
<script src="js/plugins.js"></script>
|
||||
<script src="js/main.js"></script>
|
||||
|
||||
23
dist/doc/misc.md
vendored
23
dist/doc/misc.md
vendored
@@ -66,29 +66,6 @@ Apache as your web server, then you are encouraged to download a
|
||||
[server configuration](https://github.com/h5bp/server-configs) that corresponds
|
||||
to your web server and environment.
|
||||
|
||||
|
||||
### Servers and Stacks
|
||||
|
||||
A comprehensive list of web servers and stacks are beyond the scope of this
|
||||
documentation, but some common ones include:
|
||||
|
||||
* [Apache HTTP Server](https://httpd.apache.org/docs/trunk/getting-started.html)
|
||||
* [LAMP](https://en.wikipedia.org/wiki/LAMP_%28software_bundle%29)
|
||||
(Linux, Apache, MySQL, and PHP).
|
||||
Other variants include [MAMP](https://www.mamp.info/en/index.html),
|
||||
[WAMP](http://www.wampserver.com/en/),
|
||||
or [XAMPP](https://www.apachefriends.org/index.html).
|
||||
* LAPP uses PostgreSQL instead of MySQL
|
||||
* [Nginx](http://wiki.nginx.org/GettingStarted)
|
||||
* [LEMP](http://www.chrisjohnston.org/ubuntu-tutorials/setting-up-a-lemp-stack-ubuntu-904)
|
||||
is similar to the LAMP stack but uses Nginx
|
||||
* [IIS](https://en.wikipedia.org/wiki/Internet_Information_Services)
|
||||
* [ASP.NET](https://www.asp.net/get-started)
|
||||
* [MEAN](http://mean.io/) (MongoDB, Express, AngularJS, Node.js)
|
||||
|
||||
|
||||
### .htaccess
|
||||
|
||||
A `.htaccess` (hypertext access) file is a
|
||||
[Apache HTTP server configuration file](https://github.com/h5bp/server-configs-apache).
|
||||
The `.htaccess` file is mostly used for:
|
||||
|
||||
4
dist/index.html
vendored
4
dist/index.html
vendored
@@ -22,8 +22,8 @@
|
||||
<!-- Add your site or application content here -->
|
||||
<p>Hello world! This is HTML5 Boilerplate.</p>
|
||||
|
||||
<script src="//ajax.googleapis.com/ajax/libs/jquery/1.11.2/jquery.min.js"></script>
|
||||
<script>window.jQuery || document.write('<script src="js/vendor/jquery-1.11.2.min.js"><\/script>')</script>
|
||||
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
|
||||
<script>window.jQuery || document.write('<script src="js/vendor/jquery-1.11.3.min.js"><\/script>')</script>
|
||||
<script src="js/plugins.js"></script>
|
||||
<script src="js/main.js"></script>
|
||||
|
||||
|
||||
5
dist/js/vendor/jquery-1.11.2.min.js
vendored
5
dist/js/vendor/jquery-1.11.2.min.js
vendored
File diff suppressed because one or more lines are too long
6
dist/js/vendor/jquery-1.11.3.min.js
vendored
Normal file
6
dist/js/vendor/jquery-1.11.3.min.js
vendored
Normal file
File diff suppressed because one or more lines are too long
16
gulpfile.js
16
gulpfile.js
@@ -2,12 +2,14 @@ var fs = require('fs');
|
||||
var path = require('path');
|
||||
|
||||
var gulp = require('gulp');
|
||||
var plugins = require('gulp-load-plugins')(); // Load all gulp plugins
|
||||
// automatically and attach
|
||||
// them to the `plugins` object
|
||||
|
||||
var runSequence = require('run-sequence'); // Temporary solution until gulp 4
|
||||
// https://github.com/gulpjs/gulp/issues/355
|
||||
// Load all gulp plugins automatically
|
||||
// and attach them to the `plugins` object
|
||||
var plugins = require('gulp-load-plugins')();
|
||||
|
||||
// Temporary solution until gulp 4
|
||||
// https://github.com/gulpjs/gulp/issues/355
|
||||
var runSequence = require('run-sequence');
|
||||
|
||||
var pkg = require('./package.json');
|
||||
var dirs = pkg['h5bp-configs'].directories;
|
||||
@@ -104,8 +106,8 @@ gulp.task('copy:main.css', function () {
|
||||
return gulp.src(dirs.src + '/css/main.css')
|
||||
.pipe(plugins.header(banner))
|
||||
.pipe(plugins.autoprefixer({
|
||||
browsers: ['last 2 versions', 'ie >= 8', '> 1%'],
|
||||
cascade: false
|
||||
browsers: ['last 2 versions', 'ie >= 8', '> 1%'],
|
||||
cascade: false
|
||||
}))
|
||||
.pipe(gulp.dest(dirs.dist + '/css'));
|
||||
});
|
||||
|
||||
14
package.json
14
package.json
@@ -1,20 +1,20 @@
|
||||
{
|
||||
"devDependencies": {
|
||||
"apache-server-configs": "2.13.0",
|
||||
"apache-server-configs": "2.14.0",
|
||||
"archiver": "^0.14.3",
|
||||
"del": "^1.1.1",
|
||||
"glob": "^5.0.1",
|
||||
"glob": "^5.0.5",
|
||||
"gulp": "^3.8.11",
|
||||
"gulp-autoprefixer": "^2.1.0",
|
||||
"gulp-header": "^1.2.2",
|
||||
"gulp-jscs": "^1.4.0",
|
||||
"gulp-jscs": "^1.5.1",
|
||||
"gulp-jshint": "^1.9.2",
|
||||
"gulp-load-plugins": "^0.9.0",
|
||||
"gulp-load-plugins": "^0.10.0",
|
||||
"gulp-rename": "^1.2.0",
|
||||
"gulp-replace": "^0.5.3",
|
||||
"jquery": "1.11.2",
|
||||
"jquery": "1.11.3",
|
||||
"jshint-stylish": "^1.0.1",
|
||||
"mocha": "^2.1.0",
|
||||
"mocha": "^2.2.4",
|
||||
"normalize.css": "3.0.3",
|
||||
"run-sequence": "^1.0.2"
|
||||
},
|
||||
@@ -40,5 +40,5 @@
|
||||
"build": "gulp build",
|
||||
"test": "gulp archive && mocha --reporter spec --timeout 5000"
|
||||
},
|
||||
"version": "5.1.0"
|
||||
"version": "5.2.0"
|
||||
}
|
||||
|
||||
@@ -189,6 +189,7 @@ textarea {
|
||||
}
|
||||
|
||||
@media print,
|
||||
(min-resolution: 1.25dppx),
|
||||
(min-resolution: 120dpi) {
|
||||
/* Style adjustments for high resolution devices */
|
||||
}
|
||||
|
||||
@@ -87,7 +87,7 @@ your site, for example) then you can queue up a domain name to be prefetched.
|
||||
|
||||
```html
|
||||
<link rel="dns-prefetch" href="//example.com">
|
||||
<link rel="dns-prefetch" href="//ajax.googleapis.com">
|
||||
<link rel="dns-prefetch" href="https://ajax.googleapis.com">
|
||||
```
|
||||
|
||||
You can use as many of these as you need, but it's best if they are all
|
||||
@@ -107,7 +107,7 @@ Amazon S3:
|
||||
Google APIs:
|
||||
|
||||
```html
|
||||
<link rel="dns-prefetch" href="//ajax.googleapis.com">
|
||||
<link rel="dns-prefetch" href="https://ajax.googleapis.com">
|
||||
```
|
||||
|
||||
Microsoft Ajax Content Delivery Network:
|
||||
@@ -356,7 +356,7 @@ value is boolean rather than a color. It's all or nothing.
|
||||
```
|
||||
|
||||
You can read about this useful element and more techniques in
|
||||
[Microsoft's documentation on adapting WebKit-oriented apps for IE10](http://blogs.windows.com/buildingapps/2012/11/15/adapting-your-webkit-optimized-site-for-internet-explorer-10/)
|
||||
[Microsoft's documentation on adapting WebKit-oriented apps for IE10](https://blogs.windows.com/buildingapps/2012/11/15/adapting-your-webkit-optimized-site-for-internet-explorer-10/)
|
||||
|
||||
## Search
|
||||
|
||||
|
||||
@@ -3,8 +3,6 @@ table of contents](TOC.md)
|
||||
|
||||
# Frequently asked questions
|
||||
|
||||
* [Why is the URL for jQuery without
|
||||
`http`?](#why-is-the-url-for-jquery-without-http)
|
||||
* [Why don't you automatically load the latest version of jQuery from the Google
|
||||
CDN?](#why-dont-you-automatically-load-the-latest-version-of-jquery-from-the-google-cdn)
|
||||
* [Why is the Google Analytics code at the bottom? Google recommends it be
|
||||
@@ -18,35 +16,6 @@ table of contents](TOC.md)
|
||||
|
||||
--
|
||||
|
||||
### Why is the URL for jQuery without `http`?
|
||||
|
||||
It is because of the use of [protocol-relative
|
||||
URLs](http://paulirish.com/2010/the-protocol-relative-url/).
|
||||
|
||||
**N.B.** If you try to view the local web page directly in the browser, the
|
||||
browser will fail to load the assets specified using protocol-relative URLs
|
||||
as it will attempt to fetch them from the local file system. We recommend you
|
||||
use a local HTTP server to test your web pages, or a file hosting service that
|
||||
allows you to preview your web pages online (e.g.
|
||||
[Dropbox](https://www.dropbox.com/)).
|
||||
|
||||
Setting up a local HTTP server can be done using there various
|
||||
[one-liners](https://gist.github.com/willurd/5720255):
|
||||
|
||||
* PHP 5.4.0+ by running
|
||||
[`php -S localhost:8080`](https://php.net/manual/en/features.commandline.webserver.php)
|
||||
from your local directory
|
||||
* Python 2.x by running `python -m SimpleHTTPServer` from your local directory
|
||||
* Python 3.x by running `python -m http.server` from your local directory
|
||||
* Ruby 1.9.2+ by running `ruby -run -ehttpd . -p8080` from your local directory
|
||||
* Node.js by installing and running either
|
||||
[`static -p 8080`](https://www.npmjs.org/package/node-static)
|
||||
or [`http-server -p 8080`](https://www.npmjs.org/package/http-server)
|
||||
|
||||
A list of more complex HTTP servers can be found
|
||||
[here](misc.md#servers-and-stacks).
|
||||
|
||||
|
||||
### Why don't you automatically load the latest version of jQuery from the Google CDN?
|
||||
|
||||
The [file](https://ajax.googleapis.com/ajax/libs/jquery/1/jquery.js) to which
|
||||
@@ -67,12 +36,12 @@ include a URL that will always point to the latest version, as that version:
|
||||
The main advantage of placing it in the `<head>` is that you will track the
|
||||
user's `pageview` even if they leave the page before it has been fully loaded.
|
||||
However, having the code at the bottom of the page [helps improve
|
||||
performance](http://stevesouders.com/efws/inline-scripts-bottom.php).
|
||||
performance](https://stevesouders.com/efws/inline-scripts-bottom.php).
|
||||
|
||||
|
||||
### How can I integrate [Bootstrap](http://getbootstrap.com/) with HTML5 Boilerplate?
|
||||
|
||||
One simple way is to use [Initializr](http://initializr.com) and create a
|
||||
One simple way is to use [Initializr](http://www.initializr.com/) and create a
|
||||
custom build that includes both HTML5 Boilerplate and
|
||||
[Bootstrap](http://getbootstrap.com/).
|
||||
|
||||
|
||||
@@ -18,7 +18,7 @@ By default, HTML5 Boilerplate provides two `html` pages:
|
||||
The `no-js` class is provided in order to allow you to more easily and
|
||||
explicitly add custom styles based on whether JavaScript is disabled
|
||||
(`.no-js`) or enabled (`.js`). Using this technique also helps [avoid the
|
||||
FOUC](http://paulirish.com/2009/avoiding-the-fouc-v3/).
|
||||
FOUC](https://www.paulirish.com/2009/avoiding-the-fouc-v3/).
|
||||
|
||||
|
||||
## Language attribute
|
||||
@@ -145,8 +145,8 @@ using some polyfill CDN service, like [cdn.polyfill.io](https://cdn.polyfill.io/
|
||||
just put it before the other scripts in the bottom of the page:
|
||||
|
||||
```html
|
||||
<script src="//cdn.polyfill.io/v1/polyfill.min.js"></script>
|
||||
<script src="//ajax.googleapis.com/ajax/libs/jquery/1.11.2/jquery.min.js"></script>
|
||||
<script src="https://cdn.polyfill.io/v1/polyfill.min.js"></script>
|
||||
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.2/jquery.min.js"></script>
|
||||
<script>window.jQuery || document.write('<script src="js/vendor/jquery-1.11.2.min.js"><\/script>')</script>
|
||||
<script src="js/plugins.js"></script>
|
||||
<script src="js/main.js"></script>
|
||||
|
||||
@@ -66,29 +66,6 @@ Apache as your web server, then you are encouraged to download a
|
||||
[server configuration](https://github.com/h5bp/server-configs) that corresponds
|
||||
to your web server and environment.
|
||||
|
||||
|
||||
### Servers and Stacks
|
||||
|
||||
A comprehensive list of web servers and stacks are beyond the scope of this
|
||||
documentation, but some common ones include:
|
||||
|
||||
* [Apache HTTP Server](https://httpd.apache.org/docs/trunk/getting-started.html)
|
||||
* [LAMP](https://en.wikipedia.org/wiki/LAMP_%28software_bundle%29)
|
||||
(Linux, Apache, MySQL, and PHP).
|
||||
Other variants include [MAMP](https://www.mamp.info/en/index.html),
|
||||
[WAMP](http://www.wampserver.com/en/),
|
||||
or [XAMPP](https://www.apachefriends.org/index.html).
|
||||
* LAPP uses PostgreSQL instead of MySQL
|
||||
* [Nginx](http://wiki.nginx.org/GettingStarted)
|
||||
* [LEMP](http://www.chrisjohnston.org/ubuntu-tutorials/setting-up-a-lemp-stack-ubuntu-904)
|
||||
is similar to the LAMP stack but uses Nginx
|
||||
* [IIS](https://en.wikipedia.org/wiki/Internet_Information_Services)
|
||||
* [ASP.NET](https://www.asp.net/get-started)
|
||||
* [MEAN](http://mean.io/) (MongoDB, Express, AngularJS, Node.js)
|
||||
|
||||
|
||||
### .htaccess
|
||||
|
||||
A `.htaccess` (hypertext access) file is a
|
||||
[Apache HTTP server configuration file](https://github.com/h5bp/server-configs-apache).
|
||||
The `.htaccess` file is mostly used for:
|
||||
|
||||
@@ -22,7 +22,7 @@
|
||||
<!-- Add your site or application content here -->
|
||||
<p>Hello world! This is HTML5 Boilerplate.</p>
|
||||
|
||||
<script src="//ajax.googleapis.com/ajax/libs/jquery/{{JQUERY_VERSION}}/jquery.min.js"></script>
|
||||
<script src="https://ajax.googleapis.com/ajax/libs/jquery/{{JQUERY_VERSION}}/jquery.min.js"></script>
|
||||
<script>window.jQuery || document.write('<script src="js/vendor/jquery-{{JQUERY_VERSION}}.min.js"><\/script>')</script>
|
||||
<script src="js/plugins.js"></script>
|
||||
<script src="js/main.js"></script>
|
||||
|
||||
Reference in New Issue
Block a user