aboutsummaryrefslogtreecommitdiff
path: root/docs/extensions/RSS.txt
blob: f2ecf0c5e92834c77e8f43f4caef87bce77cdf2a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
RSS
===

Summary
-------

An extension to Python-Markdown that outputs a markdown document as RSS. This 
extension has been included with Python-Markdown since 1.7 and should be 
available to anyone who has a typical install of Python-Markdown.

Usage
-----

From the Python interpreter:

    >>> import markdown
    >>> text = "Some markdown document."
    >>> rss = markdown.markdown(text, ['rss'])

Configuring the Output
----------------------

An RSS document includes some data about the document (URI, author, title) that
will likely need to be configured for your needs. Therefore, three configuration
options are available:

* **URL** : The Main URL for the document.
* **CREATOR** : The Feed creator's name.
* **TITLE** : The title for the feed.

An example:

    >>> rss = markdown.markdown(text, extensions = \
    ...        ['rss(URL=http://example.com,CREATOR=JOHN DOE,TITLE=My Document)']
    ... )