View source for Atom

You do not have permission to edit this page, for the following reason:
The action you have requested is limited to users in the group: Users.
You can view and copy the source of this page.
<img style="float:right; max-width: 200px; margin-top:-32px" src="http://dret.net/lectures/services-spring08/img/atom-logo.png"/>
<!-- http://www.topdj.pl/www/grafika/wolne/atom-logo.gif -->
<!-- http://readwrite.com/files/files/files/images/atomenabled_logo.png -->

{{stub}}

'''<dfn>[https://indieweb.org/site-deaths#atomenabled.org Atom]</dfn>''' is an XML format and protocol for publishing [[feeds]] that was developed as a more formally specified alternative to [[RSS]].

Looking for some other Atom? See: [[#Other_Things_Called_Atom|Other Things Called Atom]]

'''[[h-entry]]''' and '''[[h-feed]]''' are [[microformats2]] vocabularies based on Atom, which supersede the classic [[hAtom]] microformat.

Atom is defined in [https://tools.ietf.org/html/rfc5023 RFC 5023] (format) and [https://tools.ietf.org/html/rfc4287 RFC 4287] (protocol). atomenabled.org was the canonical web site, [[site-deaths#atomenabled.org|but it died]].

== IndieWeb Examples ==
{{see_also|RSS#Indieweb_Examples|RSS Indieweb Examples}}
__TOC__

=== Tantek ===
{{t}} generates (using [[Falcon]]) a minimal subset Atom+ActivityStreams feed on tantek.com from storage. Due to bandwidth inefficiency of XML formats (and apparent bandwidth abuse of XML consuming code/servers), his Atom [[feed file]] only has the most recent 1 item(s), whereas his [[h-feed]] on his home page has the latest 64 items (as of 2015-265). See also [[feed_file#Criticism|feed file: Criticism]] and in particular [[feed#Criticism|feed: Criticism]].

=== Barnaby Walters ===
[[User:WaterPigs.co.uk|Barnaby]] publishes auto-discoverable ATOM feeds on all feed pages using [[Taproot]] on [http://waterpigs.co.uk waterpigs.co.uk] e.g. [https://waterpigs.co.uk/services/microformats-to-atom/?url=https%3A%2F%2Fwaterpigs.co.uk%2F the homepage] since ????-??-??.
* The feeds are automatically generated from the h-entry microformats on the page, so I only have to maintain the HTML which works for humans and machines rather than two copies. The endpoint I use for converting is open for anyone to use: [https://waterpigs.co.uk/services/microformats-to-atom/ microformats to ATOM] --[[User:Waterpigs.co.uk|Barnaby Walters]] 10:17, 10 February 2015 (PST)

=== Christian Weiske ===
{{cweiske}}'s blog natively generates full-text atom feeds for tag-filtered and all posts

=== gRegor Morrill ===
{{gRegor}} publishes an Atom feed for articles as of 2015-02-11
* http://gregorlove.com/articles.atom
* Previously I was publishing an RSS 2.0 feed that was delivered by [[FeedBurner]]. I migrated back to a self-hosted feed due to the unsure future of FeedBurner, plus having more control of the feed since it is on my own domain again.

As of 2016-03-08, I'm experimenting with [[Granary]] to convert my notes [[h-feed]] into an Atom feed.
* http://gregorlove.com/notes.atom

=== Anthony Ciccarello ===
{{aciccarello}} publishes an Atom feed of all posts ([[article]], [[recipe]], and [[photo]]).
* https://www.ciccarello.me/feed.xml
* Have [[XSL]] for viewing from a browser ([https://www.ciccarello.me/blog/2021/04/17/styling-an-rssatom-feed-with-xsl/ blog post])
* Feed is limited to 30 posts with only the first 10 full text

=== David Foley ===
{{dsofeir}}'s site [https://www.dfoley.ie dfoley.ie] uses the [https://getgrav.org/ Grav CMS] [https://github.com/getgrav/grav-plugin-feed Feed] plugin to publish an [https://www.dfoley.ie/blog.atom Atom feed of all his blog posts]. 

=== Past Examples ===
==== Sandeep Shetty ====
'''sandeep.io''' (now redirects to a Blogger blog) previously generated an Atom feed from [http://microformats.org/wiki/h-feed h-feed] (using an h-feed to atom proxy). See [https://web.archive.org/web/20160308224149/http://www.sandeep.io/98 DRY: h-feed enabled = Atom enabled] (was at <nowiki>http://www.sandeep.io/98</nowiki>) -[[User:Www.sandeep.io|Www.sandeep.io]] 14:06, 30 June 2013 (PDT)

==== Kyle Mahan ====
{{warning|Kyle's site is now unfortunately a [[zombie]] site, so links have been replaced with archived versions}}
{{kylewm}} published an Atom feed for all post feeds (most recent iteration since 2014-09-13).
* add ?feed=atom to any regular feed for an Atom version. e.g.,
** [https://web.archive.org/web/20150109142259/https://kylewm.com/?feed=atom archived example]
** [https://web.archive.org/web/20190405115005/https://kylewm.com/photos/?feed=atom archived example]
** [https://web.archive.org/web/20190405114959/https://kylewm.com/tags/indieweb/?feed=atom archived exmaple]
* Entries includes simple reply/repost context

== Projects ==
=== granary ===
{{snarfed}}'s [https://github.com/snarfed/granary granary] fetches and converts [[Facebook]], [[Flickr]], [[Twitter]], [[Instagram]], and [[Google+]] data to and from Atom, as well as other formats like [[ActivityStreams]] and [[microformats2]] HTML/JSON.

=== hfeed2atom ===
[https://github.com/kartikprabhu/hfeed2atom hfeed2atom] converts h-feeds to atom feeds.

=== Unmung ===
{{main|unmung}}
* [[unmung]] generates an h-feed from any Atom or RSS one

== Autodiscovery ==
Atom feeds can be automatically discovered by [[feed reader]]s if the homepage contains a link to it in its <tt><head></tt> tag:

 <link rel="alternate" type="application/atom+xml" title="Feed" href="atomfeed.xml" />

The title is important if there are multiple feeds linked, e.g. category and comment feeds.

== Comments ==

The [https://tools.ietf.org/html/rfc4685 Atom Threading Extensions RFC 4685] extends the Atom XML format to allow direct embedding of comments for posts/entries in the atom feed, as well as linking to comment feed files for single posts.

Software generating Atom feeds with comments:

* [[Wordpress]] ([https://core.trac.wordpress.org/browser/trunk/src/wp-includes/feed-atom.php], [https://core.trac.wordpress.org/browser/trunk/src/wp-includes/feed-atom-comments.php])
* [[granary]] includes <tt><thr:in-reply-to></tt> tags in its atom feeds

[[reader]]s supporting atom comments:

* (?)

=== Examples ===
* https://david.shanske.com/feed/atom/ contains:

 <entry>
  [...]
  <link rel="replies" type="text/html" href="https://david.shanske.com/2018/03/18/an-indieweb-podcast-episode-0/#comments" thr:count="11"/>
  <link rel="replies" type="application/atom+xml" href="https://david.shanske.com/2018/03/18/an-indieweb-podcast-episode-0/feed/atom/" thr:count="11"/>
  <thr:total>11</thr:total>
 </entry>

== Shutdowns ==
See: [[feeds#Shutdowns|Feeds: Shutdowns]]

== Criticism ==
See: [[feed#Criticism|Criticism of legacy feed formats]]

== History ==
This section is a stub. For additional history see [http://en.wikipedia.org/wiki/Atom_%28standard%29#Development_history Wikipedia: Atom Development History] (though it may not have all the details present here).

=== Conceived ===
* 2003-06-16 The effort to define a "conceptual data model of what constitutes a well formed log entry" blogged by Sam Ruby in <cite>[http://www.intertwingly.net/blog/1472.html Anatomy of a Well Formed Log Entry]</cite> was the start of what became Atom.

=== Launch ===
* 2003-06-23 the effort that became Atom was more formerly launched, with various supporting blog posts in the following days. A small sample from the [http://intertwingly.net/wiki/pie/RoadMap launch roadmap]:
** 2013-06-23 Aaron Swartz: [http://www.aaronsw.com/weblog/000985 Time for Forward Motion] [Aaron co-authored [http://web.resource.org/rss/1.0/spec RSS 1.0]]
** 2013-06-24 Mena Trott: [http://www.sixapart.com/blog/2003/06/on-the-roadmap.html On The Roadmap] [Mena co-founded SixApart, a very early blogging startup]

=== Pie ===
'''<dfn>Pie</dfn>''' was the original name given the to the syndication format project that became Atom. Early posts/pages that mention Pie and its use as a starting point
* http://www.intertwingly.net/wiki/pie/ProjectNameProcess

=== Echo ===
'''<dfn>Echo</dfn>''' was the second name given the to syndication format project that became Atom. Early pages/posts that mention Echo:
* 2003-06-29 Ben Trott: [https://web.archive.org/web/20140801155433/http://www.sixapart.com/blog/2003/06/why-we-need-ech.html Why We Need Echo] (original permalink dead: www.sixapart.com/blog/2003/06/why-we-need-ech.html )
* Pie wiki: [http://www.intertwingly.net/wiki/pie/NameItEchoConflict Echo Conflicts With Another Project]

=== Atom named ===
* 2003-09-30 Voting closed, "Atom" [http://www.intertwingly.net/wiki/pie/NameFinalVote clear winner] among [http://www.intertwingly.net/wiki/pie/ProjectNameProposals numerous proposals].

=== RSS Atom wars ===
{{main|RSS Atom wars}}
From 2003-2007 (at least) there was significant energy put into debating the merits of using [[Atom]] vs [[RSS]]. This quite heated ongoing debate earned the name of "<dfn>RSS Atom Wars</dfn>" or "<dfn>syndication wars</dfn>".

See: [[RSS Atom wars]] for citations and quotes from articles during this time period that illustrate the tensions and conflicts.

== Other Things Called Atom ==
=== Atom.io ===
'''<dfn>[https://atom.io Atom.io]</dfn>''' was a code editor from GitHub, discontinued on 2022-12-15.

== See Also ==
* [[RSS]]
* [[XSLT]]
* [[ActivityStreams]]
* [[feed]]
* [[hAtom]]
* [[h-entry]]
* [[stream]]
* Original Pie/Atom development wiki: http://www.intertwingly.net/wiki/pie/ (historical, no updates since 2008)
Return to Atom.
Retrieved from "https://indieweb.org/Atom"