diff --git a/Troubleshooting.md b/Troubleshooting.md index 7092587..b965f4b 100644 --- a/Troubleshooting.md +++ b/Troubleshooting.md @@ -18,6 +18,8 @@ * [Fonts not rendering properly running Windows 10](#fonts-not-rendering-properly-running-windows-10) * [bower.json not including css file in main](#bowerjson-not-including-css-file-in-main) +--- + #### Some icons don't show up Check the following: @@ -30,9 +32,13 @@ Check the following: 7. Your browser's extensions are not blocking webfonts (noscript, adblockplus, etc.); 8. Your operating system is not blocking webfonts (Microsoft Group Policy). +--- + #### I'm developing my web app locally (file://) and icons from CDN don't show up Please check that you are not using [protocol relative urls](http://www.paulirish.com/2010/the-protocol-relative-url/). In that case, you should add `https:` in front of the CDN link. +--- + #### I'm hosting fonts on my server and icons don't show up Check the following: @@ -41,11 +47,15 @@ Check the following: 3. **For Internet Explorer**: you don't serve files with `no-store` option in Cache-control header (Ref: [#6454](https://github.com/FortAwesome/Font-Awesome/issues/6454)); 4. **For Internet Explorer and HTTPS**: you don't serve files with `no-cache` option in Pragma header. +--- + #### Some brand icons are missing You (or your customers) are probably using Adblock Plus. If the "Remove Social Media Buttons" option is enabled, you will miss some brand icons. Ref: [#1799]( https://github.com/FortAwesome/Font-Awesome/issues/1799) for more information. +--- + #### Internet Explorer Compatibility Mode This feature will cause some random issues with IE, so please disable it by adding the meta tag as the **FIRST** tag in your `
`: ```html @@ -54,6 +64,8 @@ This feature will cause some random issues with IE, so please disable it by addi Refs: [#4144](https://github.com/FortAwesome/Font-Awesome/issues/4144) and [stackoverflow](https://stackoverflow.com/questions/27913012/font-awesome-4-2-0-not-rendering-in-ie11-with-compatibility-mode-turned-on/28490514#28490514) +--- + #### Internet Explorer 8 caveats If you are using IE8, it's necessary to add the html5.js script like: ```css @@ -65,6 +77,8 @@ Note that you may still have random issues with this browser. Refs: [#954](https://github.com/FortAwesome/Font-Awesome/issues/954), workaround available at [#954-comment](https://github.com/FortAwesome/Font-Awesome/issues/954#issuecomment-65414146) +--- + #### Need a blank/empty icon Icons do not have the same width by design choice, so a blank icon is pretty useless. You should use `fa-fw` if you need a placeholder. If you perform database validation, allow the blank value. @@ -72,6 +86,8 @@ Please take a look at this fiddle: http://jsfiddle.net/tagliala/7z9b557v/ Ref: [#1606](https://github.com/FortAwesome/Font-Awesome/issues/1606) +--- + #### Reveal.js According to your Font Awesome version, please add this to your stylesheets: @@ -84,11 +100,15 @@ According to your Font Awesome version, please add this to your stylesheets: Ref: [#2131](https://github.com/FortAwesome/Font-Awesome/pull/2131) +--- + ### ie7-js FontAwesome is not compatible with [ie7-js](https://code.google.com/p/ie7-js/). (more info on [#2171](https://github.com/FortAwesome/Font-Awesome/issues/2821)) +--- + #### Stack icons inside Wordpress posts Wordpress automatically adds a `