This is Uberghey CMS                                             version 0.1.1

Contents:
1. Introduction
2. Installation
3. Theming
4. Managing
5. Modules
6. Thanks

.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-.
1. Introduction

  This is an attempt at writing some documentation for Uberghey CMS. Uberghey
CMS started its life as the backend for my personal portfolio, but has since
grown in leaps and bounds.
  From simply being able to translate data from text files into a web-page
(e.g. a theme engine), it now includes an interface for managing these files,
their menus and everything else. It even has support for modules, written in
PHP.

.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-.
2. Installation

  Installing Uberghey CMS is an immensely simple, three step operation:

  A. Decompress the downloaded package
  B. Upload to your web-server
  C. Do one of the following (II is more secure, though also not so flexible)
     I.  Set read-write permissions for everybody on the setup folder and all
         the files contained within
     II. Set the user and group of the setup folder and all files contained
         within to the user and group that is running the web-server

  You're done! Now all you have to do is make the themes you wish to use, which
is described in the next chapter.

.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-.
3. Theming

  Theming for Uberghey CMS is a simple process, involving only knowledge of
HTML (or WML or XHTML or whichever type of web-technology you wish to use).
The only requirement is a specific set of styles used by the management
interface. The CSS can be found in the sample theme, and is the only content
of the CSS file in that folder.
  To make a theme, simply make the layout for a web-site as you would normally
and then put in placeholders where the actual content will go. A placeholder in
Uberghey CMS is an all-capitals set of characters encapsulated in a set of hash
marks, for example ##THISTHEME##, which translates into the folder where the
current theme is contained (for example "setup/themes/default").

---------------------------------------
List of Uberghey CMS Theme placeholders:

...................
Internal placeholders:

General placeholders:
 ##THISTHEME##
 ##POWEREDBY##
 ##SETUPSITE##
 ##SETUPSITE_GRAPHIC##
 ##EDITTHISNODE##
 ##EDITTHISNODE_GRAPHIC##
 ##LOGOUT##
 ##LOGOUT_GRAPHIC##
 ##RECENTCHANGES_LIST_HORIZONTAL##
 ##RECENTCHANGES_LIST_VERTICAL##
 ##RECENTCHANGES_LIST_DROPDOWN##
 ##THEME_LIST_DROPDOWN##
 ##THEME_LIST_HORIZONTAL##
 ##THEME_LIST_VERTICAL##
 

Node related placeholders:
 ##NODE_TITLE##
 ##NODE_CONTENT##
 ##NODE_AUTHOR##
 ##NODE_AUTHOR_EMAIL##
 ##NODE_DATE##
 ##NODE_ID##
 ##SUBJECT_MENU##

Internationalisation placeholders:
  The following is a simple list, where the placeholders are shown with their
English language translation. Some may seem banale, but they are nessecary for
internationalisation reasons. They enable the entire site to be translated,
including the interface and not just the content.

 ##READMORE##
   Read more
 ##FINDINFO##
   Find information
 ##FINDIT##
   Find it
 ##USERFUNCTIONS##
   User functions
 ##GOFRONTPAGE##
   Go to the Front page
 ##GOTAGWALL##
   go to the Tag wall
 ##GONODELIST##
   See list of all nodes
 ##ADMINFUNCTIONS##
   Administration functions
 ##SELECTTHEME##
   Select theme
 ##CHANGETHEME##
   Change theme
 ##SELECTLANGUAGE##
   Select language
 ##COPYRIGHT##
   This page is copyright &copy; 2003 by <a class=\"footer\"
   href=\"./index.php?node=About%20me&amp;language=en\">..Dan Jensen</a>. All
   rights reserved.

...................
Special placeholders:

Language placeholders:

Theme placeholders:

---------------------------------------
Step by Step guide to Theming for Uberghey CMS:

  A. Make a new web-site somewhere on your filesystem using your favorite web
     development environment (Dreamweaver, Quanta+, Kate, emacs...)
  B. Edit this web-site to suit you, using the place-holders described above.

.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-.
4. Managing

.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-.
5. Modules

.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-._.-=:=-.
6. Thanks
