Really Simple Discoverability - blojsom - Confluence

blojsom supports the Really Simple Discoverability RFC through its RSD flavor template. This allows weblog clients such as ecto or w.bloggar to discover the available endpoints to "work with" your blog.

Template Location and Flavor Configuration

The RSD flavor template, rsd.vm, can be found in your blog's templates directory.

The flavor configuration can be found in the flavor.properties file in your blog's configuration directory. The following line correctly configures the RSD flavor template.

rsd=rsd.vm, application/rsd+xml;charset=UTF-8

Template Configuration for RSD

To provide the location for services to access the RSD flavor, one the following links needs to be added to your template page where HTML headers are located. For example, these HTML head tags are located in the default Asual theme template, asual-head.vm.

<link rel="EditURI" type="application/rsd+xml" title="RSD" href="$BLOJSOM_BLOG.getBlogURL()?flavor=rsd"/>

or

<link rel="EditURI" type="application/rsd+xml" title="RSD" href="#BlogURL()?flavor=rsd"/>

The second link just uses one of the available template macros to print the URL of your blog.

Accessing RSD

Add ?flavor=rsd to the end of your blog's URL to see the rendered RSD template. This is only useful for weblog clients or other software which uses RSD.

Example

The following is the RSD flavor template included with blojsom. If for some reason the rsd.vm template did not exists in your blog's templates directory, you could re-create the file using this text.

<?xml version="1.0" ?>

<rsd version="1.0" xmlns="http://archipelago.phrasewise.com/rsd">
    <service>
        <engineName>$BLOJSOM_VERSION</engineName>
        <engineLink>http://blojsom.sourceforge.net</engineLink>
        <homePageLink>#BlogURL()</homePageLink>
        <apis>
            <api name="blogger" preferred="false" apiLink="#BlogBaseURL()/xmlrpc/$BLOJSOM_USER/" blogID="" />
            <api name="metaWeblog" preferred="true" apiLink="#BlogBaseURL()/xmlrpc/$BLOJSOM_USER/" blogID="" />
            <api name="mt" preferred="false" apiLink="#BlogBaseURL()/xmlrpc/$BLOJSOM_USER/" blogID="" />
            <api name="atom" preferred="false" apiLink="#BlogBaseURL()/atomapi/$BLOJSOM_USER/" blogID="" />
        </apis>
    </service>
</rsd>