X-Git-Url: http://gitweb.fperrin.net/?p=atom.el.git;a=blobdiff_plain;f=atom.el;h=5d3df7b1544872027698f9f6a631905d2a318db0;hp=42738e5c755dcc9cc5745f328519a4fee04e6d6a;hb=d32925eb5a6b87479832943c6e27cb65c64f50fe;hpb=72e232fb4ae306f50cbc105a13f4bd7478f02b6f diff --git a/atom.el b/atom.el index 42738e5..5d3df7b 100644 --- a/atom.el +++ b/atom.el @@ -62,49 +62,56 @@ ;; "
One can also use XHTML in the entries.
") ;; (atom-print my-atom-feed)) - ;;; Code: (require 'xml) +(require 'url-parse) +(require 'cl) ; for setf in url-canonalize -(defun atom-create (title link &optional author updated id) +(defun atom-create (title link &optional subtitle 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. - 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. +SUBTITLE is a subtitle for the feed; it can be a bit longer than +TITLE, maybe a paragraph long. + +SELF is the canonical URL to this feed. ID is a unique identifier for this feed. If not given, it -defaults to LINK." - `((title nil ,title) - (link ((href . ,link))) - ,(atom-massage-author author) - (updated nil ,(atom-format-time updated)) - (id nil ,(or id link)))) +defaults to SELF. + +AUTHOR is the author of the feed. See `atom-massage-author' for +the possible ways to specify it. In particular, `nil' uses +`user-full-name' and `user-mail-address'. + +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)) + (if subtitle (atom-modify-entry atom-feed 'subtitle subtitle)) + (if self (atom-modify-entry atom-feed 'link + `(((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 self link)) + atom-feed)) (defun atom-push-entry (atom entry) "Add the entry ENTRY to the feed ATOM." - (nconc atom (list `(entry nil . ,entry)))) + (nconc atom (list `(entry nil ,@entry)))) (defun atom-modify-entry (entry name val) "Set the NAME element of ENTRY to VAL." - (let ((elem (assoc name entry))) - (if elem - (if (stringp val) - (setcar (cddr elem) val) - (setcdr elem val)) - (setq elem (if (stringp val) - (list name nil val) - (cons name val))) - (nconc entry (list elem))))) + (let ((elem (if (stringp val) + (list name nil val) + (cons name val)))) + (nconc entry (list elem)))) (defun atom-add-entry (atom title link content &optional updated id summary) @@ -147,21 +154,23 @@ when the content of the 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) + &optional updated id summary noconvert) "Add an entry to ATOM, with some XHTML content. CONTENT may be 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)) +fragment. See `atom-add-entry' for additional details. + +If CONVERT, 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)) + (atom-add-entry atom + title link xhtml-content + updated id (and summary (atom-massage-xhtml summary))))) (defun atom-print (atom) "Print the Atom feed ATOM in the current buffer." @@ -170,15 +179,107 @@ fragment. See `atom-add-entry' for additional details." (xml-print atom) (insert "\n")) +(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))) + +(defun atom-to-rss (atom) + "Translate an Atom feed into an RSS one, returning the translation. + +Some information may be lost or approximated." + (let ((rss (list (assoc 'title atom)))) + (atom-to-rss-translator atom rss '((subtitle . description) + (updated . pubDate) + (link . link))) + (atom-to-rss-modify-time rss) + (atom-to-rss-modify-link rss) + (dolist (entry (xml-get-children atom 'entry)) + (push (atom-to-rss-item entry) rss)) + (reverse rss))) + +(defun atom-to-rss-item (entry) + "Translates an Atom entry into an RSS item." + (let ((item (list (assoc 'title entry)))) + (atom-to-rss-translator + (xml-node-children entry) item + '((id . guid) (content . description) (updated . pubDate) (link . link))) + (atom-to-rss-modify-time item) + (atom-to-rss-modify-link item) + (let ((guid (assoc 'guid item)) + (descr (assoc 'description item))) + (if guid + (setcar (cdr guid) (list (cons 'isPermaLink "false")))) + (if (and descr + (equal (xml-get-attribute descr 'type) "xhtml")) + (setcar (cddr descr) (xml-node-text descr)))) + `(item nil ,@item))) + +(defun atom-to-rss-translator (source target translations) + (dolist (translation translations) + (let* ((from (car translation)) + (to (cdr translation)) + (data (copy-tree (cdr (assoc from source))))) + (when data + (atom-modify-entry target to data))))) + +(defun xml-node-text (node) + (with-temp-buffer + (xml-print (xml-node-children node)) + (buffer-string))) + +(defun atom-to-rss-modify-link (entry) + (let* ((link (assoc 'link entry)) + (link-addr (xml-get-attribute-or-nil link 'href))) + (when link + (setcar (cdr link) nil) + (setcdr (cdr link) (cons link-addr nil))))) + +(defun atom-print-as-rss (atom) + (let ((rss (atom-to-rss atom))) + (insert "\n") + (insert "