Use these files in order to enable mapping of arbitrary URLs to specific
components.  For a site that has several pages that display dynamic
content, this is an easy way to implement that using Iowa.  To use this,
create your component or components that generate the desired pages.
Then create a file called 'mapfile.cnf'.  This file is a YAML file
with a simple format.

PATH: COMPONENT
PATH2: COMPONENT@

i.e.

/: Homepage
/index.html: Homepage
/info/dailynav.html: DailyNav

If you are using the iowa.cgi component to direct your web traffic to
the Iowa app, this is all you need to do.  You will want to adjust your
Apache configuration so that traffic to any of the mapped URLs is sent
to the Iowa application.

If you are using the mod_ruby handler, and your site does not use
regular CGI, you can send ALL site traffic to the handler if you
also create a second mapfile for the handler to use.  This mapfile
tells the handler which paths are to be passed on to the Iowa application
and which to let fall through for Apache to handle elsewhere.

To do this, add a section to your <Location> config that does something
like this:

RubySetEnv MAP_FILE "/usr/local/htdocs/mysite.com/mapfile.cnf"

This mapfile is just a list of paths, one per line:

/
/index.html
/info/dailynav.html


