Mise en œuvre de la BOEW

Needs translation

The following is a short overview for people who want to use WET for their websites.

What You Need

The following are the only two folders you need to take from the WET project:

  • The dist folder includes all the components used to create a WET page. Files in this folder should not be changed as they has been compiled specifically though a build process. Note: WET v3.0.2 and earlier included these components in the build folder.
  • The demos folder includes the html files for the website. It does not have to be named "demos". Currently, this folder includes a series of sample files showing WET functionality. You won't need any of this for your website.

Creating a WET site (example)

  1. Remove all of the files and folders from the "demos" folder except for:
    1. index-en.html
    2. index-fr.html
    3. theme-gcwu-fegc
    4. includes
  2. Rename the "demos" folder to whatever you want.
  3. Open theme-gcwu-fegc and remove all files except cont-secnav1-en.html and cont-secnav1-fr.html (Note: You will have a lot more files here as you develop your website; but only two will be used in this example).
  4. Open cont-secnav1-en.html using any Web editor. Notice where the style sheets and jQuery files are being called. The .js files are now all included at the bottom of the page. All of these components are located in the dist folder. These should not be changed, however, you can add your own style sheets as well. Note: The paths to the style sheets and jQuery will have to be changed depending upon where it's located in the folder structure. Keep this in mind as you develop.
  5. Edit the metadata, page title, and content area.
  6. Edit the menu bar located under: <nav role="navigation"> Change the link text and adding hyperlinks for the seven list items that represent the horizontal menu bar at the top of the page. You can add an remove list items as necessary, however, there is a limit to how much space the top menu bar has.
  7. The extended bar that displays when the mouse hovers over the horizontal menu bar is included in the code here: <ul class="mb-menu" data-ajax-replace="../includes/menu-fr.txt">

You can edit the menu-en.txt file to include whatever links you like.

You now have a working WET Web page!

Using jQuery plugins

Plugins are created using a class-based system. In order to use a plugin in your html, just call the plugin using a class named wet-boew-pluginname. For example, to use the zebra plugin, your table tag must include a class with the name "wet-boew-zebra": <table class="wet-boew-zebra">

Plugins have a series of different classes that can be used to style and change the functionality. View the sample pages in the demos folder to see how different plugins and functionality can be applied in your website.

List of examples of plugins and how to use them.

Migrating pages from WET 2.3 to WET 3

There are a variety of differences in the HTML for a page using WET 2.3 and a WET 3 page. When migrating a page from version 2.3 to 3, be aware of these changes and implement them in your code.

HTML Tag

WET 3.0 uses IE conditional statements which change the classes in the html tag based on what browser is viewing the page.

WET 2.3

<html lang="en">

WET 3.0

<--[if IE 7]> <html lang="en" class="no-js ie7"> <![endif]-->
<--[if IE 8]> <html lang="en" class="no-js ie8"> <![endif]-->
<--[if gt IE 8]><!-->
<html lang="en" class="no-js">
<--<![endif]-->

Viewport metadata

WET 3.0 has an extra metadata element for the viewport.

WET 3.0

<meta name="viewport" content="width=device-width, initial-scale=1" />

JQuery loading

JQuery is loaded differently in WET 3. All JavaScript files (except for jQuery itself) are loaded at the end of the body element.

Style sheet loading

Style sheets are still loaded using conditional statements, however, in the newer version of WET, there are only two statements. Style sheets are now loaded based on whether the browser is less than or equal to IE 8, or greater than IE 8 (which also includes browsers that are not IE).

WET 2.3

<link href="../css/base.css" rel="stylesheet" />
<--[if IE 6]><![endif]-->
<--[if IE 8]><link href="../css/base-ie8.css" rel="stylesheet" /><![endif]-->
<--[if IE 7]><link href="../css/base-ie7.css" rel="stylesheet" /><![endif]-->
<--[if lte IE 6]><link href="../css/base-ie6.css" rel="stylesheet" /><![endif]-->
<-- CSSStart -->
<link href="css/theme-clf2-nsi2.css" rel="stylesheet" />
<--[if IE 7]><link href="css/theme-clf2-nsi2-ie7.css" rel="stylesheet" /><![endif]-->
<--[if lte IE 6]><link href="css/theme-clf2-nsi2-ie6.css" rel="stylesheet" /><![endif]-->
<-- CSSEnd -->

WET 3.0

