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
- 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.
