robjohnston / wet-boew-razor

ASP.NET Razor variant of the Web Experience Toolkit (WET)

wet-boew-razor

ASP.NET Razor variant of the Web Experience Toolkit (WET)

Requirements

• ASP.NET Core 3.1

Highlights

• GC Intranet theme v4.0.27
• Localized page partials for English and French.
• Uses libman to automatically pull in the WET-BOEW theme files and dependencies upon build
  • Doesn't include the IE 8 files
  • Only has the English and French localizations (if you need more, add to the libman.json file)
  • Doesn't include MathJax due to its size (if you need it, uncomment reference in the libman.json file)

TODO

• Toggle the search on or off.
• Content pages for signed-on and signed-off.
• Can the breadcrumb and secondary menu be constructed via a sitemap file?

---

Purpose

This theme adapts the Government of Canada Web Usability theme for intranet sites using ASP.NET razor pages.

Use when

This theme can be used on Government of Canada intranet sites (including web applications).

Do not use when

This theme can only be used on Government of Canada intranet sites.

Working example

English and French examples available from the "Index" page of the application.

How to implement

General instructions

1. Use the *.cshtml files to create your Web pages.
2. Optional: Create, install and link to one or more new CSS files (will be used for custom CSS)
3. All *.css, *.js, and *.gif file paths referenced in the partial files should be pulled in upon build by libman.
4. Replace the page title by setting ViewData["Title"].
5. Correct the metadata values in ViewData["Description"], ViewData["Subject"], ViewData["Issued"] values

Server instructions

Configure Custom HTTP Headers to emit "X-UA-Compatible" "IE=Edge". Instructions on configuring IIS (English / French) or Apache (English / French) can be found on MSDN. This setting will ensure Internet Explorer 8, 9, and 10 will use their most recent rendering engine, as opposed to "Compatibility Views".

Content page-specific instructions (content-*.cshtml)

• Correct the menu bar links or remove the menu bar
• Set the supported cultures (e.g., en-CA and fr-CA) in StartUp.cs.
• Optional: Set a sub-site title by including ViewData["SubSiteName"] on a page.
• Optional: Implement the secondary menu (maximum of 2 levels)
• Correct the search field or remove the search field
• Correct the breadcrumb trail or remove the breadcrumb trail
• Correct the Transparency link or remove the Transparency link
• Correct the site footer links
• Set ViewData["Modified"] to include the Date Modified field on a page and in metadata.

Splash page-specific instructions (splashpage-*.shtml)

1. Correct the English and French language links

Server message page-specific instructions (serv*.html)

1. Replace the English and/or French messages.

Source code

• Government of Canada Intranet theme source code on GitHub
• Government of Canada Intranet theme demo pages source code on GitHub
• wet-boew-razor