INSTRUCTIONS

Reading this file

For early work, leave this instruction sheet in the files. After first building the site (with 'make') look at the generated files. The variables descriptions lines below will have the actual values of the variables as the file was processed.

Background

A directory for displaying pictures has these files:
    Makefile
    template.tpl (a modified version of this file)
    frame.tpl (modified)
    captions.cap
    index.hin

The Makefile is four lines:
    DIGESTDIR = full name of directory containing the pictures
    include $${PICTOOLS}/MakeVars
    include $${PICTOOLS}/MakeTargets
    $$(DEST)/index.html: captions-titles.txt

The captions.cap file (or any .cap file) is a series of segments.
Each segment begins with a line
    file: segmentname Segment title ...
The pictures in the segment are named on the following lines, up to the next segment line. Each picture has a line
    [imagename.ext] caption words ...

When 'make build ' is performed, a subdirectory is created for each segment. It is named segmentname. Generated into that subdirectory is an index.html file and for each picture line, a file imagename.html. The index.html file is an instantiation of this file. template.tpl. The per-image files are instantiations of frame.tpl.

The index.hin file should contain references to the segments. It can do this with the line
    $$include(captions-titles.txt)

So the segment directory is a subdirectory of the one with the files noted above. From that segment directory we have
index.html is the index to the segment of pictures
instantiated from template.tpl
../index.html is index to all segments of pictures
generated from index.hin
../../index.html is the main page for the project
(assuming that the pictures directory is a subdirectory of the project page)

Warning
Note that this template is instantiated into ./segmentname. So in it, the values of href= in <a> tags and src= in <img> tags must have an additional "../" at the beginning.  (That is, a reference to ../images/foo.png, must appear in this template as ../../images/foo.png)



Tasks
  1. Maybe change page title (the one for the window title bar).
  2. Put a better logo in the upper left.
    Or completely redesign the page.
  3. Define tripTitle in the Makefile with a line like
         DEFINES = -DtripTitle="Trip to Wilmerding"
    Or replace $$tripTitle below
  4. Revise the list of backlink icons, especially those for Log and Pictures. Remember that local links have to be relative to a subdirectory of this one.
  5. Remove this instruction table!

Variables available

The following variables will have the given values and may appear in the template. (After the first generating files from this page, you can check the following to see what values the variables had for the expansion.)

    $$title             Text following the segment name in the file: line.
          ($title)
    $$city              Same as $$title.
          ($city)
    $$prev, $$next  Links to the previous and next picture in this set.
          prev ($prev)
          next ($next)
    $$previmg, $$nextimg   Name of image to use for link's icon
                          You could change these names by changing gendirs.
          previmg ($previmg)
          nextimg ($nextimg)

The following have the indicated values, but are probably not useful.
    $$pictd - wrapper for showing thumbnail pictures
          ($pictd)
    $$picdir - directory where pictures are; usually ..
          ($picdir)

Check your definition of tripTitle
    $$tripTitle - variable defined with -DEFINES in the Makefiles
          ($tripTitle)

Kodak CX3740
$tripTitle
$title

physpics.com
Two mugs of beer
zweibieren
BACK button
Click a thumbnail to see larger pictures, one-by-one NEXT button
 Up Arrow Physpics
 Up Arrow Annals of ZB
 Up Arrow Log
 Up Arrow Pictures
$pictures
BACK button
Click a thumbnail to see larger pictures, one-by-one NEXT button
$includebody(${PICTOOLS}/copyright.html)