floret 0.8, 2008-01-26
Copyright (C) 2007-2008 Chad Loseby
website: http://loseby.net/software/floret

floret is a very simplistic, static website content management system written
in Perl. floret's database is the filesystem. It is driven based on folders and 
text files in a directory that you create and define on your web server. Each 
section of your site is a folder, and each page a simple text file. floret 
automatically styles your pages based on a template that you can easily define. 
It also automatically generates your navigation based on the folder structure 
that you have defined.

Installation Instructions:

   1. Set up a directory on your web server to hold the pages of your site.
      A good place for such a directory would be in the root of your web space,
      such as /home/username/public_html/pages.
      
   2. Configure floret.cgi with your parameters. To do this, open floret.cgi
      with a text editor. Near the top of this file, you will see a section
      labeled "User configuration". In this section, replace the default
      parameters with your own, such as the name of your website, and the
      location of the pages directory you created as well as the path to 
      your template file. 

   3. Copy floret.cgi to a place on your web server that is capable of 
      executing CGI scripts (most likely the cgi-bin directory).
      
   4. Ensure that floret.cgi has the proper permissions to be executed by 
      your web server. If you have access to the command line, you can 
      accomplish this by running:
      
      chmod 755 /home/username/public_html/cgi-bin/floret.cgi
      
      If you don't have command line access, you should be able to change 
      the permissions using your FTP client. Refer to its help section for 
      more information on how to accomplish this. 
      
Usage Instructions:

      The first thing you want to do is create a front page for your site. 
      To do this, use your favorite text editor to create a file named 
      index.txt in the root of your pages directory. Simply fill this file in 
      with text and garden-variety HTML to complete your page. 
      
      Additional pages for your site are created in the same manner. The name 
      of the text file becomes the title of the page, as well as the name
      of the link that will automatically appear in the navigation bar on
      the left hand side of your site. 
      
      If you would like to create sections, or categories, of your site, simply
      create additional directories within your pages directory. If you would
      like your section to have a default page, add a text file named 
      index.txt to the root of the directory for that section. If you choose
      not to do this, floret will automatically generate a listing of what
      pages that section contains. 
      
      If you learn better by example, feel free to take a look at the pages
      directory of my floret-powered web site by going to:
         http://loseby.net/pages/
         
Questions? Comments? Problems?

      I welcome bug reports and other feedback about floret by email:
      floret AT loseby DOT net. 

ChangeLog:

      2008-01-26: released version 0.8