This page discusses how to add a new community discussion source to the Praxeon content repository. Like blogs and news, discussions are imported from RSS and Atom feeds. However, in order to most accurately and completely import a discussion, some extended and optional fields should be included.

Atom With Extensions

Discussions can be imported directly in Atom format if the following extensions are included in each document.

author uri

When possible, each author element should provide the URI to the author's profile page. In the Atom format, this information is provided through the Person Construct.

Atom Threading

The Atom Threading Extensions specification describes how to add threading information to an Atom feed. Providing this full threading information is important so that the Praxeon API can fully index each discussion, and determine which discussions have active responses and which do not.

in-reply-to

This element may be added to discussions responses to indicate which discussion post is being responded to.

replies

Indicates a feed that may be used to fetch replies to the post.

total

Indicates the total number of responses to the post.

In this model, one feed lists the posts and separate feed for each post lists the responses.

Complete Discussion

As an alternative to the Atom Threading model, a single feed may provide the complete text of each discussion in each entry. All the authors (of the original post and the responses) can be listed, along with the Atom Threading total element. The original post and the responses can be separated into separate HTML <p> elements with some minimal formatting to separate the post from the responses.

hatom Microformat

As an alternative to publishing the discussion as a feed, the hatom microformat specification may be used to indicate the Atom structure of the discussion in HTML format. For examples, see hatom examples in the wild.