From 9e19e1c62497d0164b12b832cfa89d6dc2e9bf9f Mon Sep 17 00:00:00 2001
From: Ludovic Courtès
Date: Sun, 21 Dec 2008 23:55:27 +0100
Subject: Add `rss-2' reader, for RSS 2.0 feeds as an input syntax.

* src/guile/skribilo/reader/rss-2.scm: New file.

* src/guile/Makefile.am (readers): Add `rss-2.scm'.

* po/POTFILES.in: Add `rss-2.scm'.

* doc/user/syntax.skb (rss2-syntax): New section.

* NEWS: Update.
---
 doc/user/syntax.skb | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

(limited to 'doc')

diff --git a/doc/user/syntax.skb b/doc/user/syntax.skb
index cdcdf9c..ba2b800 100644
--- a/doc/user/syntax.skb
+++ b/doc/user/syntax.skb
@@ -210,6 +210,25 @@ documents that can be output in variety of formats (see ,(numref :text
 markup-less document format, there are many things that cannot be done
 using it, most notably tables, bibliographies, and cross-references.]))
    
+   (section :title [The RSS 2.0 Syntax]
+            :ident "rss2-syntax"
+      
+      (p [RSS 2.0 (aka. ,(ref :url "http://en.wikipedia.org/wiki/RSS" :text
+(emph [Really Simple Syndication]))) is supported as an input syntax.
+To use it, just pass ,(tt [--reader=rss-2]) to the compiler.  This
+makes it possible to generate Skribilo documents from RSS 2.0 feeds,
+which can be useful or at least funny.  Consider the following example:]
+
+   (disp :verb #t [
+$ wget http://planet.gnu.org/rss20.xml
+$ skribilo -R rss-2 -t lout -c column-number=2 < rss20.xml \\
+  | lout | ps2pdf - > gnu-planet.pdf
+])
+
+[It produces a two-column PDF file with the contents of the RSS feed of
+GNU Planet, where each item of the feed is mapped to a Skribilo
+``chapter''.]))
+   
    (section :title [Documents in Scheme Programs]
             :ident "scheme-syntax"
       
-- 
cgit v1.2.3