chickadee » atom » make-entry

make-entry #!key KEYSprocedure

Make a new atom:entry element, with KEYS corresponding to child elements. Raises an error if any required elements are missing.

Required elements:

id
an atom:id string, a permanent, unique absolute IRI identifier for the entry
title
an atom:title element, a human-readable title for the entry
updated
an atom:updated element, an RFC3339 timestamp indicating last update time

Optional elements:

authors
a list of atom:author elements, the authors of the entry
categories
a list of atom:category elements, the entry categories
contributors
a list of atom:contributor elements, the contributors to the entry
content
an atom:content element, the entry content
links
a list of atom:link elements, the entry links
published
an atom:published element, an RFC3339 timestamp indicating initial creation time
rights
an atom:rights element, a human-readable description of rights held over the entry
source
an atom:source element, information about the feed source for content aggregators
summary
an atom:summary element, a human-readable summary, abstract or excerpt of the entry

Additional notes:

Entry author elements are optional as long as the containing feed contains authorship information. If the feed does not, the entry must contain least one author element. This will be checked in make-feed.

Entry elements without a atom:content element must contain an atom:link with link-relation "alternate". This is checked in make-entry.

Entry summary elements are optional unless an atom:content element is present and its content kind is 'external or 'binary. This is checked in make-entry.

It is illegal for entries to contain more than one atom:link element with a link-relation of "alternate" and the same type and uri-language values. This is not checked in make-entry.