Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

CDNs are recommended for the following CSS files.  CSS fies referenced on CDNs should also be placed in the resource server so they are available when off-line in an emergency (see above).

  • Font Awesome

Resources Preferred way to access resources from a CDN should use the resourceURL tag library to load them rather than accessing the CDNs directly.  This allows the URL to be modified to a non-minified version when aggregation is disabled or running in off-line mode (though the resourceURL tag currently does not do this).  E.g. access like:

...

is to put them in a skin.xml file and use the rs:aggregatedResources tag so you get the non-minified versions when desired.  

Code Block
languagexml
titlePreferred way to access CDN content
skin.xml:
 
<resources xmlns="http://www.jasig.org/uportal/web/skin"  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://www.jasig.org/uportal/web/skin https://source.jasig.org/schemas/resource-server/skin-configuration/skin-configuration-v1.2.xsd">
 
  <css included="plain">//maxcdn.bootstrapcdn.com/font-awesome/4.1.0/css/font-awesome.css</css>
  <css included="aggregated">//maxcdn.bootstrapcdn.com/font-awesome/4.1.0/css/font-awesome.min.css</css>

</resources>
 
JSP file:
 
<rs:aggregatedResources path="skin.xml"/>

The alternative is to load them from the CDNs directly as you would in any webapp.

Code Block
languagexml
titlenon-preferred way to access CDN content
<link rel="stylesheet" href="

...

//maxcdn.bootstrapcdn.com/font-awesome/4.1.0/css/font-awesome.min.css

...

" type="text/css"/>

...

CSS Scoping

You'll notice in the first example above in CSS Loading that immediately after the CSS <link> element is a div with a class name specific to the portlet web application. This div is used to scope all style rules created for the portlet.

...