ρ (rho) wrote in lj_userdoc,
ρ
rho
lj_userdoc

  • Mood:

[syn] adding atom to the FAQ

Based on discussion from about a month ago in suggestions, I'd like to suggest the following changes to the syndication FAQs to include mention of Atom feeds:



FAQ 178:

Change to paragraph 2 to read as follows:

LiveJournal implements syndication by creating "Syndicated Accounts". These are updated when the account reads an RSS or Atom file from the host site and cannot be updated in any other way. LiveJournal regularly reads the RSS or Atom file to determine whether it has been updated. (Note that LiveJournal does not read directly from the site's homepage; the site must have either an RSS or an Atom feed.) If it has been updated, LiveJournal will create new entries in the syndicated account corresponding to the new content in the file. The entries will then remain available on LiveJournal for two weeks, after which they are deleted. For more information about syndicated accounts, see http://www.livejournal.com/support/faqbrowse.bml?faqid=150.

FAQ 149:

Change the title to "Where can I get an RSS or Atom feed of my journal?" and the FAQ to read as follows, in its entirety:

All journals on LiveJournal have both an RSS and an Atom feed. These are located at URLs of the following forms:

http://www.livejournal.com/users/exampleusername/data/rss
http://www.livejournal.com/users/exampleusername/data/atom

In both cases, "exampleusername" is replaced by your username.

Both of these feeds display only the 25 most recent entries. Protected entries are visible if the user requesting the feed is able to authenticate with LiveJournal and has permission to see the entries. This may be done either through your browser's login cookies, or by HTTP Digest Auth by appending ?auth=digest to the URL. That is:

http://www.livejournal.com/users/exampleusername/data/rss?auth=digest
http://www.livejournal.com/users/exampleusername/data/atom?auth=digest

For example, if you view your RSS feed in your browser while logged in, you will see all your most recent entries in it. However, someone who is not logged in, or someone you do not list as a friend, would not be able to see any protected entries in the feed.

Feeds include the subject (when present), the full text of the entry, and a link to the entry.

Information about how bots may be used to read these files can be found at http://www.livejournal.com/bots/.

[this also adds mention of digest auth and /bots/]

FAQ 137:

Change the third paragraph to read:

If you are creating a new syndicated account, you will need to fill out the form at the bottom of http://www.livejournal.com/syn/. You must enter both the desired username (which cannot already be in use) and the correct URL of the site's RSS or Atom feed. You cannot enter the URL of a regular HTML page on the site. You may be able to learn the URL of a site's RSS or Atom feed by contacting the webmaster or support service of the site. Users with free accounts cannot create new feeds.

FAQ 152:

Modify the last paragraph to read:

Viewing a syndicated form of a journal in this manner will only allow you to view the user's public entries, even if the user also watches your RSS or Atom feed, because you cannot add each other as friends in the way that you can add other users on the same site. On your friends page, rather than seeing the entries normally, you may only see the subject or first few words of each entry and a link to the entry. Any comments that you leave on the entry through LiveJournal will only appear to users viewing the entry through LiveJournal. As such it is recommended that you visit the other journal site to make any comments.

[I decided to keep the rest as it is, since the old RSS link is standard, and going into more detail would just be confusing]

FAQ 151:

Modify this FAQ to read in full:

The most common cause for a syndicated account failing to update is some sort of problem with the RSS or Atom feed that it is syndicating from.

* The site must be a valid RSS or Atom feed. A normal HTML page will not work.

* The feed must contain valid RSS or Atom code. You can check that the feed's code is valid by using a feed validator. One can usually be found by performing a query for "feed validator" on your favorite search engine.

If no updates are appearing, it is also possible that the feed itself is not updating, even if it contains valid RSS or Atom code and even if the site that it is syndicating from is updating.

FAQ 150:

Change the first paragraph to read:

Once a syndicated account has been created, nobody owns it. Nobody can log into it, make comments from it, or make entries to it in the conventional way. The only way that a syndicated account can be updated is from reading an updated RSS or Atom feed.

If your site does not offer an RSS feed, and it is being "screenscraped" and syndicated onto LiveJournal, please follow the instructions in http://www.livejournal.com/support/faqbrowse.bml?faqid=105 to contact the Abuse team.

FAQ 155:

Change the final paragraph to read:

If your site offers an RSS or Atom feed, but you do not want that feed syndicated onto LiveJournal, you can block LiveJournal's IP (66.150.15.150) from accessing your server.

and if there are any translate:en_LJ privs around (I'm too lazy to make a separate entry to lj_english), we could also do with making the following change on /syn/:

Here you can add syndicated feeds (RSS)

changed to

Here you can add syndicated feeds (RSS or Atom)
Tags: cat-syn, faq137, faq149, faq150, faq151, faq152, faq155, faq178, status-resolved
Subscribe
  • Post a new comment

    Error

    Comments allowed for members only

    Anonymous comments are disabled in this journal

    default userpic

    Your reply will be screened

    Your IP address will be recorded 

  • 9 comments