Mediatex 0.9: catalog.txt

4.4 catalog.txt

The /etc/mediatex/mdtx-COLL/catalogXXX.txt files handle the descriptive meta-data of a collection.

Using the “$ mediatex upload[+] [file file [as target]]* [catalog file] [rules file] to coll coll” query, PUBLISHER (see Who) should provide related descriptive meta-data file for the new archive, using the same grammar language.

The format of this file is oriented to describe a simple movie database. It does not conform to any specific descriptive meta-data schema, like the Dublin Core (http://dublincore.org/). However, the translation from and to all meta-data formats remains possible, by adding characteristics to the objects.

Relational schema:

Entities
- The ARCHIVE entity lists all archive’s data files.
- The DOCUMENT entity groups archives (data, parts, versions time-stamps …) related to an archived document. Document are stored using an AVL tree.
- The CATEGORY entity groups documents by themes (onthology).
- The HUMAN entity lists humans (using an AVL tree) related to a document.
- The ROLE entity lists all titles a human contributing to a document may have (ex: producer, actor, … for a movie).
- The *_CARAC entities are unidirectional in order to consume less memory.
Relations
- The ASSO_ROLE relationship matches a human, a role and a document.
- The CONTAINS relationships matches ether humans or documents to categories, or records to documents.

Example:

# Categories:

Top Category "media"
  "topo" = "Welcome !"
Top Category "image": "media"
Top Category "drawing": "image"
Top Category "animal"
Category "hand": "drawing", "animal"

# Humans:

Human	 "Me" "": "drawing"
  "another thing?" = "no"

# Archives:

Archive	 022a34b2f9b893fba5774237e1aa80ea:24075
  "format" = "PNG"
Archive	 b281449c229bcc4a3556cdcc0d3ebcec:815
  "format" = "XPM"
  "licence" = "GPLv3"

# Documents:

Document "panthere": "animal", "drawing", "hand"
  With "designer" = "Me" ""
  "info" = "[P]erenial [A]rchive [N]etwork [There]"
  022a34b2f9b893fba5774237e1aa80ea:24075
  b281449c229bcc4a3556cdcc0d3ebcec:815

Grammar:

file: stanzas 
    | //empy file 

stanzas: stanzas stanza
       | stanza

stanza: defCategory
      | defHuman
      | defDocument
      | defArchive

caracs: caracs carac
      | carac

carac: string = string

defCategory: newCategory : categories caracs
           | newCategory : categories
           | newCategory caracs
           | newCategory

newCategory: TOP CATEGORY string
           | CATEGORY string

categories: categories , category
          | category

category: string

defHuman: newHuman : categories caracs
        | newHuman : categories
        | newHuman caracs
        | newHuman

newHuman: HUMAN human

human: string string

defArchive: newArchive archCaracs
         | newArchive

newArchive: ARCHIVE archive

archive: hash : number

defDocument: newDocument docCategories docWiths docCaracs docArchives 

newDocument: DOCUMENT document

document: string

docCategories: : categories
             | 

docCaracs: caracs
         | 

docWiths: roles
        | 

roles: roles role
     | role

role: WITH string = human

docArchives: archives
           | 

archives: archives archive
        | archive

hash:   [[:xdigit:]]{32}     
string: \"(\\\"|[^\n\"]){0,511}\" 
number: [[:digit:]]+

Code:

src/memory/catalogTree.h
src/memory/catalogTree.c
src/parser/catalogFile.l
src/parser/catalogFile.y