Structures

Pages

Both the site contents and DMCM interface are defined in terms of pages. The same static media (CSS, Javascript, etc.) is used to give both a common look-and-feel and to allow previewing of content which has not yet been published. (see Design Overview)

The DMCM interface is used to manage the contents of the site. Both the DMCM interface and site pages have a Banner heading, a navigation Menu and a Footer.

Pages are stored on the database using the Page model.

Example

The Markdown part of this published page is outlined in yellow:

Here is the Markdown:

# Personal Website of Paul Ahern

Here you will find my
[Blog](http://blog.ahernp.com/ "Stray Thoughts Wordpress Blog"),
some product [Guides](http://ahernp.com/guides.html "Guides"),
a catalog for my [Library](http://ahernp.com/library.html "Library")
and a [Gallery](http://ahernp.com/gallery.html "Gallery") of photographs.

## External

<div style="float:right;">
<img title="ahernp.com logo" src="http://ahernp.com/img/ahernpLogo250x250.png" />
</div>

Favourites:
[iGoogle](http://www.google.com/ig "iGoogle")
[Met](http://www.met.ie/ "Irish Meteorological Office")
[Open24](http://www.open24.ie "permanent tsb online banking")
[Rabo](http://www.rabodirect.ie/ "RaboDirect online banking")
[RT](http://www.radiotimes.com "Radio Times")
[Meteor](https://www.mymeteor.ie/ "Mobile Phone")
[iPlayer](http://www.bbc.co.uk/iplayer/radio/bbc_radio_four "BBC Radio 4 on iPlayer")
[AE](http://academicearth.org "Academic Earth lectures")
. . .

## Local

[Profile](profile.html "Personal Profile")
[CV](cv.html "CV")
[Public Key](public-key.html "Public Key")
[MSc](msc.html "MSc")

Note that HTML may be embedded in the Markdown as necessary.

Lists

Lists are like Pages but the Markdown body is not freeform text. It is generated from prefix and suffix text with list items in the middle.

The list is generated from a template, delimiter, and data consisting of list items separated by delimiters. The structure of each list item is determined by the template.

The generated list is in Markdown format and can be used as the body of a Page.

Lists are stored on the database using the List model.

Example

Prefix (written in Markdown):

# Software

Catalogue of PC Software and Games in my library.

Genre | Title
------|------

Template:

#Genre | #Title

The delimiter is “;”.

Data:

#Genre;#Title
Strategy;1942 Pacific Air War
Reference;Brittanica 2007
Application;Microsoft Money 2003
Strategy;Civilisation III - Conquests
Strategy;Civilisation IV - Complete
Strategy;Combat Mission - Anthology
Flight Sim;Crimson Skies
Strategy;DEFCON
Strategy;Galactic Civilisations II
Flight Sim;IL-2 Strumovik - 1946
Strategy;Massive Assault
Strategy;Rome Total War - Gold Edition
Strategy;Sins of a Solar Empire
Strategy;Space Empires V
Strategy;Star Wars Empire at War
Strategy;Star Wars Empire at War - Forces of Corruption
Strategy;Star Wars X-Wing collectors Series
Space Sim;X2 The Threat (Linux)
Space Sim;X3 Reunion
Flight Sim;X-Plane 9
Utility;LaTeX Live 2003
Utility;US Robotics Modem Drivers

Suffix (written in Markdown):

Only Software and Games with physical CDs are listed.

Give the following generated List:

# Software

Catalogue of PC Software and Games in my library.

Genre | Title
------|------
Strategy | 1942 Pacific Air War
Reference | Brittanica 2007
Application | Microsoft Money 2003
Strategy | Civilisation III - Conquests
Strategy | Civilisation IV - Complete
Strategy | Combat Mission - Anthology
Flight Sim | Crimson Skies
Strategy | DEFCON
Strategy | Galactic Civilisations II
Flight Sim | IL-2 Strumovik - 1946
Strategy | Massive Assault
Strategy | Rome Total War - Gold Edition
Strategy | Sins of a Solar Empire
Strategy | Space Empires V
Strategy | Star Wars Empire at War
Strategy | Star Wars Empire at War - Forces of Corruption
Strategy | Star Wars X-Wing collectors Series
Space Sim | X2 The Threat (Linux)
Space Sim | X3 Reunion
Flight Sim | X-Plane 9
Utility | LaTeX Live 2003
Utility | US Robotics Modem Drivers

Only Software and Games with physical CDs are listed.

Blog Pages

Each Blog Page holds a single Blog Entry in Markup text.

Blog Pages are stored on the database using the BlogPage model.

Example

The Banner, Menu and Footer sections are from the same template as the Page.

The Blog Entry Title and Date are written separately.

The Markdown body makes up the bulk of the entry.

The Comment Section is handled by Javascript from by Disqus:

Here is the Markdown:

Donkey Junior has arrived (in the field next to my new barn):

[![Donkey Junior has arrived]
(http://ahernp.com/img/thumb/donkey_junior.jpg "Donkey Junior has arrived")]
(http://ahernp.com/img/donkey_junior.jpg)

Junior is only two days old.

Construction of the barn will give him something to watch:

[![Barn Under Construction]
(http://ahernp.com/img/thumb/barn2.jpg "Barn Under Construction")]
(http://ahernp.com/img/barn2.jpg "Barn Under Construction: 
Note new growth on mountain behind")

No activity today but I am assured that it will be finished within 3--4 weeks.

Todo

Add additional structures. E.g. one similar to List but which gen­er­ates mul­ti­ple web pages.