Skip to content
This repository
Newer
Older
100644 129 lines (88 sloc) 5.158 kb
0b992d92 »
2014-04-05 tweak
1 ## Seki is middleware/a front-end to an independent SPARQL server using node.js
85883821 »
2011-09-07 readme fleshed out
2
d67a9e28 »
2013-10-13 bits
3 No really, what is it?
4
f21aff8a »
2013-10-15 user registrqation form basically working (no validation etcyet)
5 It operates as a Web server, building queries from HTTP requests (from a browser
6 or another service) and passing them to the SPARQL server, formatting the
7 results (to HTML, JSON...) and passing them back to the client.
d67a9e28 »
2013-10-13 bits
8
6ff76831 »
2013-11-09 tweaks
9 **Warning** - so far Seki is very experimental/incomplete, don't expect anything to work out of the box. (It is under active development, so watch this space and/or [@danja on Twitter](https://twitter.com/danja).
aca809ec »
2013-11-09 tweaks
10
f21aff8a »
2013-10-15 user registrqation form basically working (no validation etcyet)
11 ### Uses
d67a9e28 »
2013-10-13 bits
12
f21aff8a »
2013-10-15 user registrqation form basically working (no validation etcyet)
13 Primarily I'm developing Seki as a testbed to see what can be achieved using Web tech.
d67a9e28 »
2013-10-13 bits
14
f21aff8a »
2013-10-15 user registrqation form basically working (no validation etcyet)
15 Generally speaking Seki could be used for pretty much any Web system that might
16 otherwise use a HTTP server and database. Because an RDF/SPARQL server/DB is
17 used for the backend, Seki is very webby at its core, meaning server-server
18 communications (e.g. addressing remote Linked Data) will be simplified.
19
20 In the near term the plan is to clone various well-known kinds of apps and see
21 what can be added thanks to the Semantic Web goodness. As most apps require the
22 following in some form, this functionality is high on the todo list:
d67a9e28 »
2013-10-13 bits
23 * simple content managent (largely implemented)
24 * user access control (in-progress)
25
f21aff8a »
2013-10-15 user registrqation form basically working (no validation etcyet)
26 Also high on the list is to provide query federation facilities, to e.g.
27 automatically catalog/annotate/expand documents.
d67a9e28 »
2013-10-13 bits
28
f21aff8a »
2013-10-15 user registrqation form basically working (no validation etcyet)
29 Later the plan is to set Seki up as a general-purpose Web agent container, allow
30 custom behaviour to be defined using pluggable scripts with declarative
31 configuration.
d67a9e28 »
2013-10-13 bits
32
f21aff8a »
2013-10-15 user registrqation form basically working (no validation etcyet)
33 ### Components
d67a9e28 »
2013-10-13 bits
34
35 * Server
36 * Client
37 * Routing engine (based on a rules engine)
38 * Templater
39 * User Manager (in progress)
40 * Plugin script runner (todo)
85883821 »
2011-09-07 readme fleshed out
41
f21aff8a »
2013-10-15 user registrqation form basically working (no validation etcyet)
42 ![Block
43 Diagram](https://github.com/danja/seki/raw/master/docs/other/seki-full.png)
85883821 »
2011-09-07 readme fleshed out
44
f21aff8a »
2013-10-15 user registrqation form basically working (no validation etcyet)
45 For updates see [Seki on
46 G+](https://plus.google.com/b/102910670341143019851/102910670341143019851/posts)
9a5c5952 »
2012-03-12 tweak
47
f21aff8a »
2013-10-15 user registrqation form basically working (no validation etcyet)
48 Also [TODO
49 List](https://workflowy.com/shared/dd5976b2-b48f-9096-0357-105f34b4d6ed/)
583af3d6 »
2011-10-02 note about branches added
50
6ca713e0 »
2013-11-30 reorganised dirs, added READMEs (1/20 tests fail)
51 Note 2013-11-30 : there's a README.md in each directory giving overview of its contents.
52
f21aff8a »
2013-10-15 user registrqation form basically working (no validation etcyet)
53 Note 2013-08-27 : packaging etc. still in progress, but I have managed to get a
54 live instance running on OpenShift (Red Hat's hosting service) at
55 http://seki-hyperdata.rhcloud.com/welcome, backed by a Fuseki store hosted at
56 http://fuseki-hyperdata.rhcloud.com/ (using
57 https://github.com/semfact/openshift-fuseki ). The live Seki code is structured
58 differently than that in git here, but as that version works (!) I'll merge it
59 back in here asap.
e1cd3a79 »
2013-08-27 lot of tweaking
60
f21aff8a »
2013-10-15 user registrqation form basically working (no validation etcyet)
61 Note 2013-08-15 : currently trying to package as npm and tidy up dependencies -
62 may be a messfor a little while
23b2c9fd »
2011-10-02 tweak
63
f21aff8a »
2013-10-15 user registrqation form basically working (no validation etcyet)
64 If (were it live) you pointed a browser at http://hyperdata.org/seki/Hello it
65 would take "http://hyperdata.org/seki/Hello" to build a query to find out about
66 that resource - in the data store it will have a title, content etc. - which
67 then get turned into HTML to show in the browser.
85883821 »
2011-09-07 readme fleshed out
68
f21aff8a »
2013-10-15 user registrqation form basically working (no validation etcyet)
69 There is a form to allow POSTing, inserting title, content etc. for a given
70 resource into the RDF store (there's no authentication as yet). Files can also
71 be served from the filesystem.
85883821 »
2011-09-07 readme fleshed out
72
f21aff8a »
2013-10-15 user registrqation form basically working (no validation etcyet)
73 It has been built against a Fuseki server, which uses protocols/query syntax
74 according to the latest SPARQL 1.1 drafts, and so it should be reusable with any
75 SPARQL server.
85883821 »
2011-09-07 readme fleshed out
76
f21aff8a »
2013-10-15 user registrqation form basically working (no validation etcyet)
77 (Note that the current version includes a little SAX-based XML SPARQL results to
78 JSON converter, this was for demo purposes (don't ask!) - future versions *may*
79 use JSON SPARQL results directly).
5dcab1ed »
2011-09-07 tweaked
80
f21aff8a »
2013-10-15 user registrqation form basically working (no validation etcyet)
81 At present it considers all resources to be information resources - the ones
82 that get displayed are instances of sioc:Post. Descriptions of those resources
83 are contained in little named graphs (named by the resources in question). The
84 Fuseki config includes _#dataset tdb:unionDefaultGraph true_ so SPARQL queries
85 can be applied over a (virtual) merge of all the named graphs.
85883821 »
2011-09-07 readme fleshed out
86
f21aff8a »
2013-10-15 user registrqation form basically working (no validation etcyet)
87 After the tutorial version is stable the plan is to use it as an experimental
88 Read/Write Data Web testbed, e.g. adding support for the linked data API, RDF
89 affordances play.
85883821 »
2011-09-07 readme fleshed out
90
533be518 »
2011-09-17 tweaks
91 See contents.txt in individual folders for description.
20456518 »
2011-09-07 changed dir structure, extra docs & code comments
92
533be518 »
2011-09-17 tweaks
93 Installation/running is easy :
94
95 * install node.js (or copy node.exe into the src dir)
7d2ca46a »
2013-10-08 proxy now using rules
96 * run Fuseki using bin/run-fuseki.bat (make executable first on *nix)
97 * in another terminal bin/run-seki.bat (or node Seki.js)
533be518 »
2011-09-17 tweaks
98 * point a browser at http://localhost:8888/seki/
99
100 post data should have URIs of the form http://hyperdata.org/seki/Hello
101 the Fuseki server (SPARQL endpoint) will be accessible at http://localhost:3030/
102
b19c0399 »
2013-10-07 added docco-husky, some other bits for grunt, vows and api-easy. Also…
103 localhost:8888/store/ will proxy to the store
104
f21aff8a »
2013-10-15 user registrqation form basically working (no validation etcyet)
105 Exploring data from Fuseki, first select the /seki dataset through the Control
106 Panel, then go to the query panel
fb344636 »
2013-03-28 bugfix tweaks
107 with e.g.
108 SELECT * WHERE { GRAPH ?graph { ?s ?p ?o } }
b19c0399 »
2013-10-07 added docco-husky, some other bits for grunt, vows and api-easy. Also…
109
110 ----
111
112 2013-10-07
113
f21aff8a »
2013-10-15 user registrqation form basically working (no validation etcyet)
114 Added bits for [Grunt](http://gruntjs.com/), [Vows](http://vowsjs.org/) plus
115 [grunt-vows](https://github.com/CMTegner/grunt-vows), also
116 [APIeasy](https://github.com/flatiron/api-easy), though not yet runnable,
117 related scripts will be in /bin (also will set up 'npm test').
b19c0399 »
2013-10-07 added docco-husky, some other bits for grunt, vows and api-easy. Also…
118
119 [docco-husky]() used for source doc generation.
120
121 ----
122
533be518 »
2011-09-17 tweaks
123
fb344636 »
2013-03-28 bugfix tweaks
124 [Danny](http://dannyayers.com/) 2011-2013
85883821 »
2011-09-07 readme fleshed out
125
126
127
128
Something went wrong with that request. Please try again.