Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 70 lines (46 sloc) 3.325 kb
0221e4b @iherman Added a DOI badge
iherman authored
1 [![DOI](https://zenodo.org/badge/doi/10.5281/zenodo.14547.svg)](http://dx.doi.org/10.5281/zenodo.14547)
2
780c7cb @iherman Added an .md version of the read me file
iherman authored
3 PyRDFA
4 ======
5
9adab2b @iherman Changed the warning text
iherman authored
6 New users may choose not to use this package for RDFa 1.1 processing; instead RDFa parsing has
780c7cb @iherman Added an .md version of the read me file
iherman authored
7 been added to the latest release of the core RDFLib package as a parser, using the same
8 code as in this package. For most users this package is of a historical interest only,
9 except for those who have incorporated this version as part of their application workflow
10 and do not want to change the full workflow.
11
12 Bugs in processing RDFa 1.1 will be taken care of both in this package and in the
9adab2b @iherman Changed the warning text
iherman authored
13 version in RDFLib.
780c7cb @iherman Added an .md version of the read me file
iherman authored
14
15 2013-08-13
16
17
18 Usage Warning
19 -------------
20
21 Warning (2013-07-16): the latest version of the html5lib package has a bug.
22 This bug manifests itself if the source HTML file contains non-ASCII Unicode characters
23 Until the bug is handled, users should use the older, 0.95 version. It can be downloaded
24 at <https://code.google.com/p/html5lib/downloads/detail?name=html5lib-0.95.tar.gz>
25
26 What is it
27 ----------
28
29 pyRdfa distiller/parser library. The distribution contains:
30
31 - ./pyRdfa: the Python library. You should copy the directory
32 somewhere into your PYTHONPATH. Alternatively, you can also run the
33
34 `python setup.py install`
35
36 script in the directory.
37
38 - ./scripts/CGI_RDFa.py: can be used as a CGI script to invoke the library.
39 It has to be adapted to the local server setup, namely in setting the right paths
40
41 - ./scripts/localRdfa.py: script that can be run locally on to transform
42 a file into RDF (on the standard output). Run the script with "-h" to
43 get the available flags.
44
45 - ./Doc-pyRdfa: (epydoc) documentation of the classes and functions
46
47 - ./Additional_Packages: some additional packages that are necessary for the library; added here for an easier distribution.
48 Each of those libraries must be installed separately. Exception is RDFLib that should be installed directly from the server
49
50 The package primarily depends on:
51 - RDFLib: <http://rdflib.net>. Version 3.2.0 or higher is strongly recommended.
52 - html5lib: <https://github.com/html5lib/html5lib-python>
53 - simplejson: <http://undefined.org/python/#simplejson> (in the additional packages folder), needed if the JSON serialization is used and if the underlying python version is 2.5 or lower
54 - isodate: <http://hg.proclos.com/isodate> (in the additional packages folder) which, in some cases, is missing and RDFLib complains (?)
39d3bf2 @iherman Added a usage of Niklas' JSON-LD serializer instead of the internal one.
iherman authored
55
56 At the moment, the JSON-LD serialization depends on an external JSON-LD serializer. The package comes with a simple one, but if Niklas Lindström's rdflib_jsonld package is available, then this will be used. The former is not really maintained; the latter is in github: ,https://github.com/RDFLib/rdflib-jsonld>. Note that, eventually, this serializer will find its way to the core RDFLib distribution.
780c7cb @iherman Added an .md version of the read me file
iherman authored
57
58 The package has been tested on Python version 2.5 and higher. Python 2.6 or higher is strongly recommended. The package has been adapted to Python 3, though not yet thoroughly tested, because the html5lib does not have yet a Python 3 version.
59
60 For the details on RDFa 1.1, see:
61
62 - <http://www.w3.org/TR/rdfa-core>
63 - <http://www.w3.org/TR/rdfa-lite/>
64 - <http://www.w3.org/TR/xhtml-rdfa/>
65 - <http://www.w3.org/TR/rdfa-in-html/>
66
67 possibly:
68
69 - <http://www.w3.org/TR/rdfa-primer/>
Something went wrong with that request. Please try again.