A package that defines the site policy of a PloneScholarlyJournal site.

sources | issues

The Plone Scholarly Journal (PSJ) is a collection of packages to create and maintain scientific scholarly journals using Plone.

The special abilities of PSJ are:

• High quality on-the-fly transformations of office documents using OpenOffice/LibreOffice.
• Flexible metadata handling

This package contains the transforms to generate HTML and PDF docs from input files in office formats (.doc, .docx, LibreOffice docs).

Currently, the whole thing consists of three packages:

• psj.content (provides specialized content types with extended metadata handling)
• psj.policy (this package)

You need the following things to install this package:

• Python 2.6 or 2.7

  Currently Python 2.6 or 2.7 is needed to run Zope (Plone and psj). Python 2.7 is recommended.

  The package also requires libxml2-dev and libxslt-dev to compile the Python lxml package.

  Debian/Ubuntu users can install it via:

  $ sudo apt-get install python-dev

• git

  git is needed to fetch development packages of ulif.openoffice that are not released already.

  Debian/Ubuntu users can install it via:

  $ sudo apt-get install git

• libxml, libxslt, zlib

  libxml2, libxslt, and the zlib compression library are required for lxml support required by this package. The development versions of this packages are needed to have access to the respective header files.

  Debian/Ubuntu users can install them via:

  $ sudo apt-get install libxml2-dev libxslt-dev zlib1g-dev

  (tested on Ubuntu 14.04.2)

• unoconv, tidy

  unoconv is the commandline tool we use for transforms behind the scene. Strictly speaking it is not required (everything will install without it), but if you want any transforms, you will need it.

  tidy is also a commandline helper. It is needed for cleaning up HTML code. Not strictly required, but you will need it if you want flawless workflows.

  Debian/Ubuntu users can install these tools via:

  $ sudo apt-get install unoconv tidy

  (tested on Ubuntu 14.04.2)

First, make sure your system meets the requirements mentioned above.

We use zc.buildout to build a runnable, testable psj environment.

As first step we get the sources from github and change to the newly created dir:

$ git clone https://github.com/ulif/psj.policy
$ cd psj.policy

Bootstrap the initial buildout environment:

$ python2.7 bootstrap.py -v 1.7.1

and run the buildout command:

$ bin/buildout

Lots of stuff will be downloaded, compiled and installed here.

If you happen to change the values in buildout.cfg, you have to 'rebuild' the environment by running bin/buildout again.

You can run the tests using something like:

$ bin/test

If you use psj.policy as part of another package, you can simply install it using pip and the Python Package Index (PyPI).:

$ pip install psj.policy

which will install the latest released version. If you have psj.policy already installed, you can update using:

$ pip install -U psj.policy