    ///////////////////////////////////////////////////////////
    // razorCMS                                              //
    // readme.txt                                            //
    // GPLv3                                                 //
    // smiffy6969                                            //
    // www.razorcms.co.uk                                    //
    // www.burningfist.co.uk                                 //
    // 03/2008                                               //
    // ----------------------------------------------------- //
    // V0.1  -  03/2008  -  Version 0.1 first release        //
    // ----------------------------------------------------- //
    // V0.2  -  06/2008  -  New features + bug fix resulting //
    //                      in up issue to V0.2BETA          //
    //                                                       //
    //                      Bug fixes for issue to V0.2RC    //
    // ----------------------------------------------------- //
    // V0.2  -  08/2008  -  RC2 Bug fix release              //
    // ----------------------------------------------------- //
    ///////////////////////////////////////////////////////////
    
    // Introduction ///////////////////////////////////////////
    
    razorCMS is an open source flat file Content Management System,
    this means there is no need to use an additional database, all
    data is stored in file format.
    
    razorCMS comes in one flavour, core. This is the base system which
    comes with limited functionality, just enough to be usefull. This
    means those wishing to keep the system fast and small may do so.
    
    Those wishing to have a more flexible easy to use system may then
    begin to add the functionality they wish by using the simple blade
    manager, adding blade packs to the system containing anything from
    sef url re-writes to WYSIWYG html editors.
    
    This kind of approach to CMS solutions gives you a lego brick
    structure, using only the blade packs you wish to create a tailor
    made solution that fits your needs, without being bogged down with
    functionality you do not need. This should help to keep your
    CMS solution sharp and simple.
    
    PLEASE NOTE : Use of this software is purely at your own risk, the
    author of the software offers no guarantees of the performance or
    suitability of this software and cannot be held responsible for the
    outcome of using this software. By installing and using this software
    you are clearly aknowledging the fact that you the user are solely
    responsible for the use of and any circumstances arrising due to the
    use of this software.    
    
    ///////////////////////////////////////////////////////////

    // About razorCMS /////////////////////////////////////////

    razorCMS came about from some brief time spent using nanoCMS, this
    is an open source CMS solution created by Kalyan Chakravarthy. After
    forking the nanoCMS project to create uCMS, adding extra functionality,
    it was decided that more needed to be done.
    
    razorCMS was created from scratch, using a whole new design, but using
    some of the usefull parts of uCMS in a few places. Most of the old
    uCMS code that has found its way into razorCMS has been re-written,
    but most of the code in razorCMS is new code.
    
    Due to this system using some 'as is' code and some re-written code
    from uCMS, all of razorCMS is offered under the GPLv3 licence.
    
    ///////////////////////////////////////////////////////////

    // Installation - FTP MODE (recommended) //////////////////

    If you want to install razorCMS with FTP support (recommended),
    please continue with these instructions, for non ftp mode installation
    instructions please refer to the non ftp mode installation instructions.

    FTP mode installation allows all writable files created by razorCMS, to
    be owned by your ftp user account, allowing greater flexibilty over the
    files as you can modify, delete and upload files through your ftp client.
    In addition to this, backing up your site will not result in loss of
    ownership of files created by razorCMS making your content un-editable
    after a backup requiring world writable permission to be set (security risk).
    This is due to normal apache server behavour. Other benefits of using the
    system in this fashion include greater security as all files can be set to
    minimum permissions and owned by your ftp user.

    If you do not use ftp mode, any backup taken will result in a loss of apache
    ownership of the apache owned files created by razorCMS, meaning a backup
    will re instate your site but be unable to add or edit content, 
    YOU HAVE BEEN WARNED. If at all possible use ftp mode.

    1) Download and unpack razorCMS_core_v#.#.tar.gz (or zip).

    2) Delete the install.php file, this is only required for non ftp installation.
    
    3) Configure the admin/core/admin_config.php file by changing the username, 
    password and ftp details. Please keep your admin password tight to stop
    unwanted access by others into your admin panel.

    change the part after the = sign inside the quotes, ensure you keep the quotes
    in tact, find the lines below in the config file and change them. Failure to 
    include any ftp data will result in razorCMS running in non ftp mode.

        // admin username //
        $RAZOR['admin_username'] = 'razor';

        // admin password //
        $RAZOR['admin_password'] = 'razor';

        // ftp server name e.g. ftp.yoursite.co.uk //
        $RAZOR['ftp_server'] = '';

        // path to razorCMS from your ftp root e.g. /razor/ //
        $RAZOR['ftp_path_to_razorcms'] = '';

        // ftp username //
        $RAZOR['ftp_username'] = '';

        // ftp password //
        $RAZOR['ftp_password'] = '';

    4) Upload all files to your webserver in either your web root or a sub
    directory of root, ensure you keep the directory structure in tact.

    Install complete, try visiting your new CMS by visiting your website url,
    to access the admin panel, add /admin onto the end of the url where the system
    is installed, using the username and password set config file.

    ///////////////////////////////////////////////////////////

    // Installation - NON FTP MODE ////////////////////////////

    If you want to install razorCMS without FTP support, use these instructions.
    They will guide you through the process of installing the system and converting
    certain files to apache owned files, this will help to keep the file permissions
    safe, allowing only apache to write to them. It is not recommended to run CMS
    systems with world writable files and folders.

    Please note that when installing in this fashion, you will not have control over
    the apache owned files through your ftp client, before deleting you must unset
    all apache owned files in the security manager. Failure to do this before deletion
    will result in files you cannot remove from your server without root access.

    The security manager is designed to set all apache owned files as world writable
    allowing your ftp client the permissions to delete the files. In addition to this
    the security manager will monitor all apache owned files to ensure they are set
    safely.

    1) Download and unpack razorCMS_core_v#.#.tar.gz (or zip).
    
    2) Configure the admin/core/admin_config.php file by changing the username
    and password to something you will remember, please keep this password tight
    to stop unwanted access by others into your admin panel.

    change the part after the = sign inside the quotes, ensure you keep the quotes
    in tact, find the lines below in the config file and alter them as you wish.

        // admin username //
        $RAZOR['admin_username'] = 'razor';

        // admin password //
        $RAZOR['admin_password'] = 'razor';

    Do not enter any ftp details into the config file to run in non ftp mode. razorCMS
    automatically detects the presence of ftp settings, by inserting ftp settings
    into the config file you will instruct the system to use ftp mode.

    3) Upload all files to your webserver in either your web root or a sub
    directory of root, ensure you keep the directory structure in tact.

    4) using your ftp client (fireFTP for firefox is good), or by other
    means, set the following directories and files to world writeable 0777 on
    your webserver, do not do sub directories too unless you know what your
    doing, you could end up with a file permission left open.

        directory - datastore
        directory - datastore/pages
        directory - datastore/media

        file - datastore/pages/1.php
        file - datastore/razor_data.txt

    5) Run the install script install.php by navigating to it using a web browser
    www.yoursite.co.uk/install.php if you have uploaded to web root, or
    www.yoursite.co.uk/subdirectory/install.php if you have uploaded to a 
    sub directory of root, and so on. Remember to change 'yoursite' and 'subdirectory'
    for your site name and any sub directories.  

    6) Ensure the install script runs without producing an error, and
    the script reports the installation is successful.

    7) IMPORTANT : Follow the instructions at the end of the script, to delete
    the install.php file from your webserver, and set the 'datastore' directory
    back to 0755 permissions, DO NOT FORGET THIS IS VERY IMPORTANT.

    Install complete, try visiting your new CMS by visiting your website url,
    to access the admin panel, add /admin onto the end of the url where the system
    is installed, using the username and password set earlier in the config file.

    ///////////////////////////////////////////////////////////
    
    // Footnote ///////////////////////////////////////////////

    If you require help, need advice on using razorCMS or want to thank me in some
    way, please contact me through www.razorCMS.co.uk using the support forum.    

    ///////////////////////////////////////////////////////////
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    