mirror of
https://github.com/gwenhael-le-moine/ledgerrb.git
synced 2025-02-11 08:48:11 +01:00
94 lines
4.3 KiB
Markdown
94 lines
4.3 KiB
Markdown
|
[HTML5 Boilerplate homepage](http://html5boilerplate.com) | [Documentation
|
||
|
|
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
|
||
|
|
placed in the `<head>`.](#why-is-the-google-analytics-code-at-the-bottom-google-recommends-it-be-placed-in-the-head)
|
||
|
|
* [How can I integrate Bootstrap with HTML5
|
||
|
|
Boilerplate?](#how-can-i-integrate-bootstrap-with-html5-boilerplate)
|
||
|
|
* [Do I need to upgrade my site each time a new version of HTML5 Boilerplate is
|
||
|
|
released?](#do-i-need-to-upgrade-my-site-each-time-a-new-version-of-html5-boilerplate-is-released)
|
||
|
|
* [Where can I get help with support
|
||
|
|
questions?](#where-can-i-get-help-with-support-questions)
|
||
|
|
|
||
|
|
--
|
||
|
|
|
||
|
|
### 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
|
||
|
|
the Google [CDN](https://en.wikipedia.org/wiki/Content_delivery_network) points
|
||
|
|
to is [no longer updated and will stay locked at version `1.11.1` in order to
|
||
|
|
prevent inadvertent web
|
||
|
|
breakage](http://blog.jquery.com/2014/07/03/dont-use-jquery-latest-js/).
|
||
|
|
|
||
|
|
In general, version updating should be an intentional decision! You shouldn't
|
||
|
|
include a URL that will always point to the latest version, as that version:
|
||
|
|
|
||
|
|
* may not be compatible with the existing plugins/code on the site
|
||
|
|
* will have a very short cache time compare to the specific version,
|
||
|
|
which means that users won't get the benefits of long-term caching
|
||
|
|
|
||
|
|
### Why is the Google Analytics code at the bottom? Google recommends it be placed in the `<head>`.
|
||
|
|
|
||
|
|
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).
|
||
|
|
|
||
|
|
|
||
|
|
### How can I integrate [Bootstrap](http://getbootstrap.com/) with HTML5 Boilerplate?
|
||
|
|
|
||
|
|
One simple way is to use [Initializr](http://initializr.com) and create a
|
||
|
|
custom build that includes both HTML5 Boilerplate and
|
||
|
|
[Bootstrap](http://getbootstrap.com/).
|
||
|
|
|
||
|
|
Read more about how [HTML5 Boilerplate and Bootstrap complement each
|
||
|
|
other](https://www.quora.com/Is-Bootstrap-a-complement-or-an-alternative-to-HTML5-Boilerplate-or-viceversa/answer/Nicolas-Gallagher).
|
||
|
|
|
||
|
|
|
||
|
|
### Do I need to upgrade my site each time a new version of HTML5 Boilerplate is released?
|
||
|
|
|
||
|
|
No, same as you don't normally replace the foundation of a house once it
|
||
|
|
was built. However, there is nothing stopping you from trying to work in the
|
||
|
|
latest changes, but you'll have to assess the costs/benefits of doing so.
|
||
|
|
|
||
|
|
|
||
|
|
### Where can I get help with support questions?
|
||
|
|
|
||
|
|
Please ask for help on
|
||
|
|
[StackOverflow](https://stackoverflow.com/questions/tagged/html5boilerplate).
|