Metadata-Version: 2.0
Name: ferenda
Version: 0.1.7
Summary: Transform unstructured document collections to structured Linked Data
Home-page: https://github.com/staffanm/ferenda/
Author: Staffan Malmgren
Author-email: staffan.malmgren@gmail.com
License: BSD
Keywords: rdf linkeddata parsing
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application
Classifier: Topic :: Text Processing
Classifier: Topic :: Text Processing :: Indexing
Classifier: Topic :: Text Processing :: Markup :: XML
Requires-Dist: beautifulsoup4 (>=4.3.0)
Requires-Dist: jsmin (>=2.0.2)
Requires-Dist: lxml (>=3.2.0)
Requires-Dist: rdflib (>=4.0.1)
Requires-Dist: html5lib (>=1.0b1)
Requires-Dist: rdfextras (>=0.4)
Requires-Dist: requests (>=1.2.0)
Requires-Dist: Whoosh (>=2.4.1)
Requires-Dist: six (>=1.4.0)
Requires-Dist: docutils (>=0.11)
Requires-Dist: SimpleParse (>=2.1.1)
Requires-Dist: pyparsing (<=1.5.7)

.. -*- coding: utf-8 -*-

Ferenda is a python library and framework for transforming
unstructured document collections into structured Linked Data. It
helps with downloading documents, parsing them to add explicit
semantic structure and RDF-based metadata, finding relationships
between documents, and publishing the results.

.. image:: https://travis-ci.org/staffanm/ferenda.png?branch=master
    :target: http://travis-ci.org/staffanm/ferenda/

.. image:: https://coveralls.io/repos/staffanm/ferenda/badge.png?branch=master
    :target: https://coveralls.io/r/staffanm/ferenda

Quick start
-----------

This example uses ferenda's project framework to download the 50
latest RFCs and W3C standards, parse documents into structured,
RDF-enabled XHTML documents, loads all RDF metadata into a triplestore
and generates a web site of static HTML5 files that are usable
offline::

    pip install ferenda
    ferenda-setup myproject
    cd myproject
    ./ferenda-build.py ferenda.sources.tech.RFC enable
    ./ferenda-build.py ferenda.sources.tech.W3Standards enable
    ./ferenda-build.py all all --downloadmax=50 --staticsite --fulltextindex=False
    open data/index.html

The same functionality can also be accessed through a python API, if
you want to use ferenda as part of a larger system. It's also possible
to just use the parts of ferenda that you need (eg. only the
downloading and parsing features).

More information
----------------

See http://ferenda.readthedocs.org/ for in-depth documentation.

Copyright and license
---------------------

Most of the code written by Staffan Malmgren, licensed under the main
2-clause BSD license.

Some bundled code and other creative works are written by other
authors, included in accordance with their respective licenses:

* `cssmin <https://pypi.python.org/pypi/cssmin/>`_ by Zachary Voase, BSD
* `rdflib-sqlite <https://github.com/RDFLib/rdflib-sqlite>`_ by Graham
  Higgins, BSD
* `patch <https://code.google.com/p/python-patch/>`_ by Anatoly
  Techtonik, MIT
* `Grit XSLT stylesheets <http://code.google.com/p/oort/wiki/Grit>`_
  by Niklas Lindström, BSD
* `httpheader <http://deron.meranda.us/python/httpheader/>`_ by Deron
  Meranda, LGPL
* `normalize.css <http://git.io/normalize>`_, MIT
* `responsive template <http://verekia.com/initializr/responsive-template>`_, PD
* `jquery <http://jquery.com>`_ , MIT
* `modernizr <http://modernizr.com>`_, MIT
* `respond.js <http://github.com/scottjehl/Respond>`_, MIT/GPL
* `Gentleface wireframe toolbar icons
  <http://gentleface.com/free_icon_set.html>`_, CC-BY-NC




