Publishing

Staging and publishing

ewok uses a staging/publishing model that allows users to create content in a working area (staging) and then publish when complete. Publishing involves rendering the content page using the appropriate ewok template, rewriting URLs for the published area (if necessary), and saving the result as static HTML. These published pages can then be served by any webserver - ewok is not required to be installed. This model allows the flexibility and power of dynamic component-based templates for authoring, but the performance benefits of static html for published pages.

How to publish

Publishing is done from within the ewok file manager using the "Publish" button in the group of buttons below the current directory listing.

[ NB: If no "Publish" button appears, this means either that the directory has not been configured for publishing, or that you do not have publish permissions for the directory; in either case you should speak to your ewok administrator. For instructions on setting up publishing, see Configuring publishing in the ewok Admin Guide. ]

To publish:

1. Select the files or directories you want to publish using the checkboxes, OR select the 'Entire directory' or 'Entire tree' Scope options, and press 'Publish'.
2. Use the Scope buttons to change the scope of your selection, if required
3. Check any options that you want to use. The following options are defined:
4. • Test: report what files would be published, but don't do any actual updates
   • Refresh: publish only if a published version already exists (very useful for directory and tree publishes where you may have test pages you wish to ignore)
   • Force: always publish, even if the published version appears up to date (by default ewok only publishes when the page has changed)
   • Copy links: for links, publish as a separate copy rather than a link
   • Sync deletes: delete files on the published side that are not present in the staging area
5. If multiple publishing areas (targets) exists for this directory, select the target to publish to
6. Click Publish.

This publishes the selected (changed) files, and presents a list of links to all published pages, as well as any errors or warnings, and navigation links to return to the ewok file manager for the Staging directory (and, if configured appropriately, the Publish directory).