Bruner Project - File Structure

Bruner Project
File Structure

Spring 2000

Naming the Files
Directory Structure

Naming the Files

The Bruner Website is comprised of individual award entries which in turn contain various types of documents. Before scanning, it is important to identify the document type, since that will determine the standards used in the dig itization process.

There of four basic document types:

Text:
This includes perspective sheets, abstracts, executive summaries, articles, background information, etc.
Drawings, Maps, Illustrations, etc.:
Includes siteplans, sketches, blueprints, architectural renderings, etc.
Photographs:
Color and B&W. Some photos are stand-alone, while others may be part of an article or brochure.
Graphics:
Logos, PR materials, brochures, posters, etc.

Once the document has been identified and scanned (see Bruner Project Scanning Procedures), it must be named.
Filenames should be descriptive of the content of the scanned document. This will ease the process of identifying the file during the conversion-display portion of t his project. The key is to be consistant. When naming the files, try to adhere to the following guidelines (keeping in mind that there are of course, ALWAYS exceptions.)

When scanning images, all files must be saved as uncompressed TIF images (file extension .tif.) The table at right lists the text documents from a 1999 entry as well as the corresponding filenames. All entries will (or should) contain these text documents as they are required parts of the application.

* Multiple page documents use the format: [filename]-1.tif, [filename]-2.tif, etc.
** If there is more than one document with multiple pages, use the format: [filename]1-1.tif, [filename]1-2.tif, etc.

Document	Suggested Filename
Project Data Sheet (1p.)	project_data.tif
Abstract (1p.)	abstract.tif
Project Description (2p.)	project_description-1.tif* project_description-2.tif
Architect or Designer Perspective (2p.)	architect_perspective-1.tif architect_perspective-2.tif
Professional Consultant Perspective	prof_consult_perspective.tif
Public Agency Perspective	public_perspective.tif
Other Perspective (2 different perspectives, 2p.ea.)	other_perspective1-1.tif** other_perspective1-2.tif other_perspective2-1.tif other_perspective2-2.tif

Each entry will also contain supplementary materials, including articles, promotional materials, images and graphics.

If the document is an article, brochure, annual report, etc. save it under the filename supp_material-.tif.
Photographs, maps, logos and sitemaps/siteplans should be named as such.
All other images are to be saved as graphic-.tif.
If a document is of mixed format (photo and text) or it is unclear as to what document format it is, save it as supp_material-.tif.

Other documents which fall into the "supplemental material" category are:

articles

awards

demographics

reviews

updates

plans (may also be "graphics.")

summaries

statements

brochures

comments

breakdowns

budget

fact sheets

Document	Suggested Filename
Photographs	photo1.tif photo2.tif etc.
Agency annual report (2p.)	supp_material1-1.tif supp_material1-2.tif
Sitemap	sitemap.tif
Maps	map1.tif map2.tif
Logo	logo.tif
Artist's rendering & blueprints	graphic.tif graphic2.tif
Newspaper article w/photo	supp_material2.tif

Top of Page

Directory Structure

The Bruner Project UNIX account is housed on the libraries' Elmwood server. Once the authorized account is accessed (see Scanning Coordinator for details) type bruner [enter] to go directly to the Bruner Project region.

For this example we will use the 1995 entry, "Crane's Roost."

To access the archival image files, type:

cd tiff

cd cranes_roost

Here is the layout for Crane's Roost's archival image files:

bruner/	
      tiff/
	   cranes_roost/
	        abstract.tif
	        art1-1.tif
	        art1-2.tif
	        devper1-1.tif
	        devper1-2.tif
	        ... etc.

To access the display files for "Crane's Roost" start by typing bruner [enter]. All 1995 winners and finalists can be found in the 1995/ directory. Entries which were not winners or finalists are in the 1995a/ directory. (This pattern continues for 1997 and 1999 entries. "Crane's Roost" was neither a winner nor a finalist, so type:

cd 1995a
cd cranes_roost
ls

The listing will show a number of subdirectories corresponding with the various parts of the entry (abstract, perspective sheets, graphics, etc.) Within each of these subdirectories are the individual image files and the html pages on which they are displ ayed.

This is the structure for the display image files in the Crane's Roost entry:

  
bruner/
     1995a/
         profile/
               index.html
	   abstract/
               index.html
	   perspective_sheets/
               index.html
               professional1.gif
               professional2.gif
               professional1.html
               professional2.html
	         ...etc.
         site_graphics/
               index.html
               map1.gif
               map2.gif
               site1.html
               site2.html
               ... etc.
	   photos/
               page1.html
               page2.html
               photo1.jpg
               photo2.jpg
               photo3.jpg
               ... etc.

Top of Page
Return to Scanning Procedures

Created April 5, 2000
Brenda L. Battleson - Digitization Coordinator
URL: http://ublib.buffalo.edu/libraries/projects/bruner/images/file_structure.html

Please send comments, suggestions or questions to: askcts@acsu.buffalo.edu