<--[if lte IE 8]>
<script src="../../js/polyfills/html5shiv-min.js"></script>
<link rel="stylesheet" href="../grids/css/util-ie-min.css" />
<link rel="stylesheet" href="../js/css/pe-ap-ie-min.css" />
<link rel="stylesheet" href="../../theme-gcwu-fegc/css/theme-ie-min.css" />
<[endif]-->
<--[if gt IE 8]><!-->
<link rel="stylesheet" href="../../grids/css/util-min.css" />
<link rel="stylesheet" href="../../js/css/pe-ap-min.css" />
<link rel="stylesheet" href="../../theme-gcwu-fegc/css/theme-min.css" />
<--<![endif]-->

Class names

Most of the class names are different in this version of WET (full list of changes from v2.3 to v3.0). The most common changes include:

  • "cn" is often changed to either wb or gcwu.
    • "wb" stands for WET/BOEW, and should remain the same regardless of theme.
    • "gcwu" is a prefix used to define sections from the GC Web Usability Theme.
  • Themes should use prefixes to avoid conflict with non-WET CSS.

    WET 2.3

    <ul id="cn-tphp">
 <li id="cn-sh-link-1"><a href="#cn-cont">Skip to main content</a></li>
 <li id="cn-sh-link-2"><a href="#cn-nav">Skip to side navigation</a></li>
    and 
    <div id="cn-bcrumb"><h2>Breadcrumb trail</h2>

    WET 3.0

    <ul id="wb-tphp">
 <li id="wb-skip1"><a href="#wb-cont">Skip to main content</a></li>
 <li id="wb-skip2"><a href="#wb-nav">Skip to side navigation</a></li>
    and 
    <div id="gcwu-bc"><h2>Breadcrumb trail</h2>
  • Longer class names have been shortened.

    WET 2.3

    <body>
 <div id="cn-body-inner-1col>

    WET 3.0

    <body>
 <div id="wb-body>

Mobile support

Although there isn't any code to change in the HTML for mobile support, be aware of WET's new support for mobile. Since WET 3 switches to mobile view based on browser size, this is easy to test on a desktop. Open up any browser aside from IE and resize your page horizontally so that it's smaller than the content area. The page should change to mobile view.

Note: A great tool for testing Web pages for mobile is in the "test" folder included with WET.

Additional note: The period in the folder for jquery.mobile may cause an issue, this can be alleviated by simply renaming the folder and adjusting the reference to that folder in build/js/pe-ap.min.js (period has been removed in v3.0.1)

Browser support

WET 3.0 uses polyfills, which are essentially a way to automatically properly display pages using any browser. It provides functionality that isn't natively available in a Web browser. For example, polyfills will solve the issue of HTML5 tags that don't work natively on some browsers by loading JavaScript to mimic that functionality. This means that when coding a page, you don't have to worry about certain tags not working on different browsers.

Server configuration

Ajax megamenu MIME type

Note: File extension changed to .txt in v3.0.1 (no need to change the file extension if it already works).

WET v3.0 requires .inc to be mapped to the text/html MIME type in the server configuration for some servers to be able to support AJAXing in the the mega menu (which is done by default with WET v3.0). For example, IIS 5 renders the MegaMenu correctly (drop-downs, down-arrow image, etc.), while IIS 7.5 does not. If the .inc file extension is used for server-side code (As is common in IIS), rename the menu file to another extension and map that extension to the text/html MIME type.

IE Compatibility Mode

By default, IE displays Intranet web pages using Compatibility View (IE7 standards mode). This causes display and JavaScript problems with the WET template. To fix the problem, configure your web server to send the "X-UA-Compatible" "IE=Edge" HTTP header. Instructions for configurer IIS and for configurer Apache can be found on MSDN. The HTTP header ensures that IE 8, 9, and 10 use their most recent rendering engine, as opposed to Compatibility View.

Note: Setting the meta tag in the HTML document (<http-equiv="X-UA-Compatible" content="IE=edge" />) will '''not''' work for WET because of the conditional comments that configure the HTML element at the top of the page. These conditional comments force IE's rendering engine and the meta tag can't override it:

<!--[if IE 7]><html lang="en" class="no-js ie7"><![endif]-->
<!--[if IE 8]><html lang="en" class="no-js ie8"><![endif]-->
<!--[if gt IE 8]><!-->

Troubleshooting

It is possible for public facing, Internet webpages to display in Compatibility View because of user or administrator settings:

To troubleshoot display problems in IE 8 and above, use the Présentation des outils de développement F12 which are accessible by pressing F12 on your keyboard:

F12 Developer Tools showing a web page rendering in Compatibility View
F12 Developer Tools showing a web page rendering in Compatibility View

Fixing a web page that's displaying in Compatibility View can be accomplished by:

  1. sending the "X-UA-Compatible" "IE=Edge" HTTP header,
  2. disabling the user or administrator setting that is triggering Compatibility View, or
  3. configuring the group policy objects that control Compatibility View.

Related pages