Neatline Records: An Overview

At a glance

Everything is a record

Records are the fundamental unit of content in Neatline exhibits. In Neatline, everything is a record - vector annotations on the map, plottings on the timeline, listings in the waypoints tray, WMS overlay layers, text annotations in the exhibit narrative, and any other content displayed by sub-plugins. Depending on the type of information that’s entered into the record metadata, the same record could be displayed more than once in the same exhibit. For example, if a record has both a geometric annotation value in the coverage field and a defined value for the start_date, it will be displayed both as a shape on the map and a point on the timeline. When this is the case, Neatline will automatically link all instantiations of the record - when the user clicks on the span on the timeline, the map will zoom to the corresponding location, and vice versa.

The record data model

All records share a common data model. Similar to elements on Omeka items, all fields are optional.

Neatline records vs. Omeka items

Even though all records share the same data model, they can be divided into two basic categories - exhibit-specific records that exist just inside of a single exhibit, and item-backed records that link back to items in the Omeka collection. The two types behave exactly the same, with one exception - if a Neatline record is associated with an Omeka item, the record’s “Title” and “Body” fields will be automatically compiled from the content in the Omeka item. The title will be filled in with the item’s Dublin Core “Title” field, and the “Body” will be populated with the compiled metadata output of the entire item. Once the association is established, the content in the Neatline record will be automatically updated whenever the Omeka record is changed.

Why does Neatline make this distinction? Why aren’t records just the same thing as items? In the early stages of development, there actually was a one-to-one correspondence between Omeka items and Neatline records - records were just the direct instantiations of Omeka items in a specific Neatline exhibit. The problem, though, is that Neatline exhibits often require a body of “annotative” or “supporting” information that doesn’t really fit well in the context of an archival collection. For example, imagine you’re working with a collection of correspondence - each letter in the collection is represented by a canonical Dublin Core record in Omeka. Then, when you pull the letters into a Neatline exhibit, you start to sketch in arrows, brackets, flowcharts, and other little bits of presentational information to support the core archival objects.

This supporting information is essential in the context of the exhibit, but almost meaningless in isolation, and it often doesn’t make sense to formalize all of these elements as first-class archival entities - it’s not the best practice to have items like “Blue Arrow 4” or “Outline of New York” mixed heterogeneously into the collection of letters. To get around this problem, Neatline makes it possible to create these exhibit-specific, “unaffiliated” records can be used to formalize this type of annotative information, while also making it possible to create records that link back to the durable archival resources in the Omeka collection. This way, we get the best of both worlds - we can integrate seamlessly with the content in Omeka, and also choose not to integrate with it when doing so would degrade the integrity of the collection.

Getting Started

Working with Exhibits

Working with Neatline Plugins

Working with Neatline Stylesheets

Working with the Neatline Editor

Records

Text Tab

Map Tab

Style Tab

  • Editing Groups
  • Editing Colors
  • Editing Opacities
  • Editing Dimensions
  • Editing Dates
  • Editing Imagery
  • Editing Visibility