The Archives are handled by the customised PNHB theme derived from the "blog" template of Quark. The general idea of a blog is that it is a listing page displaying a teaser for each blog item - the reader clicks on the highlighted item name to see the full item. There is a right hand panel that allows the reader to search the collection in various ways.

I recognised that most of our archives take the form of either some text or some text and a bunch of pictures or just a bunch of pictures. One picture may be a lead image. To simplify the creation of archives, I wrote custom code to display both the teaser and the full page. The teaser is made up of the title as a link to the content, the lead picture (if there is one) and the text up to a delimiter. The lead picture is also a link. The content shows the lead image followed by the full text, followed by an image gallery of all the images in the page media.

Each archive (event or article) requires some information (data) to inform the processing. Such information is at the top of every archive - GRAV calls this frontmatter. In the admin, it can be seen in the expert view. It should look something like this:

title: 'Halloween 2016'
category: blog
tag: social
visible: false
date: '2016-10-28'
leadimage: Halloween2016.jpg

To make a new archive:

  1. open an existing archive for edit, important to get some context data right
  2. In the top blue menu bar, press Add
  3. In the next screen, give the new page a title, and select visible = no, press continue
  4. save the new page
  5. several steps to get the frontmatter in place press the options button - choose category = blog, tag as appropriate to archive type, save press the archive Item button - set the three values under Header Options, save
  6. write your content, insert images in media, save
  7. test

The date should be chosen using the calendar icon - this ensures the correct format. The lead image is the name of the lead image or empty - be sure to spell it exactly as the filename. Link is a special feature in case the expanded article is a complex page - the only current example is Summit Terrace Band because it needs a sidebar.

Optionally, you can use the expert button to verify the frontmatter. Be sure to return to Normal.

The teaser in the archive overview shows the title, then the lead image followed by possibly truncated content. The way to truncate content is to place a blank line, a line containing "===" and another blank line at the desired break point. In the absence of such a break, the display is truncated at a certain number of characters.

Often an archive is about an event e.g. a party and has a small amount of description (or none) and some pictures. To make things easier, the archive code assumes that a picture gallery should be created and generates such with small, expandable images. In case this is not desired, there is an option (gallery FALSE) to suppress it - see Music Library for an example of the use of this, where each picture is explicitly included surrounded by text.

Please ensure that all uploaded images are of a reasonable size - suggested max width of 1200 pixels or probably less. Large files, such as those from phones, are expensive for everyone. Use the smallest size that works for you. Size can be adjusted with Irvanview in Windows or Preview in MAC OS.

Experiment. Good luck.

If you need any help, please email