Publishing
Because waiting for the auto-publish is for chumps.
Cascade is a giant database. When you submit your edits to Cascade, you are changing the database, but not your live site. In order for pages to go from Cascade to the live site, you must publish your work. Cascade's auto-publish feature runs 2-3 times a week for the A&S sites. But in order to see your work live, it's best to publish it yourself.
Publishing
To publish an asset in Cascade, select it, then click the Publish button in the upper right. Or, right-click on the asset in the directory tree, then select Publish.
Publishing is almost instantaneous for a single index page. But the more you publish with one click, the longer it takes. When you publish your root folder, Cascade has to publish everything in that folder, one item at a time. If you have a large site, this can take 10-20 minutes. Though you can publish your main folder every time you fix a typo, it seems unfair to make other people wait in the publish queue for that. If you need to publish the root folder, try to finish your work in Cascade before publishing it.
The general rule for publishing is that if a page changes, it must be published before the changes are live.
Cascade makes quite a few changes for us automatically. For example, when you edit the directory information on a directory page, that information is automatically updated on the listing (or index) page. Cascade is smart enough to make those changes, but is not smart enough to publish them. You have to keep track of that.
Here's a chart to help you decide what to publish when:
After you have |
Publish this |
| Edited a single asset (page, pdf) | Publish only that item |
| Edited several items that are located in several different folders | Publish the root folder (the whole site) |
| Made a change to a menu by editing the Display name of a folder | Publish the edited folder's parent. |
| Made a change to a menu by reordering items within a folder | Publish that folder |
| Borrowed or added a new news story |
Publish
|
| Borrowed or added a new directory page |
Publish
|
| Added to the menu by adding a folder with content page |
Publish the parent of the new folder. |
| Created a new widget or listbox, then added the item to a page |
Publish
|
| Uploaded a new image or pdf, then added the image to a page or created a link to the pdf |
Publish
|
Publishing errors are common. If you can see the change you've made in Cascade, but don't see it on the live site, make sure you've published everything that has changed as a result of your work.
Unpublishing
Un-publish will take an item off the live site but leave it in Cascade for future use. But the auto-publish will put it right back out there unless you turn publish off the item.
- If you want a folder (and all its contents) to remain un-published, edit the folder, select "Properties" at the top (this has an icon that looks like a gear), then un-check the Include when publishing checkbox.
- To keep an individual page un-published, edit the page, select "Configure" at the top (again with the gear icon), and un-check Include when publishing.
Note that if you un-publish an item that is on the menu, you need to also turn off the folder's Display on menu option. Otherwise, the folder will still show up on the live site's menu, but will give a broken link when someone clicks on it.
More information
Web & Design's publishing help page.
