chickadee » atom » make-feed

(make-feed #!key KEYS) procedure

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

Required elements:

authors
a list of atom:author elements, the authors of the feed
id
an atom:id string, a permanent, unique absolute IRI identifier
title
an atom:title element, a human-readable title for the feed
updated
an atom:updated element, an RFC3339 timestamp indicating last update time

Optional elements:

categories
a list of atom:category elements, the feed categories
contributors
a list of atom:contributor elements, the contributors to the feed
generator
an atom:generator element, the feed generator
icon
an atom:icon element, the feed icon
links
a list of atom:link elements, the feed links
logo
an atom:logo element, the feed logo
rights
an atom:rights element, a human-readable description of rights held over the feed
subtitle
an atom:subtitle element, a human-readable subtitle for the feed
entries
a list of atom:entry elements, the feed entries

Notes:

  • It's a good idea to provide an "alternate" link for your feed and for each entry, pointing to the source document. See make-link.
  • authors may be omitted if all entries contain authorship information (meaning, atom:author elements as direct children). make-feed will detect this case.
  • If you omit generator, it defaults to describing this egg. To completely omit the generator element, which would make me sad, pass #f.