forked from eea/eea.sparql
/
README.txt
131 lines (82 loc) · 3.04 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
EEA Sparql
==========
EEA Sparql is a plone product for fetching data from Linked open data servers
(sparql endpoints).
Contents
========
.. contents::
Introduction
============
It is simple to use, you only have to specify the sparql endpoint url and the
sparql query.
The results will be converted in an exhibit json, what can easily be reused
(ex. by eea.daviz).
Main features
=============
The main features are:
1. create sparql queries
2. create sparql bookmark folders, sparql queries are created automatically,
and can be synchronized manually or automatically (with a cronjob).
If a query is changed, a new version of the object is created,
so older ones are not lost.
3. results are downloadable in various formats:
JSON, Exhibit JSON, HTML, XML, XML with Schema, CSV, TSV
Installation
============
To install eea.sparql into the global Python environment (or a workingenv),
using a traditional Zope 2 instance, you can do this:
* When you're reading this you have probably already run
``easy_install eea.sparql``. Find out how to install setuptools
(and EasyInstall) here:
http://peak.telecommunity.com/DevCenter/EasyInstall
* If you are using Zope 2.9 (not 2.10), get `pythonproducts`_ and install it
via::
python setup.py install --home /path/to/instance
into your Zope instance.
* Create a file called ``eea.sparql-configure.zcml`` in the
``/path/to/instance/etc/package-includes`` directory. The file
should only contain this::
<include package="eea.sparql" />
.. _pythonproducts: http://plone.org/products/pythonproducts
Alternatively, if you are using zc.buildout and the plone.recipe.zope2instance
recipe to manage your project, you can do this:
* Add ``eea.sparql`` to the list of eggs to install, e.g.::
[buildout]
eggs = eea.sparql
* Tell the plone.recipe.zope2instance recipe to install a ZCML slug::
[instance]
recipe = plone.recipe.zope2instance
zcml = eea.sparql
* Re-run buildout, e.g. with::
$ ./bin/buildout
You can skip the ZCML slug if you are going to explicitly include the package
from another package's configure.zcml file.
Dependecies
===========
1. Plone 4.x
2. Products.ZSPARQLMethod
3. eea.cache
4. eea.versions
Source code
===========
Latest source code (Plone 4 compatible):
https://svn.eionet.europa.eu/repositories/Zope/trunk/eea.sparql/trunk
Copyright and license
=====================
The Initial Owner of the Original Code is European Environment Agency (EEA).
All Rights Reserved.
The EEA Sparql (the Original Code) is free software;
you can redistribute it and/or modify it under the terms of the GNU
General Public License as published by the Free Software Foundation;
either version 2 of the License, or (at your option) any later
version.
More details under docs/License.txt
Links
=====
1. http://en.wikipedia.org/wiki/SPARQL
2. http://sparql.org/
3. http://www.w3.org/TR/rdf-sparql-query/
Funding
=======
EEA_ - European Enviroment Agency (EU)
.. _EEA: http://www.eea.europa.eu/