add html boilerplate
[tools.git] / doc / faq.md
Maxious 1 [HTML5 Boilerplate homepage](http://html5boilerplate.com) | [Documentation
2 table of contents](README.md)
3
4 # Frequently asked questions
5
6 ### Why is the URL for jQuery without "http"?
7
8 This is an intentional use of [protocol-relative
9 URLs](http://paulirish.com/2010/the-protocol-relative-url/)
10
11 **N.B.** Using a protocol-relative URL for files that exist on a CDN is
12 problematic when you try to view your local files directly in the browser. The
13 browser will attempt to fetch the file from your local file system. We
14 recommend that you use a local server to test your pages (or Dropbox). This can
15 be done using Python by running `python -m SimpleHTTPServer` from your local
16 directory, using Ruby by installing and running
17 [asdf](https://rubygems.org/gems/asdf), and by installing any one of XAMPP,
18 MAMP, or WAMP.
19
20
21 ### Why don't you automatically load the latest version of jQuery from the Google CDN?
22
23 1. The latest version of jQuery may not be compatible with the existing
24 plugins/code on the site. Version updating should be an intentional
25 decision.
26 2. The latest version has a very short `max-age=3600` compares to the specific
27 version of `max-age=31536000`, which means you won't get the benefits of
28 long-term caching.
29
30
31 ### Why is the Google Analytics code at the bottom? Google recommends it be placed the `head`.
32
33 The advantage to placing it in the `head` is that you will track a user's
34 pageview even if they leave the page before it has been fully loaded. However,
35 putting the code at the bottom keeps all the scripts together and reinforces
36 that scripts at the bottom are the right move.
37
38
39 ### How can I integrate [Twitter Bootstrap](http://twitter.github.com/bootstrap/) with HTML5 Boilerplate?
40
41 You can use [Initializr](http://initializr.com) to create a custom build that
42 includes HTML5 Boilerplate with Twitter Bootstrap.
43
44 Read more about how [HTML5 Boilerplate and Twitter Bootstrap complement each
45 other](http://www.quora.com/Is-Bootstrap-a-complement-OR-an-alternative-to-HTML5-Boilerplate-or-viceversa/answer/Nicolas-Gallagher).
46
47
48 ### How do I prevent phone numbers looking twice as large and having a Skype highlight?
49
50 If this is occurring, it is because a user has the Skype browser extension
51 installed.
52
53 Use the following CSS to prevent Skype from formatting the numbers on your
54 page:
55
56 ```css
57 span.skype_pnh_container {
58 display: none !important;
59 }
60
61 span.skype_pnh_print_container {
62 display: inline !important;
63 }
64 ```
65
66
67 ### Do I need to upgrade my sites each time a new version of HTML5 Boilerplate is released?
68
69 No. You don't normally replace the foundations of a house once it has been
70 built. There is nothing stopping you from trying to work in the latest changes
71 but you'll have to assess the costs/benefits of doing so.
72
73
74 ### Where can I get help for support questions?
75
76 Please ask for help on
77 [StackOverflow](http://stackoverflow.com/questions/tagged/html5boilerplate).
78