ewok Frequently Asked Questions =============================== Contents -------- Version / Homepage ------------------ This FAQ refers to ewok version 0.4.1. 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 ------------------ h3: What is ewok? ewok is a full-featured content management system written in Perl. For the full blurb, see the "README":README.html. h3: What environment do I need to run ewok? - a Unix-based Apache with mod_perl support - root access (or at least access to the user apache is running as) - the following Perl modules installed: + HTML::Embperl (1.3.4 recommended) + URI::Escape + File::DirSync - apache authentication configured for at least the ewok staging directories h3: Can I install ewok in a web hosting environment as an ordinary user (i.e. without root)? Maybe. We haven't done it yet, but it should be doable - if you get it working, please let us know at ewok@openfusion.com.au. h3: Does ewok work on windows? Not at this point. h3: 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 -------------- h3: Why isn't text markup working properly? =#markup_metadata 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'. h3: How do I get automatic contents sections? =#auto_contents 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'. h3: Is there an easy way to do page redirects? =#redirects Yep - simply set the redirect metadata item for the page to the URL you want to redirect to. Admin Questions --------------- TODO See the "ewok Admin Guide":admin/.