Contents

  1. Introduction
  2. System Requirements
  3. Installation
  4. Customizing
    1. title.dat
    2. header.dat
    3. footer.dat
    4. static.dat
    5. dynamic.dat
  5. Resources

Introduction

System Requirements

TrapperTim has two very simple requirements:

No extra PHP modules or database access is required.

Installation

To install TrapperTim, simply extract the TrapperTim-datestamp.tar.gz file to the directory on your server that you want to run it at.

Customizing

Customization of TrapperTim is achieved by modifying several files located in the ttdata/ subdirectory of the TrapperTim distribution. These files are described in detail here. For examples of the format of each of these files, refer to the example files included with the default TrapperTim distribution.

title.dat

This file contains the page title that should be displayed by the browser. It should consist of a single line of plain text.

header.dat

This file contains the page header that should be displayed by the browser. It can contain free-form (X)HTML markup.

footer.dat

This file contains the page footer that should be displayed by the browser. It can contain free-form (X)HTML markup.

static.dat

This file contains several entries that will be formatted and sent to the browser. Think of an entry as a news item or blog entry.

static.dat contains static content. Static content will not "scroll" off the front page, no matter how many entries you place in this file. For this reason, static.dat should be used sparingly.

Each entry consists of a titles line, followed by one or more lines which make up the entry's body. Entries are terminated by a single blank line, or the end of the file (whichever happens first).

The titles line (the first line of an entry) contains the entry's title, followed by an optional subtitle. The title is separated from the subtitle with a pipe (|) character. An example titles line would look like this:

Title|Subtitle

After the titles line, comes the entry body. The entry body consists of one or more consecutive lines of text. The entry body is ended with a single blank line. (X)HTML markup can be used in entry bodies.

dynamic.dat

This file is similar to static.dat with the exception that it contains dynamic content. Only the ten most recent entries in dynamic.dat will be shown by default. The first entry in dynamic.dat is treated as the most recent entry and the last entry is considered to be the oldest entry.

dynamic.dat uses the same format as static.dat and allows (X)HTML markup to be used within entry bodies.

Resources

If this User's Guide did not solve a problem or answer a question you may have about this software, feel free to contact the author of this software at the_trapper@users.sourceforge.net.