https://wiki.creativecommons.org/index.php?title=MediaWiki_Feed_Type&feed=atom&action=historyMediaWiki Feed Type - Revision history2024-03-29T15:35:27ZRevision history for this page on the wikiMediaWiki 1.30.0https://wiki.creativecommons.org/index.php?title=MediaWiki_Feed_Type&diff=43055&oldid=prevPaulproteus: /* Further work */2010-10-14T14:56:18Z<p><span dir="auto"><span class="autocomment">Further work</span></span></p>
<table class="diff diff-contentalign-left" data-mw="interface">
<col class="diff-marker" />
<col class="diff-content" />
<col class="diff-marker" />
<col class="diff-content" />
<tr style="vertical-align: top;" lang="en">
<td colspan="2" style="background-color: white; color:black; text-align: center;">← Older revision</td>
<td colspan="2" style="background-color: white; color:black; text-align: center;">Revision as of 14:56, 14 October 2010</td>
</tr><tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l41" >Line 41:</td>
<td colspan="2" class="diff-lineno">Line 41:</td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>Things that would be nice, but that the world will probably never see:</div></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>Things that would be nice, but that the world will probably never see:</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"></td></tr>
<tr><td class='diff-marker'>−</td><td style="color:black; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>* It would be nice if MediaWiki had a <link rel="api"> or similar that unambiguously pointed <del class="diffchange diffchange-inline">automated agents </del>to the API.</div></td><td class='diff-marker'>+</td><td style="color:black; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div>* It would be nice if MediaWiki had a <link rel="api"> or similar that unambiguously pointed to the API.</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>* It would be interesting if MediaWiki just created an RSS feed, in "MIT OCW format", for each category.</div></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>* It would be interesting if MediaWiki just created an RSS feed, in "MIT OCW format", for each category.</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>* We extract ''extremely'' little metadata right now from the pages: just the title. It would be nice if there were a reasonable way to store and extract metadata. A decision by us could make a big difference.</div></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>* We extract ''extremely'' little metadata right now from the pages: just the title. It would be nice if there were a reasonable way to store and extract metadata. A decision by us could make a big difference.</div></td></tr>
</table>Paulproteushttps://wiki.creativecommons.org/index.php?title=MediaWiki_Feed_Type&diff=43054&oldid=prevPaulproteus: /* Guide for DiscoverEd sysadmins */2010-10-14T14:51:30Z<p><span dir="auto"><span class="autocomment">Guide for DiscoverEd sysadmins</span></span></p>
<table class="diff diff-contentalign-left" data-mw="interface">
<col class="diff-marker" />
<col class="diff-content" />
<col class="diff-marker" />
<col class="diff-content" />
<tr style="vertical-align: top;" lang="en">
<td colspan="2" style="background-color: white; color:black; text-align: center;">← Older revision</td>
<td colspan="2" style="background-color: white; color:black; text-align: center;">Revision as of 14:51, 14 October 2010</td>
</tr><tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l23" >Line 23:</td>
<td colspan="2" class="diff-lineno">Line 23:</td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>== Guide for DiscoverEd sysadmins ==</div></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>== Guide for DiscoverEd sysadmins ==</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"></td></tr>
<tr><td class='diff-marker'>−</td><td style="color:black; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>* There is a new feed type: ''mediawiki-category''. If you add a feed with that type, set the URL of the feed to the MediaWiki category.</div></td><td class='diff-marker'>+</td><td style="color:black; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div>* There is a new feed type: ''mediawiki-category''. If you add a feed with that type, set the URL of the feed to the MediaWiki category. <ins class="diffchange diffchange-inline">For example:</ins></div></td></tr>
<tr><td class='diff-marker'>−</td><td style="color:black; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>* The provenance of a Resource we find in the category is the category URL.</div></td><td class='diff-marker'>+</td><td style="color:black; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins class="diffchange diffchange-inline">** to slurp in resources from Category:DiscoverEd on this wiki, where the wiki is curated by http://creativecommons.org/, enter this:</ins></div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color:black; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins class="diffchange diffchange-inline">** bin/feeds addfeed mediawiki-category http://wiki.creativecommons.org/Category:DiscoverEd http://creativecommons.org/</ins></div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color:black; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div>* The provenance of a Resource we find in the category is the <ins class="diffchange diffchange-inline">full </ins>category URL.</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>* The code has extensive logging of its exceptions, so if you find you are missing data you thought you would have. do read the log.</div></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>* The code has extensive logging of its exceptions, so if you find you are missing data you thought you would have. do read the log.</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"></td></tr>
</table>Paulproteushttps://wiki.creativecommons.org/index.php?title=MediaWiki_Feed_Type&diff=43053&oldid=prevPaulproteus: Created page with "{{DiscoverEd Specification |contact=Asheesh Laroia |project=AgShare |status=Complete }} Publishers who store and edit text in MediaWiki may want a particular ''category'' from th..."2010-10-14T14:47:41Z<p>Created page with "{{DiscoverEd Specification |contact=Asheesh Laroia |project=AgShare |status=Complete }} Publishers who store and edit text in MediaWiki may want a particular ''category'' from th..."</p>
<p><b>New page</b></p><div>{{DiscoverEd Specification<br />
|contact=Asheesh Laroia<br />
|project=AgShare<br />
|status=Complete<br />
}}<br />
Publishers who store and edit text in MediaWiki may want a particular ''category'' from their wiki aggregated into a DiscoverEd instance. This specification describes:<br />
<br />
* How publishers can set up their wikis to be aggregated by DiscoverEd<br />
* How DiscoverEd instance maintainers can aggregate content from such a wiki<br />
* The changes that we made to DiscoverEd to support this.<br />
<br />
It's pretty easy, all around. Relax, and read on.<br />
<br />
== Guide for publishers ==<br />
<br />
DiscoverEd can pull content from a category in your wiki. Our code relies on the following:<br />
<br />
* The MediaWiki API enabled, at least the read-only portion. (This is the default. [http://www.mediawiki.org/wiki/API:Restricting_API_usage More info here].)<br />
* A <link rel="search"> tag pointing to the OpenSearch API on your wiki. This is also enabled by default, but if you customize the theme, you might accidentally remove this tag. We need it there.<br />
<br />
We detect the MediaWiki API path by looking at a page on your wiki and then determining the URL to the API by looking for another MediaWiki PHP file link. Right now, we rely on the <link rel="search"> for that detection. So if you remove the OpenSearch header, we can't find the API URL.<br />
<br />
== Guide for DiscoverEd sysadmins ==<br />
<br />
* There is a new feed type: ''mediawiki-category''. If you add a feed with that type, set the URL of the feed to the MediaWiki category.<br />
* The provenance of a Resource we find in the category is the category URL.<br />
* The code has extensive logging of its exceptions, so if you find you are missing data you thought you would have. do read the log.<br />
<br />
== DiscoverEd code changes ==<br />
<br />
The changes from [http://gitorious.org/discovered/repo/commit/a60ed73cc793f74f9cdafd853cdec208eda77a78 a60ed73cc793f74f9cdafd853cdec208eda77a78] to [http://gitorious.org/discovered/repo/commit/7500f599a9e5667db7644984dfb1d8d549a48597 7500f59] represent the initial implementation. A summary of the implementation details:<br />
<br />
* Factored out the RSS feed aggregation into a separate class<br />
* Created a new valid feed type, ''mediawiki-category''<br />
* Created a MediaWikiCategory class which can, starting from a category page, find the API URL, query it for all the pages in that category, and create a Resource representing each such page.<br />
<br />
== Further work ==<br />
<br />
Things that would be nice, but that the world will probably never see:<br />
<br />
* It would be nice if MediaWiki had a <link rel="api"> or similar that unambiguously pointed automated agents to the API.<br />
* It would be interesting if MediaWiki just created an RSS feed, in "MIT OCW format", for each category.<br />
* We extract ''extremely'' little metadata right now from the pages: just the title. It would be nice if there were a reasonable way to store and extract metadata. A decision by us could make a big difference.</div>Paulproteus