summary refs log tree commit diff
path: root/doc/user
diff options
context:
space:
mode:
authorLudovic Courtès2008-12-21 23:55:27 +0100
committerLudovic Courtès2008-12-21 23:55:27 +0100
commit9e19e1c62497d0164b12b832cfa89d6dc2e9bf9f (patch)
tree61e55cd71f4a44bbe38a41f37001f0cfc8af9235 /doc/user
parenta18292538f1d45d3f2dce8da530e031b91ac3739 (diff)
downloadskribilo-9e19e1c62497d0164b12b832cfa89d6dc2e9bf9f.tar.gz
skribilo-9e19e1c62497d0164b12b832cfa89d6dc2e9bf9f.tar.lz
skribilo-9e19e1c62497d0164b12b832cfa89d6dc2e9bf9f.zip
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.
Diffstat (limited to 'doc/user')
-rw-r--r--doc/user/syntax.skb19
1 files changed, 19 insertions, 0 deletions
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"