Markup Conventions

All markup and output from Mura CMS is based on Web Standards, and is logically structured and semantically correct.

It is important to keep in mind that there is nothing "special" about markup from Mura CMS. If you are converting a site to Mura that follows Web Standards, your conversion should go very smoothly. That being said, converting a site that doesn't follow web standards is also possible, you may just have to either customize Mura to follow your own standards or update your markup to follow Web Standards.

Mura's Default Document Structure as an Outline

If one was to look at the markup structure as an outline, it would follow the following structure:

  • <h1> Site Name/Logo
    • <ul class="navUtility"> Utility Navigation
    • <form class="svSearch"> Search Form
    • <ul id="navPrimary"> Primary Navigation
    • <h2 class="pageTitle"> Page Title ("Title" field when editing)
      • <h3> First Subhead (Subhead 1 when using the "Format" dropdown in the editor) and any Content Object Headings
      • <h4> Second Subhead (Subhead 2 when using the "Format" dropdown in the editor)
      • <h5> Third Subhead (Subhead 3 when using the "Format" dropdown in the editor)
      • <h6> Fourth Subhead (Subhead 4 when using the "Format" dropdown in the editor)

Of course, below any of the headings any number of valid elements can be used.

Changing the default Logical Structure

Depending on the context of your content and whether or not you need your page title's to be <h1>'s instead of <h2>'s for SEO or other purposes, you can change the default structure in Mura:

  1. Open your sites' contentRenderer.cfc (/{siteid}/includes/contentRenderer.cfc)
  2. Uncomment and edit the following to reflect your preferred structure, for instance: 
    <cfset this.headline="h1"/>
    <cfset this.subHead1="h2"/>
    <cfset this.subHead2="h3"/>
    <cfset this.subHead3="h4"/>
    <cfset this.subHead4="h5"/>
<cfset this.subHead5="h6"/>
  3. Update FCKEditor to follow your new structure. It's a little tedious, but you only need to do it once. CKEditor 3 should make this step much easier or allow us to eliminate it altogether one Mura is updated to use this version.