-;;; atom.el --- Create an Atom feed
+;;; atom.el --- Create an Atom feed -*- lexical-binding: t -*-
;; Copyright (C) 2011 Frédéric Perrin
;;
;; (atom-print my-atom-feed)
;; ;; If you prefer RSS feeds:
-;; (atom-to-rss-print my-atom-feed))
+;; (atom-print-as-rss my-atom-feed))
;; Full documentation is available at <http://tar-jx.bz/code/atom.html>.
ID defaults to LINK, which is not optimal; see `atom-generate-id'
for a way to create good identifiers. For a given entry, it must
not change between successive generations of the atom feed, even
-when the content of the entry ."
+when the content of the entry changes."
(let ((entry (list (list 'title nil title))))
(atom-modify-entry entry 'link (list (list (cons 'href link))))
(atom-modify-entry entry 'id (or id link))
given either as a string, or as an XML tree, of a valid XHTML
fragment. See `atom-add-entry' for additional details.
-If CONVERT, translate all links in CONTENT so that they are no
-longer relative to LINK."
+If NOCONVERT is nil, translate all links in CONTENT so that they
+are no longer relative to LINK."
(let ((xhtml-content (atom-massage-xhtml content)))
(unless noconvert
(atom-xhtml-convert-links (cadr xhtml-content) link))
(defun atom-print (atom)
"Print the Atom feed ATOM in the current buffer."
- (insert "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n")
+ (insert atom-xml-declaration)
(insert "<feed xmlns=\"http://www.w3.org/2005/Atom\">\n")
(xml-print atom)
(insert "\n</feed>"))
"Writes the feed ATOM to FILENAME."
(with-temp-buffer
(atom-print atom)
- (write-region (point-min) (point-max) filename)))
+ (write-file filename)))
\f
(defun atom-to-rss (atom)
(defun atom-print-as-rss (atom)
(let ((rss (atom-to-rss atom)))
- (insert "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n")
+ (insert atom-xml-declaration)
(insert "<rss version=\"2.0\">\n")
(insert " <channel>\n")
(xml-print rss " ")
(defun atom-to-rss-time (time)
"Translates a string from the format used by Atom into the
format used by RSS."
- ;; Same remark as in `atom-format-time'
(let ((system-time-locale "C"))
(format-time-string "%a, %d %b %Y %T %z" (atom-parse-time time))))
"Saves ATOM as a RSS feed into FILENAME."
(with-temp-buffer
(atom-print-as-rss atom)
- (write-region nil nil filename)))
+ (write-file filename)))
\f
(defvar atom-time-format-string "%Y-%m-%dT%T%z"
"The format for string representation of dates.")
+(defvar atom-xhtml-namespace "http://www.w3.org/1999/xhtml")
+
+(defvar atom-xml-declaration "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n")
+
(defun atom-format-time (&optional time)
"Format a time according to RFC3339."
;; The time zone must be specified in numeric form, but with a colon between
(defun atom-parse-time (&optional time)
"Parse a time as specified in RFC3339 into Emacs's native format."
+ ;; Same remark as in `atom-format-time'
(date-to-time (replace-regexp-in-string ":\\(..\\)$" "\\1" time)))
(defun atom-massage-html (content)
(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))))
+ (require 'xml-xhtml-entities)
+ (let ((xml-entity-alist xml-xhtml-entities)
+ (xml-validating-parser t))
+ (with-temp-buffer
+ (insert "<div xmlns=\"" atom-xhtml-namespace "\">")
+ (insert string)
+ (insert "</div>")
+ ;; `xml-parse-region' returns a list of elements, even though it
+ ;; requires an only root node. We are only interested in the first
+ ;; one, the DIV we just inserted.
+ (car (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."
- `(((type . "xhtml"))
- ,@(or (and (stringp content)
- (atom-string-to-xml content))
- content)))
+ (list '((type . "xhtml"))
+ (or (and (stringp content)
+ (atom-string-to-xml content))
+ `(div ((xmlns . ,atom-xhtml-namespace)) ,@content))))
(defun atom-massage-author (author)
"Return an XML node representing the author. AUTHOR can be:
(url-recreate-url url-base))))
(defun xml-node-as-text (node)
- "Return a string representing NODEn, an XML structure."
+ "Return a string representing NODE, an XML structure."
(with-temp-buffer
(xml-print (xml-node-children node))
(buffer-string)))
+(defun xml-node-create (name attrlist childlist)
+ "Create a new XML node."
+ (list name attrlist . childlist))
+
(provide 'atom)
;;; atom.el ends here