FOIwiki:ScraperSync: Difference between revisions

From FOIwiki
Jump to navigationJump to search
(Created page with "'''ScraperSync''' is a tool for maintaining an FOIwiki page as a mirror of a dataset from [http://www.scraperwiki.com/ ScraperWiki]. It attempts to preserve markup and changes i...")
 
(Replaced content with "'''ScraperSync''' no longer works since ScraperWiki ceased being useful.")
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
'''ScraperSync''' is a tool for maintaining an FOIwiki page as a mirror of a dataset from [http://www.scraperwiki.com/ ScraperWiki].  It attempts to preserve markup and changes in the page while propagating changes from the dataset.
'''ScraperSync''' no longer works since ScraperWiki ceased being useful.
 
==Dataset requirements==
 
The dataset must have a table called "swdata" containing a column called "name".  The contents of this column form the texts of entries in a bulletted list in the wiki page.
 
==List requirements==
 
The start of the maintained list is marked by a special comment like this:
 
<pre><nowiki><!-- ScraperSync start { "scraper": "thing" } --></nowiki></pre>
 
After the word "start" is a JSON object which configures ScraperSync.  It contains a single entry, "scraper", which names the scraper from which the data should be pulled.
 
ScraperSync understands several different list formats, and tries to remove markup and notes to work out what public authority is named by the item.
 
==Output==
 
ScraperSync's main output is a new version of the page source.  This should be the same as the current page, but with any list entries that don't appear in the ScraperWiki dataset struck out.  It also appends to this a list of those items that appeared in the source dataset but not in the wiki page.  ScraperSync tries to automatically make this into links to [[WhatDoTheyKnow]].
 
==Creating a new page==
 
ScraperSync has a mode for creating an entirely new page from a dataset.  This can be most easily activated by [http://scraperwikiviews.com/run/foiwiki_scrapersync/ running it with no options] and choosing "Create new" and entering the URL name of the Scraper to use as the source.

Latest revision as of 01:42, 7 April 2014

ScraperSync no longer works since ScraperWiki ceased being useful.