ewok Frequently Asked Questions

Contents

• Version / Homepage
• General / Features
• What is ewok?
• What environment do I need to run ewok?
• Can I install ewok in a web hosting environment as an ordinary user (i.e. without root)?
• Does ewok work on windows?
• Why "ewok"? Does it stand for anything?
• User Questions
• Why isn't text markup working properly?
• How do I get automatic contents sections?
• Is there an easy way to do page redirects?
• Admin Questions
• How do I setup a staging or publishing directory?
• I still need help!

Version / Homepage

This FAQ refers to ewok version 0.5.0. The ewok homepage is at http://www.openfusion.com.au/labs/ewok/, and the latest version of this FAQ can be found there at http://www.openfusion.com.au/labs/ewok/doc/faq.html.

General / Features

What is ewok?

ewok is a full-featured content management system written in Perl. For the full blurb, see the README.

What environment do I need to run ewok?

• a Unix-based Apache with mod_perl support
• root or apache user access
• the following Perl modules installed:
• • HTML::Embperl (1.3.4 recommended)
  • URI::Escape
  • File::DirSync
  • Config::Directory
  • HTML::Breadcrumbs
• apache authentication configured for at least the ewok staging directories

Can I install ewok in a web hosting environment as an ordinary user (i.e. without root)?

Perhaps, but generally it isn't what you want to do. You're better off running ewok on a machine over which you have full control (at home, or on a corporate intranet), and then mirroring your published content onto your web host. If you need dynamic pages, you can generally just embed your dynamic content into an ewok page body (using whatever technology your web host provider supports - Embperl, Mason, PHP, ASP, etc.), and then just publish as normal.

Does ewok work on windows?

Not at this point.

Why "ewok"? Does it stand for anything?

Not really. I think it originally morphed out of something like EmbperlObject Web Kit, because EOWK just didn't seem quite as catchy. :-)

User Questions

Why isn't text markup working properly?

This is usually because the escape_html and markup* metadata items for the file or directory aren't set correctly. If you want to use HTML in your page then escape_html should be set to 'No'; if you're using particular text markup features make sure any markup_X metadata item for the features you need are set to 'Yes'.

How do I get automatic contents sections?

If you want to add an automatic contents section to the beginning of a page (indexing <H1>, <H2>, etc. headers), set the auto_contents metadata item for the page (or directory) to 'Yes'.

Is there an easy way to do page redirects?

Yep - simply set the redirect metadata item for the page to the URL you want to redirect to.

Admin Questions

How do I setup a staging or publishing directory?

Go to http://your.host.name/ewok/admin/, and create a new ewok 'site'. See the ewok Admin Guide for details.

I still need help!

• Free support is available on the ewok-users@openfusion.com.au mailing list.
• Commercial support is available from Open Fusion - contact support@openfusion.com.au.