KB Version:

Page Navigation

Related Links

Learning Levels

Most Read

Announcements RSS Feed of Announcements

New Site Scaffold

Digest

The new site scaffold is a time-saving convenience tool used to setup site-specific folders and related system components that otherwise must be created manually. The new site scaffold can can be used in one of two ways. If building a site completely from scratch, the new site scaffold can be used to simply create a site folder structure (based on established best practices), and required site-specific system components. Secondly, if you're importing an existing site into Cascade, the new site scaffold can be used to do all of that plus create a template and configuration set, then import all your pages from a zip file and base them on this new template.

Concept

Required and Optional New Site Scaffold Fields

When you run the new site scaffold, the user is prompted for three items: a site name, a template, and a zip upload. The site name is required, as the sites base folder and subsequently created system components are based on this name. Template upload and zip upload are optional. These fields are used to import existing sites into Cascade.

Technical

Accessing the New Site Scaffold


To access the New Site Wizard, navigate to: Tools -> New Scaffold

new site wizard 

The "Site Name" field is required, as it's used as the name for most of the components set up for you. If you only supply a site name, then the new site scaffold will create the assets and components laid out in the first section below. wiza

The "Template Upload" field is not required, but if supplied, will accept any HTML page properly marked-up with Dreamweaver style region tags, convert it to a Cascade template, and create an associated configuration set. As asset factory and asset factory asset are also created based on this new template.

The "Zip Upload" field is also not required, but if supplied, accepts a zip of all the assets in your site. It will convert the HTML pages to Cascade pages by stripping out everything except the default region content and relating the page to the new configuration set.

Actions taking place when using New Site Scaffold

When the new site scaffold is run without the user supplying site data, the following actions happen (with associated settings):

  1. Create a new site base folder structure
    • System Name: SiteName
    • Parent Folder: /
    • Publish: checked
    • Index: checked
    • User Metadata: -none-
    • Metadata Set: SiteName/Standard
  2. Create folder for internal assets
    • System Name: "_internal"
    • Parent Folder: new site folder
    • Publish: unchecked
    • Index: unchecked
    • User Metadata: -none-
    • Metadata Set: SiteName/Standard
  3. Create 4 subfolders for internal assets
    • System Name: "asset factories," "blocks," "stylesheets," and "templates"
    • Parent Folder: new site folder/_internal
    • Publish: unchecked (all)
    • Index: unchecked (all)
    • User Metadata: -none-
    • Metadata Set: SiteName/Standard
  4. Create new group
    • Group Name: SiteName
    • Starting Page: -none-
    • Base Folder: new site folder
    • Asset Factory Container: new asset factory container (created next)
    • CSS Classes: -none-
    • WYSIWYG Toolbar Options: all unchecked
    • Users: user that created new site
    • Roles: Manager
  5. Create new asset factory container
    • Name: SiteName
    • Parent Container: /
    • Applicable groups: new group
  6. Create new configuration set container
    • Name: SiteName
    • Parent Container: /
  7. Create new data definition container
    • Name: SiteName
    • Parent Container: /
  8. Create new metadata set container
    • Name: SiteName
    • Parent Container: /
  9. Create new metadata set
    • Name: "Standard"
    • Parent Container: /
    • Wired Fields: all visible, none required
    • Dynamic Fields: -none-
  10. Create new publish set container
    • Name: SiteName
    • Parent Container: /
  11. Create new target
    • Name: SiteName
    • Parent Target: /
    • Base Folder: new site folder
    • Output File Extension: ".html"
    • CSS Classes: -none-
    • CSS File: -none-
    • Type of Data: "HTML"
    • XML Declaration: unchecked
    • Internal Links: unchecked
    • Publishing: unchecked
    • Scheduled Publishing: unchecked
    • Publish Target on a Schedule: 01 00 AM
    • Publish Every: 0 Hours
  12. Create new workflow definition container
    • Name: SiteName
    • Parent Container: /

Actions taking place when using New Site Scaffold with Template Upload only

When the new site scaffold is run with the user supplying only a template upload, all the preceding actions happen plus the following (with associated settings):
  1. Create template based on the supplied page in "Template Upload" field
    • System Name: SiteName
    • Parent Folder: SiteName/_internal/templates
    • Target: new target
    • XML: resulting XML produced by Cascade's XHTML conversion process
    • Stylesheet: -none-
    • Regions: "DEFAULT" plus any other regions defined in the imported template
    • Region Blocks: any library items defined in template will be converted to blocks and linked here
    • Region Stylesheets: -none-
  2. Convert each library item from imported template into an XHTML block (if applicable)
    • System Name: name of library item in template
    • Parent Folder: SiteName/_internal_blocks
    • User Metadata: -none-
    • Metadata Set: SiteName/Standard
    • Content: html code from template region in a WYSIWYG editor
  3. Create asset factory asset based on new template
    • System Name: SiteName
    • Parent Folder: SiteName/_internal/asset factories
    • Configuration Set: SiteName/Standard
    • Data Definition: -none-
    • Use Data Definition: unchecked
    • Rewrite Links: unchecked
    • Publish: checked
    • Index: checked
    • Content: -none-
  4. Create a new configuration set
    • Name: "Standard"
    • Parents Container: /new configuration set container
    • Configuration Name: "XHTML"
    • Configuration Template: new template
    • Global Stylesheet: -none-
    • Default Configuration: checked
    • Regions: "DEFAULT" plus any other regions defined in the imported template
    • Region Blocks: any library items defined in template will be converted to blocks and linked here
    • Region Stylesheets: -none-
  5. Create a new asset factory
    • Name: "Page"
    • Parent Container: /new asset factory container
    • Asset Type: page
    • Base Asset: new asset factory asset
    • Placement Folder: new site folder
    • Subfolder Placement: unchecked
    • Folder Placement Position: -none-
    • Overwrite: unchecked
    • Groups: new group
    • Workflow Mode: Folder Controlled
    • Plugins: -none-

Actions taking place when using New Site Scaffold with Template Upload and Zip Upload

When the new site scaffold is run with the user supplying a template upload and a zip upload, all the preceding actions happen plus the following (with associated settings):
  1. Create pages from default region of each html file in zip upload
    • System Name: original asset name in zip
    • Parent Folder: new site folder
    • Configuration Set: new configuration set
    • Data Definition: -none-
    • Use Data Definition: unchecked
    • Rewrite Links: unchecked
    • Publish: checked
    • Index: checked
    • User Metadata: mapped from meta info in original pages head
    • Metadata Set: SiteName/Standard

Related Links