Roll: Sum: History:

Specs for the Webber quick and dirty web page generator.

Written by Eric Wollesen <ericw at xmtp dot net>.

Overview

Webber is a program to generate web pages. I’ve designed it specifically to generate my home page, which is really just a list of links, a few files and a few scattered images.

This spec is not, by any stretch of the imagination, complete.

Scenarios

User Danny wants to create a web page. He doesn’t know much about web pages, but he wants to have a place to link to and talk about all of his favorite bands. Danny sorts his favorite bands by the date of their most recent album’s release. As such, he changes the ordering of his favorite bands often.

Non Goals

  1. We will not have support for style attributes in this release.

Flow Chart

User generates a page file.

User runs Webber to generate a web page.

User views web page.

I’m not sure that a flowchart makes a lot of sense here, as the program isn’t very interactive. Or, more accurately, it’s not interactive.

Object by Object Specification

Title
Page title.
Link
This is the most commonly used element supported by Webber. Links can point to other generated files, or other sites.
File
Inserts a link to a non-HTML file. Maybe a movie, or a PDF document.
Image
Inserts an inline image into the page.
Text
Inserts a section of text. Perhaps to describe an image, a link, or a series of links.
Break
Inserts a line break in the generated page.
List
Starts an unordered list.
Raw
Inserts raw HTML into the generated page.
CSS
Inserts a link to a CSS page for the generated page.
Input?
Inserts the output of a script and parses it as webber text.
RawInput?
Inserts the output of a script verbatim.