(require 'xml)
-(defun atom-create (title link &optional author self updated id)
+(defun atom-create (title link &optional self id author updated)
"Create a new atom structure.
TITLE is the title for the feed, a short, text-only, human
readable string.
-AUTHOR is the author of the feed. See `atom-massage-author' for
-the possible ways to specify it.
-
-SELF is the canonical URL to this feed.
-
LINK is the URL of a page responible for the content of this
feed.
-UPDATED is the date the feed was last updated. If not given,
-`(current-time)' is used.
+SELF is the canonical URL to this feed.
ID is a unique identifier for this feed. If not given, it
-defaults to LINK."
+defaults to SELF.
+
+AUTHOR is the author of the feed. See `atom-massage-author' for
+the possible ways to specify it.
+
+UPDATED is the date the feed was last updated. If not given,
+`(current-time)' is used."
(let ((atom-feed (list (list 'title nil title))))
(atom-modify-entry atom-feed 'link `(((href . ,link))))
(atom-modify-entry atom-feed 'author (atom-massage-author author))
`(((href . ,self) (rel . "self")
(type . "application/atom+xml")))))
(atom-modify-entry atom-feed 'updated (atom-format-time updated))
- (atom-modify-entry atom-feed 'id (or id link))
+ (atom-modify-entry atom-feed 'id (or id self link))
atom-feed))
(defun atom-push-entry (atom entry)
be a string enconding a valid HTML fragment. See `atom-add-entry'
for additional details."
(atom-add-entry atom
- title link
- (atom-massage-html content)
- (and summary (atom-massage-html summary))
- updated id))
+ title link (atom-massage-html content)
+ updated id (and summary (atom-massage-html summary))))
(defun atom-add-xhtml-entry (atom title link content
&optional updated id summary)
given either as a string, or as an XML tree, of a valid XHTML
fragment. See `atom-add-entry' for additional details."
(atom-add-entry atom
- title link
- (atom-massage-xhtml content)
- (and summary (atom-massage-xhtml summary))
- updated id))
+ title link (atom-massage-xhtml content)
+ updated id (and summary (atom-massage-xhtml summary))))
(defun atom-print (atom)
"Print the Atom feed ATOM in the current buffer."
(xml-print atom)
(insert "\n</feed>"))
+(defun atom-write-file (atom filename)
+ "Writes the feed ATOM to FILENAME."
+ (with-temp-buffer
+ (atom-print atom)
+ (write-region (point-min) (point-max) filename)))
+
\f
(defun atom-format-time (&optional time)
"Format a time according to RFC3339."
(defun atom-string-to-xml (string)
"Convert STRING into a Lisp structure as used by `xml.el'."
(with-temp-buffer
+ (insert "<div xmlns=\"http://www.w3.org/1999/xhtml\">")
(insert string)
+ (insert "</div>")
(xml-parse-region (point-min) (point-max))))
(defun atom-massage-xhtml (content)
"Massage CONTENT so it can be used as an XHTML fragment in an
Atom feed."
- (list '((type . "xhtml"))
- `(div ((xmlns . "http://www.w3.org/1999/xhtml"))
- ,@(or (and (stringp content)
- (atom-string-to-xml content))
- content))))
+ `(((type . "xhtml"))
+ ,@(or (and (stringp content)
+ (atom-string-to-xml content))
+ content)))
(defun atom-massage-author (author)
"Return an XML node representing the author. AUTHOR can be: