Skip to content
A journal management system designed for publishing scholarly articles.
Branch: master
Clone or download
Latest commit 7b688a4 Mar 20, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE Update issue templates Mar 1, 2019
db Adds mariadb to supported dev databases Mar 18, 2019
dockerfiles
jenkins Build from janeway-base image Jan 31, 2019
setup_scripts
src #1020 stops view from trying to create a missing setting which has ca… Mar 20, 2019
.dockerignore Plugins should be ignored by Dockerfile Feb 27, 2019
.gitattributes
.gitignore #864: updates .gitignore for issue files Feb 12, 2019
.scrub.sh PEP8 Mar 9, 2018
.update.sh
CODE_OF_CONDUCT.md md files should not be executable Feb 7, 2019
CONTRIBUTING.md md files should not be executable Feb 7, 2019
CONTRIBUTORS.md md files should not be executable Feb 7, 2019
LICENSE
Makefile Adds mariadb to supported dev databases Mar 18, 2019
README.md
dev-requirements.txt
docker-compose.yml
requirements.txt Bumps Django to 1.11.20 Feb 13, 2019

README.md

Janeway Logo

Janeway is a journal platform designed for publishing scholarly research material. It is developed and maintained by the Centre for Technology and Publishing at Birkbeck, University of London.

Technology

Janeway is written in Python (3.5+) and utilises the Django framework (1.11 LTS).

Installation instructions

Developer installation instructions are available on our Wiki.

A guide for installing on the live environment with apache and mod_wsgi is also available.

Running Janeway with docker

Janeway's development server can be run within a docker container, avoiding the need to install and run its dependencies from your machine. A docker-compose file as well as a Makefile can be found at the root of the project wrapping the most common operations. Docker is compatible with multiple architectures and Operating systems, if you need help installing docker, have a look at the docker documentation.

Simarly to the native installation, Janeway can be installed in a docker environment by running make install and following the installation steps described above. As a result, a database volume will be populated under janeway/db/postgres-data Once installation is completed, just type make to run janeway with a postgres backend (default behaviour).

If a change to the dependencies for Janeway is required, the Janeway container can be re-created with make rebuild. The database volume will be preserved.

In order to run a different RDBMS, the environment variable DB_VENDOR can be set to one of postgres, mysql or sqlite. e.g: DB_VENDOR=mysql make install && make

Uninstalling Janeway is as simple as running make uninstall which will delete all related containers as well as wipe the database volume.

Janeway design principles

  1. No code should appear to work "by magic". Readability is key.

  2. Testing will be applied to security modules and whenever a post-launch bugfix is committed. We do not aim for total testing but selective regression testing.

  3. Security bugs jump the development queue and are a priority.

  4. We will never accept commits of, or ourselves write, paywall features into Janeway.

Licensing

Janeway is available under the terms of the GNU AFFERO GENERAL PUBLIC LICENSE (Version 3, 19 November 2007).

Contributions

We welcome all code contributions via Pull Requests where they can be reviewed and suggestions for enhancements via Issues. We do not currently have a code of conduct for this repo but expect contributors to be courteous to one another. In order to more easily associate changes to their respective github issues, please adhere to the following conventions:

  • Branch names should be prefixed with the issue number they are related to, followed by either "Feature" or "Hotfix" depending on the nature of the change ( e.g: 66-Feature)
  • Start every commit with a reference to the github issue they are related to (e.g: #66: Adds new feature xyz)

Contacts

If you wish to get in touch about Janeway, contact information is provided below.

Project Lead - Martin Paul Eve, martin.eve@bbk.ac.uk

Lead Developer - Andy Byers, a.byers@bbk.ac.uk

Releases

  • v1.0 Kathryn released 10/08/17
  • v1.1 Chakotay released 01/09/17
  • v1.2 Tuvok released 06/11/17
  • v1.3 Doctor released 10/08/18
You can’t perform that action at this time.