| Line | c1c3071b0ac3127c2969b24e26d439510fdc8c96 | current |
|---|
| 1 | <!DOCTYPE html> | <!DOCTYPE html> |
|---|
| 2 | <html> | <html> |
|---|
| 3 | <head> | <head> |
|---|
| ⋮ | ⋮ | ⋮ |
|---|
| 40 | <!-- end icons / favicons --> | <!-- end icons / favicons --> |
|---|
| 41 | | |
|---|
| 42 | <link rel="alternate" type="application/rss+xml" title="tech.interfluidity.com updates" href="../../feed/index.rss"> | <link rel="alternate" type="application/rss+xml" title="tech.interfluidity.com updates" href="../../feed/index.rss"> |
|---|
| 43 | | <link rel="alternate" type="application/x-all-item-rss+xml" title="tech.interfluidity.com - all items" href="https://tech.interfluidity.com/all-item-feed/index.rss"> |
|---|
| 44 | <link rel="alternate" type="application/rss+xml" title="interfluidity - all blogs" href="https://www.interfluidity.com/unify-rss/all-blogs.rss"> | <link rel="alternate" type="application/rss+xml" title="interfluidity - all blogs" href="https://www.interfluidity.com/unify-rss/all-blogs.rss"> |
|---|
| 45 | <link rel="alternate" type="application/rss+xml" title="interfluidity - all blogs and microblogs" href="https://www.interfluidity.com/unify-rss/all-blogs-and-microblogs.rss"> | <link rel="alternate" type="application/rss+xml" title="interfluidity - all blogs and microblogs" href="https://www.interfluidity.com/unify-rss/all-blogs-and-microblogs.rss"> |
|---|
| 46 | <link rel="alternate" type="application/x-single-item-rss+xml" title="The 'iffy' XML namespace" href="index.rss"> | <link rel="alternate" type="application/x-single-item-rss+xml" title="The 'iffy' XML namespace" href="index.rss"> |
|---|
| ⋮ | ⋮ | ⋮ |
|---|
| 85 | <hr class="below-title"> | <hr class="below-title"> |
|---|
| 86 | </div> | </div> |
|---|
| 87 | <div class="update-prepend rss-description-exclude"> | <div class="update-prepend rss-description-exclude"> |
|---|
| 88 | <em> ➣ This post was meaningfully revised at 2024-11-15 @ 01:10 AM EST. The previous revision is <a href="index-oldcommit-5fcd99373d2d940a0c6e1468979be59e2d6bcced.html">here</a>, diff <a href="index-diff-5fcd99373d2d940a0c6e1468979be59e2d6bcced-to-current.html">here</a>. (See <a href="index.html#update-history">update history</a>.) <br> | <em> ➣ This post was meaningfully revised at 2024-12-22 @ 10:40 AM EST. The previous revision is <a href="index-oldcommit-c1c3071b0ac3127c2969b24e26d439510fdc8c96.html">here</a>, diff <a href="index-diff-c1c3071b0ac3127c2969b24e26d439510fdc8c96-to-current.html">here</a>. (See <a href="index.html#update-history">update history</a>.) <br> |
|---|
| 89 | ➣ This post is expected to evolve over time. You can subscribe to ongoing updates <a href="index-sprout.rss">here</a>. | ➣ This post is expected to evolve over time. You can subscribe to ongoing updates <a href="index-sprout.rss">here</a>. |
|---|
| 90 | <link rel="alternate" type="application/rss+xml" title="Update to The 'iffy' XML namespace" href="https://tech.interfluidity.com/xml/iffy/index-sprout.rss"></em> | <link rel="alternate" type="application/rss+xml" title="Update to The 'iffy' XML namespace" href="https://tech.interfluidity.com/xml/iffy/index-sprout.rss"></em> |
|---|
| 91 | <hr> | <hr> |
|---|
| ⋮ | ⋮ | ⋮ |
|---|
| 105 | <li><a href="#iffy-curation"><code>iffy:curation</code></a></li> | <li><a href="#iffy-curation"><code>iffy:curation</code></a></li> |
|---|
| 106 | <li><a href="#iffy-diff"><code>iffy:diff</code></a></li> | <li><a href="#iffy-diff"><code>iffy:diff</code></a></li> |
|---|
| 107 | <li><a href="#iffy-hint-announce"><code>iffy:hint-announce</code></a></li> | <li><a href="#iffy-hint-announce"><code>iffy:hint-announce</code></a></li> |
|---|
| 108 | | <li><a href="#iffy-in-reply-to"><code>iffy:in-reply-to</code></a></li> |
|---|
| 109 | <li><a href="#iffy-initial"><code>iffy:initial</code></a></li> | <li><a href="#iffy-initial"><code>iffy:initial</code></a></li> |
|---|
| 110 | | <li><a href="#iffy-item-ref"><code>iffy:item-ref</code></a></li> |
|---|
| 111 | <li><a href="#iffy-policy"><code>iffy:policy</code></a></li> | <li><a href="#iffy-policy"><code>iffy:policy</code></a></li> |
|---|
| 112 | <li><a href="#iffy-provenance"><code>iffy:provenance</code></a></li> | <li><a href="#iffy-provenance"><code>iffy:provenance</code></a></li> |
|---|
| 113 | <li><a href="#iffy-recent"><code>iffy:recent</code></a></li> | <li><a href="#iffy-recent"><code>iffy:recent</code></a></li> |
|---|
| ⋮ | ⋮ | ⋮ |
|---|
| 247 | </code></pre> | </code></pre> |
|---|
| 248 | </div> | </div> |
|---|
| 249 | <hr> | <hr> |
|---|
| 250 | | <h2><a href="#element--iffyin-reply-to-" id="element--iffyin-reply-to-" name="element--iffyin-reply-to-" class="anchorlink"></a>Element — <code>iffy:in-reply-to</code> <a id="iffy-in-reply-to" href=""></a></h2> |
|---|
| 251 | | <div class="iffy-element-desc"> |
|---|
| 252 | | <h3><a href="#when-a-subelement-of-item-1" id="when-a-subelement-of-item-1" name="when-a-subelement-of-item-1" class="anchorlink"></a>When a subelement of <code>item</code></h3> |
|---|
| 253 | | <p>Marks an item as a reply to some other <code>item</code>, which may be published anywhere. Contains one <a href="#iffy-item-ref"><code>iffy:item-ref</code></a>.</p> |
|---|
| 254 | | <h4><a href="#example-5" id="example-5" name="example-5" class="anchorlink"></a>Example:</h4> |
|---|
| 255 | | <pre><code class="language-xml"><iffy:in-reply-to> |
|---|
| 256 | | <iffy:item-ref href="https://tech.interfluidity.com/feed/index.rss" type="application/rss+xml" guid="https://tech.interfluidity.com/2024/11/12/supporting-single-item-rss/index.html" /> |
|---|
| 257 | | </iffy:in-reply-to> |
|---|
| 258 | | </code></pre> |
|---|
| 259 | | </div> |
|---|
| 260 | | <hr> |
|---|
| 261 | <h2><a href="#element--iffyinitial-" id="element--iffyinitial-" name="element--iffyinitial-" class="anchorlink"></a>Element — <code>iffy:initial</code> <a id="iffy-initial" href=""></a></h2> | <h2><a href="#element--iffyinitial-" id="element--iffyinitial-" name="element--iffyinitial-" class="anchorlink"></a>Element — <code>iffy:initial</code> <a id="iffy-initial" href=""></a></h2> |
|---|
| 262 | <div class="iffy-element-desc"> | <div class="iffy-element-desc"> |
|---|
| 263 | <p>In general, describes the initial state of the item referred to by the element that contains it.</p> | <p>In general, describes the initial state of the item referred to by the element that contains it.</p> |
|---|
| ⋮ | ⋮ | ⋮ |
|---|
| 273 | <h3><a href="#when-a-subelement-of-item--iffyupdate-history" id="when-a-subelement-of-item--iffyupdate-history" name="when-a-subelement-of-item--iffyupdate-history" class="anchorlink"></a>When a subelement of <code>item</code> > <a href="#iffy-update-history"><code>iffy:update-history</code></a></h3> | <h3><a href="#when-a-subelement-of-item--iffyupdate-history" id="when-a-subelement-of-item--iffyupdate-history" name="when-a-subelement-of-item--iffyupdate-history" class="anchorlink"></a>When a subelement of <code>item</code> > <a href="#iffy-update-history"><code>iffy:update-history</code></a></h3> |
|---|
| 274 | <p>An <code>iffy:initial</code> MAY BE included under <code>item</code> > <a href="#iffy-update-history"><code>iffy:update-history</code></a>, but is recommended ONLY IF the title, authorship, or link have changed.</p> | <p>An <code>iffy:initial</code> MAY BE included under <code>item</code> > <a href="#iffy-update-history"><code>iffy:update-history</code></a>, but is recommended ONLY IF the title, authorship, or link have changed.</p> |
|---|
| 275 | <p>Since <code>item</code> > <code>guid</code> and <code>item</code> > <code>pubDate</code> never change, generators SHOULD NOT include these items under <code>item</code> > <code>iffy:update-history</code>. They are available directly in the containing item.</p> | <p>Since <code>item</code> > <code>guid</code> and <code>item</code> > <code>pubDate</code> never change, generators SHOULD NOT include these items under <code>item</code> > <code>iffy:update-history</code>. They are available directly in the containing item.</p> |
|---|
| 276 | <h4><a href="#example-5" id="example-5" name="example-5" class="anchorlink"></a>Example:</h4> | <h4><a href="#example-6" id="example-6" name="example-6" class="anchorlink"></a>Example:</h4> |
|---|
| 277 | <pre><code class="language-xml"><iffy:initial> | <pre><code class="language-xml"><iffy:initial> |
|---|
| 278 | <!-- Perhaps more recent updates, and the current item, include more authors --> | <!-- Perhaps more recent updates, and the current item, include more authors --> |
|---|
| 279 | <dc:creator>First Author, Esq.</dc:creator> | <dc:creator>First Author, Esq.</dc:creator> |
|---|
| ⋮ | ⋮ | ⋮ |
|---|
| 289 | <li>If an <code>item</code> > <code>pubDate</code> is defined in the post that was updated, that MUST BE recorded as <code>atom:published</code></li> | <li>If an <code>item</code> > <code>pubDate</code> is defined in the post that was updated, that MUST BE recorded as <code>atom:published</code></li> |
|---|
| 290 | <li>If an <code>item</code> > <code>dc:creator</code> is defined in the post that was updated, that MUST BE recorded as <code>dc:creator</code> If, in the post that was updated, authorship was defined using <code>item</code> > <code>author</code> or <code>item</code> > <code>atom:author</code> those items should be converted into a form appropriate for <code>dc:creator</code> elements.</li> | <li>If an <code>item</code> > <code>dc:creator</code> is defined in the post that was updated, that MUST BE recorded as <code>dc:creator</code> If, in the post that was updated, authorship was defined using <code>item</code> > <code>author</code> or <code>item</code> > <code>atom:author</code> those items should be converted into a form appropriate for <code>dc:creator</code> elements.</li> |
|---|
| 291 | </ul> | </ul> |
|---|
| 292 | <h4><a href="#example-6" id="example-6" name="example-6" class="anchorlink"></a>Example:</h4> | <h4><a href="#example-7" id="example-7" name="example-7" class="anchorlink"></a>Example:</h4> |
|---|
| 293 | <pre><code class="language-xml"><item> | <pre><code class="language-xml"><item> |
|---|
| 294 | <pubDate>Thu, 20 Jun 2024 13:10:00 -0400</pubDate> | <pubDate>Thu, 20 Jun 2024 13:10:00 -0400</pubDate> |
|---|
| 295 | <guid isPermalink="true"> | <guid isPermalink="true"> |
|---|
| ⋮ | ⋮ | ⋮ |
|---|
| 327 | </ul> | </ul> |
|---|
| 328 | </div> | </div> |
|---|
| 329 | <hr> | <hr> |
|---|
| 330 | | <h2><a href="#element--iffyitem-ref-" id="element--iffyitem-ref-" name="element--iffyitem-ref-" class="anchorlink"></a>Element — <code>iffy:item-ref</code> <a id="iffy-item-ref" href=""></a></h2> |
|---|
| 331 | | <div class="iffy-element-desc"> |
|---|
| 332 | | <p>Represents a reference to an RSS <code>item</code> in RSS data available elsewhere.</p> |
|---|
| 333 | | <p><code>iffy:item-ref</code> SHOULD be an empty XML element, given meaning by its attributes.</p> |
|---|
| 334 | | <ul> |
|---|
| 335 | | <li> |
|---|
| 336 | | <p>An <code>iffy:item-ref</code> MUST contain an <code>href</code> attribute, which points to a source of RSS data or to an HTML document that refers to RSS data in an HTML <code>link</code> element.</p></li> |
|---|
| 337 | | <li> |
|---|
| 338 | | <p>An <code>iffy:item-ref</code> SHOULD contain a <code>type</code> attribute. The type should either be <code>text/html</code> or <code>application/*rss+xml</code> where the <code>*</code> may refer to the empty string (so just <code>application/rss+xml</code>) or a prefix, <a href="../../2024/11/12/supporting-single-item-rss/index.html">like</a> <code>application/x-single-item-rss+xml</code>. (If a type attribute is missing, a consumer MAY try to examine the contents at <code>href</code> and do the right thing.) (Mime types can, as always, include a parameter, like <code>text/html;charset=UTF-8</code>.)</p></li> |
|---|
| 339 | | <li> |
|---|
| 340 | | <p>An <code>iffy:item-ref</code> MUST contain a <code>guid</code> attribute UNLESS the <code>href</code> refers to <a href="../../2024/11/12/supporting-single-item-rss/index.html">single-item RSS</a>.</p></li> |
|---|
| 341 | | </ul> |
|---|
| 342 | | <p>To resolve an <code>iffy:item-ref</code> consumers should:</p> |
|---|
| 343 | | <ol> |
|---|
| 344 | | <li> |
|---|
| 345 | | <p>Check the <code>type</code> attribute, or if missing, check the contents referred to by the <code>href</code>, to see whether the referent is an HTML or an RSS document.</p></li> |
|---|
| 346 | | <li> |
|---|
| 347 | | <p>If the referent is an RSS document and the <code>iffy:item-ref</code> includes a <code>guid</code> attribute, the <code>item-ref</code> refers to the RSS <code>item</code> element containing a <code>guid</code> element whose contents matched the <code>iffy:item-ref</code>'s <code>guid</code> attribute.</p></li> |
|---|
| 348 | | <li> |
|---|
| 349 | | <p>If the referent is an RSS document and the <code>iffy:item-ref</code> does NOT include a <code>guid</code> attribute, then the <code>item-ref</code> refers to the single RSS item in the document. If there is more than one RSS <code>item</code>, the resolution fails.</p></li> |
|---|
| 350 | | <li> |
|---|
| 351 | | <p>If the referent is an HTML document and the <code>iffy:item-ref</code> contains a <code>guid</code> attribute, the consumer must gather all HTML <code>link</code> elements with <code>rel="alternative"</code> and <code>type="application/*rss+xml</code> where the <code>*</code> may refer to the empty string (so just <code>application/rss+xml</code>) or a prefix, <a href="../../2024/11/12/supporting-single-item-rss/index.html">like</a> <code>application/x-single-item-rss+xml</code>. The type may also contain a parameter, like <code>application/x-single-item-rss+xml;completeness=Content</code> The consumer tries <code>link</code> elements whose <code>type</code> attribute is an exact match to the <code>iffy:item-ref</code>'s <code>type</code> attribute first, in the order they appear in the HTML file, and then other <code>link</code> elements with <code>type="application/*rss+xml</code>, in the order they appear. For each <code>link</code> tried, if the linked RSS contains that an RSS <code>item</code> with the <code>item-ref</code>'s specified <code>guid</code>, then the <code>item-ref</code> refers to that <code>item</code> and the resolution process terminates immediately.</p></li> |
|---|
| 352 | | <li> |
|---|
| 353 | | <p>If the referent is an HTML document and the <code>iffy:item-ref</code> DOES NOT contain a <code>guid</code> attribute, the consumer must search for an HTML <code>link</code> element whose <code>rel="alternative"</code> and whose <code>type="application/x-single-item-rss+xml"</code>. If there are no or multiple <code>link</code> elements so specified, resoluton fails. If there is a unique <code><link rel="alternative" type="application/x-single-item-rss+xml" href="..."></code>, and its referent contains RSS data with a single <code>item</code> attribute, the <code>iffy:item-ref</code> successfully resolves to that attribute.</p></li> |
|---|
| 354 | | </ol> |
|---|
| 355 | | <h4><a href="#example-single-item-rss" id="example-single-item-rss" name="example-single-item-rss" class="anchorlink"></a>Example (single-item RSS):</h4> |
|---|
| 356 | | <pre><code class="language-xml"><iffy:item-ref href="https://tech.interfluidity.com/2024/11/12/supporting-single-item-rss/index.rss" type="application/x-single-item-rss+xml" /> |
|---|
| 357 | | </code></pre> |
|---|
| 358 | | <h4><a href="#example-rss-by-guid" id="example-rss-by-guid" name="example-rss-by-guid" class="anchorlink"></a>Example (RSS, by guid):</h4> |
|---|
| 359 | | <pre><code class="language-xml"><iffy:item-ref href="https://tech.interfluidity.com/feed/index.rss" type="application/rss+xml" guid="https://tech.interfluidity.com/2024/11/12/supporting-single-item-rss/index.html" /> |
|---|
| 360 | | </code></pre> |
|---|
| 361 | | <h4><a href="#example-html-search-for-single-item-rss" id="example-html-search-for-single-item-rss" name="example-html-search-for-single-item-rss" class="anchorlink"></a>Example (HTML, search for single-item RSS):</h4> |
|---|
| 362 | | <pre><code class="language-xml"><iffy:item-ref href="https://tech.interfluidity.com/2024/11/12/supporting-single-item-rss/index.html" type="text/html" /> |
|---|
| 363 | | </code></pre> |
|---|
| 364 | | <h4><a href="#example-html-search-all-feeds-for-guid" id="example-html-search-all-feeds-for-guid" name="example-html-search-all-feeds-for-guid" class="anchorlink"></a>Example (HTML, search all feeds for guid):</h4> |
|---|
| 365 | | <pre><code class="language-xml"><!-- here the item guid is also the permalink, that is the href. but that needn't always be the case! --> |
|---|
| 366 | | <iffy:item-ref href="https://tech.interfluidity.com/2024/11/12/supporting-single-item-rss/index.html" type="text/html" guid="https://tech.interfluidity.com/2024/11/12/supporting-single-item-rss/index.html" /> |
|---|
| 367 | | </code></pre> |
|---|
| 368 | | </div> |
|---|
| 369 | | <hr> |
|---|
| 370 | <h2><a href="#element--iffypolicy-" id="element--iffypolicy-" name="element--iffypolicy-" class="anchorlink"></a>Element — <code>iffy:policy</code> <a id="iffy-policy" href=""></a></h2> | <h2><a href="#element--iffypolicy-" id="element--iffypolicy-" name="element--iffypolicy-" class="anchorlink"></a>Element — <code>iffy:policy</code> <a id="iffy-policy" href=""></a></h2> |
|---|
| 371 | <div class="iffy-element-desc"> | <div class="iffy-element-desc"> |
|---|
| 372 | <p>In general, represents a statement of some kind of policy with respect to its containing element, suggested to feed consumers for handling a feed or item.</p> | <p>In general, represents a statement of some kind of policy with respect to its containing element, suggested to feed consumers for handling a feed or item.</p> |
|---|
| ⋮ | ⋮ | ⋮ |
|---|
| 448 | <li> | <li> |
|---|
| 449 | <p><code>operation</code> — Values must be one of <code>and</code> or <code>or</code>. Determines whether, if both <code>last</code> and <code>since</code> are set, items must be more recent than the <code>since</code> timestamp AND among the most recent <code>n</code> defined by <code>last</code>, or whether all items more recent than the <code>since</code> timestamp OR among the most recent <code>n</code> defined by <code>last</code> are included. If no <code>operation</code> is set, and both <code>last</code> and <code>since</code> are set, then <code>operation</code> should be presumed to default to <code>and</code>.</p></li> | <p><code>operation</code> — Values must be one of <code>and</code> or <code>or</code>. Determines whether, if both <code>last</code> and <code>since</code> are set, items must be more recent than the <code>since</code> timestamp AND among the most recent <code>n</code> defined by <code>last</code>, or whether all items more recent than the <code>since</code> timestamp OR among the most recent <code>n</code> defined by <code>last</code> are included. If no <code>operation</code> is set, and both <code>last</code> and <code>since</code> are set, then <code>operation</code> should be presumed to default to <code>and</code>.</p></li> |
|---|
| 450 | </ul> | </ul> |
|---|
| 451 | <h4><a href="#example-7" id="example-7" name="example-7" class="anchorlink"></a>Example:</h4> | <h4><a href="#example-8" id="example-8" name="example-8" class="anchorlink"></a>Example:</h4> |
|---|
| 452 | <pre><code class="language-xml"><?xml version='1.0' encoding='UTF-8'?> | <pre><code class="language-xml"><?xml version='1.0' encoding='UTF-8'?> |
|---|
| 453 | | |
|---|
| 454 | <rss version="2.0" xmlns:iffy="http://tech.interfluidity.com/xml/iffy/" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/"> | <rss version="2.0" xmlns:iffy="http://tech.interfluidity.com/xml/iffy/" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/"> |
|---|
| ⋮ | ⋮ | ⋮ |
|---|
| 483 | <p>Curation type <code>iffy:selection</code> signifies that this feed is the result of a potentially arbitrary query against or restriction of the full body of work.</p> | <p>Curation type <code>iffy:selection</code> signifies that this feed is the result of a potentially arbitrary query against or restriction of the full body of work.</p> |
|---|
| 484 | <p>An <code>iffy:selection</code> tag SHOULD contain subelements, documenting the query or restriction that produced this selection, ideally with sufficient information to reproduce the selection from a specified upstream source.</p> | <p>An <code>iffy:selection</code> tag SHOULD contain subelements, documenting the query or restriction that produced this selection, ideally with sufficient information to reproduce the selection from a specified upstream source.</p> |
|---|
| 485 | <p>However, no standard yet described how queries and restrictions might be document. For now, it is a playground for developer creativity...</p> | <p>However, no standard yet described how queries and restrictions might be document. For now, it is a playground for developer creativity...</p> |
|---|
| 486 | <h4><a href="#example-8" id="example-8" name="example-8" class="anchorlink"></a>Example:</h4> | <h4><a href="#example-9" id="example-9" name="example-9" class="anchorlink"></a>Example:</h4> |
|---|
| 487 | <pre><code class="language-xml"><?xml version='1.0' encoding='UTF-8'?> | <pre><code class="language-xml"><?xml version='1.0' encoding='UTF-8'?> |
|---|
| 488 | | |
|---|
| 489 | <rss version="2.0" xmlns:iffy="http://tech.interfluidity.com/xml/iffy/" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/"> | <rss version="2.0" xmlns:iffy="http://tech.interfluidity.com/xml/iffy/" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/"> |
|---|
| ⋮ | ⋮ | ⋮ |
|---|
| 514 | <p><code>iffy:single</code> is a <em>curation type</em>, a description of how the feed is curated relative to the body of work a subset of which it presents.</p> | <p><code>iffy:single</code> is a <em>curation type</em>, a description of how the feed is curated relative to the body of work a subset of which it presents.</p> |
|---|
| 515 | <p>Curation type <code>iffy:single</code> signifies that this is <a href="../../2024/11/12/supporting-single-item-rss/index.html">single-item RSS</a>.</p> | <p>Curation type <code>iffy:single</code> signifies that this is <a href="../../2024/11/12/supporting-single-item-rss/index.html">single-item RSS</a>.</p> |
|---|
| 516 | <p>The feed contains just one item, not by happenstance because there is only one recent item, nor because some <a href="#iffy-selection">selection</a> yielded just one item, but intentionally, so that metadata related to the item can have its own permanent RSS home.</p> | <p>The feed contains just one item, not by happenstance because there is only one recent item, nor because some <a href="#iffy-selection">selection</a> yielded just one item, but intentionally, so that metadata related to the item can have its own permanent RSS home.</p> |
|---|
| 517 | <h4><a href="#example-9" id="example-9" name="example-9" class="anchorlink"></a>Example:</h4> | <h4><a href="#example-10" id="example-10" name="example-10" class="anchorlink"></a>Example:</h4> |
|---|
| 518 | <pre><code class="language-xml"><?xml version='1.0' encoding='UTF-8'?> | <pre><code class="language-xml"><?xml version='1.0' encoding='UTF-8'?> |
|---|
| 519 | | |
|---|
| 520 | <rss version="2.0" xmlns:iffy="http://tech.interfluidity.com/xml/iffy/" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/"> | <rss version="2.0" xmlns:iffy="http://tech.interfluidity.com/xml/iffy/" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/"> |
|---|
| ⋮ | ⋮ | ⋮ |
|---|
| 545 | </ul> | </ul> |
|---|
| 546 | <h3><a href="#when-a-subelement-of-channel-and-iffytype-is-itemupdatefeed" id="when-a-subelement-of-channel-and-iffytype-is-itemupdatefeed" name="when-a-subelement-of-channel-and-iffytype-is-itemupdatefeed" class="anchorlink"></a>When a subelement of <code>channel</code> AND <a href="#iffy-type"><code>iffy:type</code></a> is <code>ItemUpdateFeed</code></h3> | <h3><a href="#when-a-subelement-of-channel-and-iffytype-is-itemupdatefeed" id="when-a-subelement-of-channel-and-iffytype-is-itemupdatefeed" name="when-a-subelement-of-channel-and-iffytype-is-itemupdatefeed" class="anchorlink"></a>When a subelement of <code>channel</code> AND <a href="#iffy-type"><code>iffy:type</code></a> is <code>ItemUpdateFeed</code></h3> |
|---|
| 547 | <p>SHOULD include an <a href="https://datatracker.ietf.org/doc/html/rfc4287#section-4.2.7"><code>atom:link</code></a> with <code>rel</code> attribute set to <code>related</code>, pointing to the same resource as the <code>link</code> element of the item whose updates are being announced.</p> | <p>SHOULD include an <a href="https://datatracker.ietf.org/doc/html/rfc4287#section-4.2.7"><code>atom:link</code></a> with <code>rel</code> attribute set to <code>related</code>, pointing to the same resource as the <code>link</code> element of the item whose updates are being announced.</p> |
|---|
| 548 | <h4><a href="#example-10" id="example-10" name="example-10" class="anchorlink"></a>Example:</h4> | <h4><a href="#example-11" id="example-11" name="example-11" class="anchorlink"></a>Example:</h4> |
|---|
| 549 | <pre><code class="language-xml"> <channel> | <pre><code class="language-xml"> <channel> |
|---|
| 550 | <!-- other channel elements --> | <!-- other channel elements --> |
|---|
| 551 | <iffy:synthetic> | <iffy:synthetic> |
|---|
| 552 | <iffy:type>ItemUpdateFeed</iffy:type> | <iffy:type>ItemUpdateFeed</iffy:type> |
|---|
| 553 | <atom:link rel="related" href="https://tech.interfluidity.com/xml/iffy/index.html"/> | <atom:link rel="related" href="https://tech.interfluidity.com/xml/iffy/index.html"/> |
|---|
| 554 | </iffy:synthetic> | </iffy:synthetic> |
|---|
| 555 | </channel> | </channel> |
|---|
| 556 | </code></pre> | </code></pre> |
|---|
| 557 | <h3><a href="#when-a-subelement-of-item-1" id="when-a-subelement-of-item-1" name="when-a-subelement-of-item-1" class="anchorlink"></a>When a subelement of <code>item</code></h3> | <h3><a href="#when-a-subelement-of-item-2" id="when-a-subelement-of-item-2" name="when-a-subelement-of-item-2" class="anchorlink"></a>When a subelement of <code>item</code></h3> |
|---|
| 558 | <p>The <code>iffy:synthetic</code> element of an <code>item</code> SHOULD contain — in some form of parsable XML — all the data from which the item content (as reflected in <code>item</code> > <code>content:encoded</code> or <code>item</code> > <code>atom:content</code>) has been generated.</p> | <p>The <code>iffy:synthetic</code> element of an <code>item</code> SHOULD contain — in some form of parsable XML — all the data from which the item content (as reflected in <code>item</code> > <code>content:encoded</code> or <code>item</code> > <code>atom:content</code>) has been generated.</p> |
|---|
| 559 | <p>Consumers may opt to ignore these content items, and use the data from <code>iffy:synthetic</code> for custom renderings or further processing.</p> | <p>Consumers may opt to ignore these content items, and use the data from <code>iffy:synthetic</code> for custom renderings or further processing.</p> |
|---|
| 560 | <p>Known types:</p> | <p>Known types:</p> |
|---|
| ⋮ | ⋮ | ⋮ |
|---|
| 564 | </ul> | </ul> |
|---|
| 565 | <h3><a href="#when-a-subelement-of-item-and-iffytype-is-updateannouncement" id="when-a-subelement-of-item-and-iffytype-is-updateannouncement" name="when-a-subelement-of-item-and-iffytype-is-updateannouncement" class="anchorlink"></a>When a subelement of <code>item</code> AND <a href="#iffy-type"><code>iffy:type</code></a> is <code>UpdateAnnouncement</code></h3> | <h3><a href="#when-a-subelement-of-item-and-iffytype-is-updateannouncement" id="when-a-subelement-of-item-and-iffytype-is-updateannouncement" name="when-a-subelement-of-item-and-iffytype-is-updateannouncement" class="anchorlink"></a>When a subelement of <code>item</code> AND <a href="#iffy-type"><code>iffy:type</code></a> is <code>UpdateAnnouncement</code></h3> |
|---|
| 566 | <p>In addition to <code>iffy:type</code>, MUST contain an <a href="#iffy-update"><code>iffy:update</code></a> element, which in turn MUST contain an <a href="#iffy-initial"><code>iffy:initial</code></a> element describing the initial state of the updated post.</p> | <p>In addition to <code>iffy:type</code>, MUST contain an <a href="#iffy-update"><code>iffy:update</code></a> element, which in turn MUST contain an <a href="#iffy-initial"><code>iffy:initial</code></a> element describing the initial state of the updated post.</p> |
|---|
| 567 | <h4><a href="#example-11" id="example-11" name="example-11" class="anchorlink"></a>Example:</h4> | <h4><a href="#example-12" id="example-12" name="example-12" class="anchorlink"></a>Example:</h4> |
|---|
| 568 | <pre><code class="language-xml"><item> | <pre><code class="language-xml"><item> |
|---|
| 569 | <pubDate>Thu, 20 Jun 2024 13:10:00 -0400</pubDate> | <pubDate>Thu, 20 Jun 2024 13:10:00 -0400</pubDate> |
|---|
| 570 | <guid isPermalink="true"> | <guid isPermalink="true"> |
|---|
| ⋮ | ⋮ | ⋮ |
|---|
| 732 | <div class="entry-footer"> | <div class="entry-footer"> |
|---|
| 733 | <div class="post-metainfo"> | <div class="post-metainfo"> |
|---|
| 734 | <div class="updated-note"> | <div class="updated-note"> |
|---|
| 735 | <a href="index.html#major-updates">Last major update at 2024-11-15 @ 01:10 AM EST</a> | <a href="index.html#major-updates">Last major update at 2024-12-22 @ 10:40 AM EST</a> |
|---|
| 736 | </div> | </div> |
|---|
| 737 | <div> | <div> |
|---|
| 738 | <a href="index.html" class="pubtime">04:10 AM EDT</a> | <a href="index.html" class="pubtime">04:10 AM EDT</a> |
|---|
| ⋮ | ⋮ | ⋮ |
|---|
| 755 | <div id="update-history" class="update-history"> | <div id="update-history" class="update-history"> |
|---|
| 756 | <h3 class="update-history-title"><a id="major-updates" href=""></a>Major revisions:</h3> | <h3 class="update-history-title"><a id="major-updates" href=""></a>Major revisions:</h3> |
|---|
| 757 | <ul> | <ul> |
|---|
| 758 | <li><span class="update-timestamp"><i>2024-11-15 @ 01:10 AM EST</i></span> — Document <code>iffy:curation</code>, and curation type elements <code>iffy:all</code>, <code>iffy:recent</code>, <code>iffy:selection</code>, <code>iffy:single</code>. (<a href="index-diff-5fcd99373d2d940a0c6e1468979be59e2d6bcced-to-current.html">diff</a>)</li> | <li><span class="update-timestamp"><i>2024-12-22 @ 10:40 AM EST</i></span> — Document <code>iffy:item-ref</code> and <code>iffy:in-reply-to</code>. (<a href="index-diff-c1c3071b0ac3127c2969b24e26d439510fdc8c96-to-current.html">diff</a>)</li> |
|---|
| 759 | | <li><span class="update-timestamp"><i> <a href="index-oldcommit-c1c3071b0ac3127c2969b24e26d439510fdc8c96.html">2024-11-15 @ 01:10 AM EST</a></i></span> — Document <code>iffy:curation</code>, and curation type elements <code>iffy:all</code>, <code>iffy:recent</code>, <code>iffy:selection</code>, <code>iffy:single</code>. (<a href="index-diff-5fcd99373d2d940a0c6e1468979be59e2d6bcced-to-c1c3071b0ac3127c2969b24e26d439510fdc8c96.html">diff</a>)</li> |
|---|
| 760 | <li><span class="update-timestamp"><i> <a href="index-oldcommit-5fcd99373d2d940a0c6e1468979be59e2d6bcced.html">2024-11-02 @ 05:15 PM EDT</a></i></span> — Clarifications of iffy:provenance and iffy:update-history. (<a href="index-diff-34d8dab8f187c6d9512615dbb83c95395aa49a3b-to-5fcd99373d2d940a0c6e1468979be59e2d6bcced.html">diff</a>)</li> | <li><span class="update-timestamp"><i> <a href="index-oldcommit-5fcd99373d2d940a0c6e1468979be59e2d6bcced.html">2024-11-02 @ 05:15 PM EDT</a></i></span> — Clarifications of iffy:provenance and iffy:update-history. (<a href="index-diff-34d8dab8f187c6d9512615dbb83c95395aa49a3b-to-5fcd99373d2d940a0c6e1468979be59e2d6bcced.html">diff</a>)</li> |
|---|
| 761 | <li><span class="update-timestamp"><i> <a href="index-oldcommit-34d8dab8f187c6d9512615dbb83c95395aa49a3b.html">2024-07-01 @ 02:40 PM EDT</a></i></span> — Major revision of <code>iffy:synthetic</code>, generalize <code>iffy:initial</code>, <code>iffy:update</code>, <code>iffy:update-history</code>, define <code>iffy:uid</code>. (<a href="index-diff-0df7787c056ab2b983e2de4d107c2fa477b7c8f4-to-34d8dab8f187c6d9512615dbb83c95395aa49a3b.html">diff</a>)</li> | <li><span class="update-timestamp"><i> <a href="index-oldcommit-34d8dab8f187c6d9512615dbb83c95395aa49a3b.html">2024-07-01 @ 02:40 PM EDT</a></i></span> — Major revision of <code>iffy:synthetic</code>, generalize <code>iffy:initial</code>, <code>iffy:update</code>, <code>iffy:update-history</code>, define <code>iffy:uid</code>. (<a href="index-diff-0df7787c056ab2b983e2de4d107c2fa477b7c8f4-to-34d8dab8f187c6d9512615dbb83c95395aa49a3b.html">diff</a>)</li> |
|---|
| 762 | <li><span class="update-timestamp"><i> <a href="index-oldcommit-0df7787c056ab2b983e2de4d107c2fa477b7c8f4.html">2024-06-20 @ 11:05 AM EDT</a></i></span> — Document <code>iffy:type</code>, update documentation of <code>iffy:synthetic</code> as optionally including <code>iffy:type</code>. (<a href="index-diff-f19e4870e2c719f71d2f5024cb3e2e8f477622dc-to-0df7787c056ab2b983e2de4d107c2fa477b7c8f4.html">diff</a>)</li> | <li><span class="update-timestamp"><i> <a href="index-oldcommit-0df7787c056ab2b983e2de4d107c2fa477b7c8f4.html">2024-06-20 @ 11:05 AM EDT</a></i></span> — Document <code>iffy:type</code>, update documentation of <code>iffy:synthetic</code> as optionally including <code>iffy:type</code>. (<a href="index-diff-f19e4870e2c719f71d2f5024cb3e2e8f477622dc-to-0df7787c056ab2b983e2de4d107c2fa477b7c8f4.html">diff</a>)</li> |
|---|
| ⋮ | ⋮ | ⋮ |
|---|
| 769 | <li><span class="update-timestamp"><i> <a href="index-oldcommit-394986cb8d9c57f567d324e691a44d50102101ce.html">2024-05-13 @ 04:10 AM EDT</a></i></span> — Initial publication.</li> | <li><span class="update-timestamp"><i> <a href="index-oldcommit-394986cb8d9c57f567d324e691a44d50102101ce.html">2024-05-13 @ 04:10 AM EDT</a></i></span> — Initial publication.</li> |
|---|
| 770 | </ul> | </ul> |
|---|
| 771 | <div class="update-history-note"> | <div class="update-history-note"> |
|---|
| 772 | Timestamps represent "major", substantative revisions. There may have been subsequent typo fixes and language reworkings within a major revision, after the time displayed. For a more complete and fine-grained update history, you can view the <a href="https://github.com/swaldman/tech.interfluidity.com/commits/main/">git repository commit history</a>. The most recent minor modification of this entry occurred 2024-11-15 @ 01:09 AM EST. | Timestamps represent "major", substantative revisions. There may have been subsequent typo fixes and language reworkings within a major revision, after the time displayed. For a more complete and fine-grained update history, you can view the <a href="https://github.com/swaldman/tech.interfluidity.com/commits/main/">git repository commit history</a>. The most recent minor modification of this entry occurred 2025-01-05 @ 11:03 PM EST. |
|---|
| 773 | </div> | </div> |
|---|
| 774 | </div> | </div> |
|---|
| 775 | </div><!-- after-article --> | </div><!-- after-article --> |
|---|
| ⋮ | ⋮ | ⋮ |
|---|
| 779 | </div> | </div> |
|---|
| 780 | </body> | </body> |
|---|
| 781 | </html> | </html> |
|---|