View source for jf2

[[File:jf2.svg|frameless|right|128px|jf2 icon]]

{{stub}}

'''<dfn>[https://jf2.spec.indieweb.org/ jf2]</dfn>''' is a W3C Note and a JSON Post Serialization Format  of [[microformats2]] for that is optimized for [[h-entry]] consuming code, as compared to the standard microformats JSON representation.

<div style="clear: both"></div>

;Status
:This is a living '''Editor's Draft''' yet mature enough to encourage [[#Implementations|implementations]] and [[#Feedback|feedback]].
;Editor's Draft
:https://jf2.spec.indieweb.org/
;W3C Note
:https://www.w3.org/TR/jf2/
;Participate
:Wiki ([[#Feedback|Feedback]], [[#Issues|Open issues]], [https://github.com/indieweb/jf2 issues on GitHub])
:[[IRC]]: [https://chat.indieweb.org/dev discussion on #indieweb-dev] [irc://irc.libera.chat/indieweb #indieweb-dev on Libera]
;Editors
:{{kevinmarks}}
:[[User:Ben.thatmustbe.me|Benjamin Roberts]] 

jf2 was published by the [[W3C]] Social Web Working Group as a [https://www.w3.org/TR/2018/NOTE-jf2-20180110/ W3C Note on 2018-01-10], and is currently maintained by the IndieWeb community as a Living Standard at https://jf2.spec.indieweb.org/

__TOC__

== Use cases ==

=== Common data structure for Microsub servers ===

The [[Microsub-spec]] draft standard specifies jf2 as the format in which objects should be stored. Servers who aim to comply with the standard must store objects in jf2. Clients must interpret jf2 objects to render content from feeds polled by the server.

=== Personal website feed ===

Some IndieWeb community members publish jf2 feeds directly to their websites.

=== Add more ===

Have a use case for jf2? Add it here.

== Example ==
<pre>
{
  "type":"entry",
  "author":{
    "type":"card",
    "name":"Kevin Marks",
    "photo":"http://known.kevinmarks.com/file/9255656669173b7867ab839ee6556f9e",
    "url":"http://known.kevinmarks.com/profile/kevinmarks"
  },
  "url":"http://known.kevinmarks.com/2015/i-was-just-listening-to-programmesp02xy80y-about-how-we-reconstruct",
  "published":"2015-07-30T00:32:47+00:00",
  "content":{
    "text":"I was just listening to http://www.bbc.co.uk/programmes/p02xy80y about how we reconstruct memories continuously, and they can be changed by other people gaslighting us. Once silos learn to do this your written records will be even more precious.",
    "html":"<p>I was just listening to <a href=\"http://www.bbc.co.uk/programmes/p02xy80y\" rel=\"nofollow\">http://www.bbc.co.uk/programmes/p02xy80y</a> about how we reconstruct memories continuously, and they can be changed by other people gaslighting us. Once silos learn to do this your written records will be even more precious.</p>\n "
  },
  "in-reply-to": [
      "http://rhiaro.co.uk/2015/07/digital-memories"
  ],
  "wm-property":"in-reply-to"
}
</pre>

This example of jf2 contains an additional "wm-property" value that indicates the property that contains the primary relation of the webmention. In the example above, this is the "in-reply-to" property, but may also be the "like-of" or "repost-of" property.

== IndieWeb Examples ==

=== Aaron Parecki ===
{{aaronpk}} publishes a jf2 feed of his home page and other top-level feeds since 2017-11-25. The jf2 feed is generated by running the HTML of the generated page through [[XRay]] to output the jf2 format.

* https://aaronparecki.com/primary.jf2
* https://aaronparecki.com/replies.jf2
* https://aaronparecki.com/checkins.jf2

=== Grant Richmond ===
{{grantcodes}} is creating a collection of jf2 format post examples at https://grantcodes.github.io/jf2-examples/

=== Kaushal Modi ===
{{kaushalmodi}} publishes jf2 feeds of his home page and other top-level feeds since 2018-04. The jf2 feed is generated using Hugo ([https://gitlab.com/kaushalmodi/hugo-theme-refined/blob/02437d19c3ca585d742a59d4e551bb489214e7da/layouts/_default/list.jf2feed.json Template for generating the jf2 feed]). Similarly jf2 posts are also generated for each post ([https://gitlab.com/kaushalmodi/hugo-theme-refined/blob/02437d19c3ca585d742a59d4e551bb489214e7da/layouts/_default/single.jf2post.json Template for generating the jf2 post]).

* jf2 feed on home page: https://scripter.co/jf2feed.json
* jf2 feed for all posts in 'emacs' category (example): https://scripter.co/categories/emacs/jf2feed.json
* Example of jf2 post: https://scripter.co/fragmentions/jf2post.json

=== Jason Garber ===
{{jgarber}} publishes jf2 [[sidefile-antipattern|sidefiles]] of content types using [[FrancisCMS]] on his personal website, https://sixtwothree.org.

* [[article|Post]]: https://sixtwothree.org/posts/launching-franciscms-onto-the-indieweb.json
* [[bookmark|Link]]: https://sixtwothree.org/links/885.json
* [[photo|Photo]]: https://sixtwothree.org/photos/31.json

== Implementations ==
=== webmention.io ===
[[webmention.io]] can return a list of mentions of a URL in jf2 format. For example, https://webmention.io/api/mentions.jf2?target=http://rhiaro.co.uk/2015/07/digital-memories

=== XRay ===
[[XRay]] parses a number of different formats into a normalized jf2 format. For example:

* [https://xray.p3k.io/parse?url=https%3A%2F%2Faaronparecki.com%2F2017%2F10%2F04%2F7%2Fhwcpdx a note]
* [https://xray.p3k.io/parse?url=https%3A%2F%2Faaronparecki.com%2F2017%2F10%2F28%2F12%2F a checkin]

=== socialstreams ===
{{benthatmustbeme}} has set up a stream service at http://stream.thatmustbe.us that can convert MF2 to JF2 and back again.  Code can be found on [https://github.com/dissolve/socialstream GitHub]

=== Post Kinds for WordPress ===
{{gwg}} began converting his parsing code within the Post Kinds plugin to returnn jf2 and will likely be reimplementing additional code within same to use a mix of jf2 and mf2 as a way of ensuring better consistency and cross-compatibility. This is a work in progress.

=== IndieWeb Search ===

[[IndieWeb_Search|IndieWeb Search]] offers a jf2 feed for all search results. Visitors can subscribe to this feed in any feed reader that parsers jf2. Visitors can also parse this feed to derive insights from search results or watch for search rank changes.

=== capjamesg ===

{{capjamesg}} offers jf2 feeds for his posts, notes, likes, and bookmarks on his personal website:

* https://jamesg.blog/feeds/posts.jf2
* https://jamesg.blog/feeds/notes.jf2
* https://jamesg.blog/feeds/likes.jf2
* https://jamesg.blog/feeds/bookmarks.jf2

James has also implemented logic that converts XML (RSS/Atom), JSON Feed, and h-feeds to jf2 as part of his Microsub reader. This logic is available in files in the following folder on GitHub:

https://github.com/capjamesg/microsub/tree/main/feeds

=== more implementations ===
* See: http://microformats.org/wiki/jf2#Implementations for more open source parsers, jf2 converters, consuming code, etc.

== See Also ==
* http://microformats.org/wiki/jf2
* https://www.w3.org/TR/jf2/
* [[microformats2]]
* https://github.com/aaronpk/XRay#response-format
* [https://github.com/indieweb/jf2 jf2 specification source]
* [https://github.com/indieweb/jf2/issues jf2 spec issues and feature requests]
* [[JF2 Feed]]