Manifests
Six different types of so called manifests are used in order to specify metadata and settings:
- artist.eno manifests each go into a separate directory that is dedicated to an artist.
- catalog.eno manifests each go into a seperate directory that is dedicated to presenting a collection of releases on the site (presently always all of them, but this will be expanded in the future to allow hand picking a selection of releases).
- defaults.eno manifests can be placed in purely organizational directories that contain any number of artists, catalogs, multitracks or tracks. They contain settings that are passed on as defaults to all subdirectories.
- multitrack.eno manifests are placed in directories that contain multiple audio files, either directly or spread across their own track directories, representing for instance an album, or a podcast
- site.eno is a singular manifest file which always is placed at the root of the site directory, providing settings that apply to the site in general, as well as to all entities within it through default setting inheritance
- track.eno manifests always go into track directories, which may exist as stand-alone track releases, or as tracks within a multitrack directory. A track directory may contain at most one audio file, or none if the audio is not yet available.
In the example above, everything defined in site.eno applies to Homepage,
An Artist, Another Artist, First Release, Second Release and Third Release, but the artist.eno, catalog.eno, multitrack.eno and
track.eno manifests can selectively override settings for the directories
they are placed in. Inside Second Release one of the audio files is
additionally wrapped into its own track directory with its own track.eno
file, which augments and/or overrides any settings made to it at a higher
level (at the multitrack or site-level).
Here is an example multitrack.eno manifest to give you an idea of how they work:
title: Second Release
cover: cover.jpg
cover_description: An ink drawing of a barren tree with monkeys in its branches
download_formats:
- mp3
- opus
-- more
Recorded in the summer of '94 at West Callaghan Ranch, XE.
Featuring Ted Tukowsky on Trombone and Lisa Merringfield on Theremin.
-- more
For details on the syntax used in the manifest files see the eno language guide on the eno website. Simply modifying the examples in the docs should get you there without any problems though, the examples given are as complex as it gets.