Document Models

The links below point to graphical representations of all of the story document models used to manage the Bricolage Website in Bricolage. A document model is a hierachically organized strucuture of elements and fields that determines the structure of all documents based on the model. This approach to content management ensures that content is consistent across documents while keeping formatting entirely independent of presentation.

The pages below were created using a special utility template, introspect.mc, available for download from the template exchange.

Archive Document Model

Archive documents have no structure themselves; their templates do all the work. They use the Bricolage API to look up and output a list of all of the Article documents in the same category as the archive document or any of its subcategories. The complete site archive is also generated by the templates for this document model.

Article Document Model

Article is one of the two main document types for the Bricolage Website. It contains all of the requisite fields and subelements for creating date-sensitive articles for the site, such as HOWTOs and press releases.

Changes Document Model

This document model is used to create a list of changes for a release of Bricolage or another download on the site. See the Bricolage 1.8.0 changes for an exmple.

Document Models

For the creation of a list of document models.

Document Models Document Model

This document model is used for the list of document models on the Bricolage Website. Its template does the work of finding and listing the document model documents, leaving the paragraphs as the only field for the summary at the top of the page.

Downloads Document Model

This document model is used to create the site’s Downloads page. Each downloadable file and Changes document is associated with the Link to Download subelement. The XHTML template outputs the list, as well as the MD5 hashes for each file.

FAQ Document Model

This document model is used to manage the Bricolage FAQ. The XHTML templates use the element order for each section and question to output id attributes for the table of contents links.

Fixed Document Document Model

This document model is the other most used on the site. It is used for creating the pages that tend to be fixed in a section of the site, such as Benefits page and the Support page.

Home Page Document Model

This document model is used for the management of the Bricolage site home page.

Mailing Lists Document Model

This document model manages the list of Bricolage mail lists. Each Mail List subslement contains a link to the mail list admin page and a link to its archives.

Nav Menu Document Model

This document model is used to manage and generate the hierarchical list of links that is used for the navigation menus at the top of every page on the site. The Mason output channel template outputs a Mason component that is then included in every page by the front end server.

Roster Document Model

This document model manage the structure of the Bricolage Team page. Each team meber is described in a Personal Profile subelement, which can also have a picture associated with it as related media.

Screenshots Document Model

This document model manages the Bricolage Screenshots page. Since each screenshot has several versions, the Link to Screenshot Image subelement is added to each Screenshot element for each image.

Sites Document Model

This document model manages the Bricolage Sites page. It simply lists all of the sites known to be powered by Bricolage.