2 |
3 | # TabLinker v0.2
4 | **Authors**: [Rinke Hoekstra](http://github.com/RinkeHoekstra), [Laurens Rietveld](http://github.com/LaurensRietveld), [Albert Meroño-Peñuela](http://github.com/albertmeronyo)
5 |
6 | **Copyright**: VU University Amsterdam
7 |
8 | **License**: [LGPL v3.0](http://www.gnu.org/licenses/lgpl.html)
9 |
10 | ## About TabLinker
11 |
12 | TabLinker is experimental software for converting manually annotated Microsoft Excel workbooks to the [RDF Data Cube vocabulary](http://publishing-statistical-data.googlecode.com/svn/trunk/specs/src/main/html/cube.html). It is used in the context of the [Data2Semantics](http://www.data2semantics.org) project to investigate the use of Linked Data for humanities research ([Dutch census data](http://www.volkstellingen.nl) produced by [DANS](http://dans.knaw.nl)).
13 |
14 | TabLinker was designed for converting Excel or CSV files to RDF (triplification, RDF-izing) that have a complex layout and cannot be handled by fully automatic csv2rdf scripts.
15 |
16 | A presentation about Linked Census Data, including TabLinker is [available from SlideShare](http://www.slideshare.net/rinkehoekstra/linked-census-data).
17 |
18 | ## Using TabLinker
19 |
20 | TabLinker takes annotated Excel files (found using the `srcMask` option in the [config.ini](http://github.com/Data2Semantics/TabLinker/tree/master/config.ini) file) and converts them to RDF. This RDF is serialized to the target folder specified using the `targetFolder` option in [config.ini](http://github.com/Data2Semantics/TabLinker/tree/master/config.ini).
21 |
22 | Annotations in the Excel file should be done using the built-in **style** functionality of Excel (you can specify these by hand). TabLinker currently recognises seven styles:
23 |
24 | * **TL Title** - The cell containing the title of a sheet
25 | * **TL Data** - A cell that contains data, e.g. a number for the population size
26 | * **TL ColHeader** - Used for the headers of columns
27 | * **TL RowHeader** - Used for row headers
28 | * **TL HRowHeader** - Hierarchical header, used for multi-column row headers with subsumption/taxonomic relations between the values of the columns
29 | * **TL RowProperty** - Typically used for the header cells directly above RowHeader or HierarchicalRowHeader cells. Cell values are the properties that relate Data cells to RowHeader and HierarchicalRowHeader cells.
30 | * **TL RowLabel** - Used for cells that contain a label for one of the HierarchicalRowHeader cells in the same row.
31 |
32 | An eight style, **TL Metadata**, is currently ignored (See #3).
33 |
34 | An [example of such an annotated Excel file](http://github.com/Data2Semantics/TabLinker/tree/master/input/BRT_1889_02_T1_marked.xls) is provided in the [input](http://github.com/Data2Semantics/TabLinker/tree/master/input/) directory. There are ways to import the styles defined in that file into your own Excel files.
35 |
36 | **Tip:** If your table contains totals for HierarchicalRowHeader cell values, use a non-TabLink style to mark the cells between the level to which the total belongs, and the cell that contains the name of the total. Have a look at the example [annotated Excel file](http://github.com/Data2Semantics/TabLinker/tree/master/input/BRT_1889_02_T1_marked.xls) to see how this is done (up to row 428).
37 |
38 | Once you're all set, start the TabLinker by cd-ing to the [src](http://github.com/Data2Semantics/TabLinker/tree/master/src/) folder, and running:
39 |
40 | ```python tablinker.py```
41 |
42 | ## Configuration file
43 |
44 | Editing the config.ini file can help you to get a more customized RDF output. Options are:
45 |
46 | ### general
47 | * **format** is the desired RDF serialization format ('n3' by default).
48 |
49 | ### paths
50 | * **srcMask** is a mask matching the input XLS files. It works as a directory specifier, as well as wildcard specifier to filter only desired files.
51 | * **targetFolder** is the target directory where you want the RDF files to be written to.
52 |
53 | ### debug
54 | * **verbose** with value 1 (default) enables verbose mode (0 disables it).
55 |
56 | ### dataCell
57 | * **literalType** is a URI specifying the datatype for the data cells in the spreadsheet (e.g. [http://www.w3.org/2001/XMLSchema#int])
58 | * **propertyName** is the name of data cell property. Leave blank to use default 'hasValue'.
59 | * **labels** are language literals to be added for that property name (if needed).
60 |
61 | ### annotations
62 | * **enabled** with value 1 (default) generates an additional graph with the annotations (Excel comments) contained in the XLS files (if any) (0 disables it).
63 | * **model** specifies the data model ('oa' by default) for generating the annotations graph.
64 |
65 | ## Requirements
66 |
67 | TabLinker was developed under the following environment:
68 |
69 | * Python 2.7
70 | * The xlutils and xlrd packages from ',trigger:"hover focus",title:"",delay:0,html:!1,container:!1},b.prototype.init=function(b,c,d){this.enabled=!0,this.type=b,this.$element=a(c),this.options=this.getOptions(d);for(var e=this.options.trigger.split(" "),f=e.length;f--;){var g=e[f];if("click"==g)this.$element.on("click."+this.type,this.options.selector,a.proxy(this.toggle,this));else if("manual"!=g){var h="hover"==g?"mouseenter":"focus",i="hover"==g?"mouseleave":"blur";this.$element.on(h+"."+this.type,this.options.selector,a.proxy(this.enter,this)),this.$element.on(i+"."+this.type,this.options.selector,a.proxy(this.leave,this))}}this.options.selector?this._options=a.extend({},this.options,{trigger:"manual",selector:""}):this.fixTitle()},b.prototype.getDefaults=function(){return b.DEFAULTS},b.prototype.getOptions=function(b){return b=a.extend({},this.getDefaults(),this.$element.data(),b),b.delay&&"number"==typeof b.delay&&(b.delay={show:b.delay,hide:b.delay}),b},b.prototype.getDelegateOptions=function(){var b={},c=this.getDefaults();return this._options&&a.each(this._options,function(a,d){c[a]!=d&&(b[a]=d)}),b},b.prototype.enter=function(b){var c=b instanceof this.constructor?b:a(b.currentTarget)[this.type](this.getDelegateOptions()).data("bs."+this.type);return clearTimeout(c.timeout),c.hoverState="in",c.options.delay&&c.options.delay.show?(c.timeout=setTimeout(function(){"in"==c.hoverState&&c.show()},c.options.delay.show),void 0):c.show()},b.prototype.leave=function(b){var c=b instanceof this.constructor?b:a(b.currentTarget)[this.type](this.getDelegateOptions()).data("bs."+this.type);return clearTimeout(c.timeout),c.hoverState="out",c.options.delay&&c.options.delay.hide?(c.timeout=setTimeout(function(){"out"==c.hoverState&&c.hide()},c.options.delay.hide),void 0):c.hide()},b.prototype.show=function(){var b=a.Event("show.bs."+this.type);if(this.hasContent()&&this.enabled){if(this.$element.trigger(b),b.isDefaultPrevented())return;var c=this.tip();this.setContent(),this.options.animation&&c.addClass("fade");var d="function"==typeof this.options.placement?this.options.placement.call(this,c[0],this.$element[0]):this.options.placement,e=/\s?auto?\s?/i,f=e.test(d);f&&(d=d.replace(e,"")||"top"),c.detach().css({top:0,left:0,display:"block"}).addClass(d),this.options.container?c.appendTo(this.options.container):c.insertAfter(this.$element);var g=this.getPosition(),h=c[0].offsetWidth,i=c[0].offsetHeight;if(f){var j=this.$element.parent(),k=d,l=document.documentElement.scrollTop||document.body.scrollTop,m="body"==this.options.container?window.innerWidth:j.outerWidth(),n="body"==this.options.container?window.innerHeight:j.outerHeight(),o="body"==this.options.container?0:j.offset().left;d="bottom"==d&&g.top+g.height+i-l>n?"top":"top"==d&&g.top-l-i<0?"bottom":"right"==d&&g.right+h>m?"left":"left"==d&&g.left-h
46 |
47 |
99 |
100 |
101 |
102 |
103 |
104 |
105 |
106 |
107 |
--------------------------------------------------------------------------------
48 |
49 | 
50 |
52 | 53 | %if state == 'start': 54 | 62 | 63 |
64 |
65 |
66 |
73 |
74 |
81 |
82 | %elif state == 'uploaded':
83 |
87 |
88 | %else:
89 |
94 | %end
95 |
96 |
97 |
98 |
50 | Supervised Excel/CSV to RDF Converter http://www.data2semantics.org
51 |52 | 53 | %if state == 'start': 54 | 62 | 63 |
| Input files |
| {{file}} | 70 |
| Output files |
| {{file}} | 78 |