Juris-M is a variant of the free and friendly Zotero research platform, with support for legal and multilingual materials.
Switch branches/tags
Clone or download
#54 Compare This branch is 473 commits ahead, 167 commits behind zotero:master.
Permalink
Failed to load latest commit information.
bin-lib Juris-M monster checkin Dec 5, 2016
chrome Upgrade citeproc-js to 1.1.207 Jun 20, 2018
components Merge branch 'master' of https://github.com/zotero/zotero into jurism… Jun 20, 2018
defaults/preferences Merge branch 'master' of https://github.com/zotero/zotero into jurism… May 3, 2018
deployer @ 9f581cf Update deployer Apr 1, 2018
locale-csv-in Juris-M monster checkin Dec 5, 2016
logo Add Juris-M logo source to repo Mar 5, 2017
resource Update translators, tweak lookup test, bump version to m40 Jul 6, 2018
scripts Merge branch 'master' of https://github.com/zotero/zotero into jurism… Mar 4, 2018
styles @ ed38baf Merge branch 'master' of https://github.com/zotero/zotero into jurism… Jun 20, 2018
test Update translators, tweak lookup test, bump version to m40 Jul 6, 2018
tools NOW a working script for rebranding Apr 11, 2018
translators @ c160cb8 Update translators, tweak lookup test, bump version to m40 Jul 6, 2018
version Bump source version 5.0 Mar 10, 2017
.babelrc Remove obsolete line from Babel config Mar 11, 2018
.gitattributes Fix enforcing of Unix newlines for SQL files Feb 26, 2016
.gitignore Provide a mechanism for customizing firefox path for use in tests Feb 9, 2018
.gitmodules Merge changes from upstream Apr 1, 2018
.travis.yml Merge branch 'master' of https://github.com/zotero/zotero into jurism… Mar 4, 2018
CONTRIBUTING.md Update CONTRIBUTING.md May 29, 2018
COPYING Update COPYING Mar 26, 2018
README.md Simplify installation instruction in README.md Mar 26, 2018
README.rst Juris-M monster checkin Dec 5, 2016
build.sh Trivial change to trigger Travis CI Aug 28, 2017
chrome.manifest Merge branch 'master' of https://github.com/zotero/zotero into jm-5-dev Feb 4, 2018
install.rdf Update translators, tweak lookup test, bump version to m40 Jul 6, 2018
package-lock.json Update translators, tweak lookup test, bump version to m40 Jul 6, 2018
package.json Update translators, tweak lookup test, bump version to m40 Jul 6, 2018
push.sh Report out the pushed hash Apr 1, 2018
update.rdf Update Fx minVersion to 45 Dec 13, 2016
zls.txt Juris-M monster checkin Dec 5, 2016

README.md

Juris-M

Build Status

Juris-M is a modified version of Zotero, with support for multilingual and legal citation styles.


From the Zotero README

Zotero is a free, easy-to-use tool to help you collect, organize, cite, and share your research sources.

Please post feature requests or bug reports to the Zotero Forums. If you're having trouble with Zotero, see Getting Help.

For more information on how to use this source code, see the Zotero wiki.


About this repository and its friends

This repository contains the core Juris-M code module, and a test suite to validate that both the original features of Zotero and the extended functionality of Juris-M are working correctly. If you are working with Juris-M code, you will use this repository for two purposes: to build the module for inclusion in a standalone client; and to run the test suite. Procedures for both are outlined below.

Cloning the repository

Several repositories are needed to build the Juris-M standalone client, so the keep things tidy, create an empty subdirectory, enter it, and clone this respository using commands like the following:

  prompt> mkdir jurism-repos
  prompt> cd jurism-repos
  prompt> git clone --recursive https://github.com/Juris-M/zotero.git

If (as I often do) you forget to include the --recursive option when cloning, pull in the submodules by entering the repository directory and issuing commands like the following:

  prompt> cd jurism
  prompt> git submodule init
  prompt> git submodule update --remote

The subdirectory will be called "zotero", but it will contain Juris-M source code.

node dependencies

To build the module, you will need to have recent versions of node and npm installed. The versions available through the package manager for your operation system will probably do the job. Once you have npm installed, set up the dependencies by executing the following command in this directory:

  prompt> npm install

After setting up the dependencies, you can build the module with this command:

  prompt> node ./scripts/build.js

The script should create a ./build subdirectory and populate it with the module code.

Running tests

The test suite was added to the upstream Zotero source repository at the threshold of Zotero 5.0. The tests have been adapted in the Juris-M repository to exercise the extended fields and other features needed to manage multilingual and legal references. Every test should pass.

To run tests, you will need a compatible version of Firefox on your system. The version that you need depends on your operating system.

(I think that these are right. If you have trouble working with any of them, let me know.)

Once you have a suitable Firefox in place, create a file at ./test/runtests-custom.sh with the following line, adjusting the path to point at the appropriate Firefox in your filesystem:

   FX_EXECUTABLE="/path/to/your/firefox"

Enter the ./test subdirectory, and try a test:

  prompt> ./runtests.sh -b notifierTest.js

The first time it is run, the runtests.sh script will download the pdftools bundle, after which the test should succeed. For full details on the use of the test runner, run the script with the -h option:

  prompt> ./runtests.sh -h

Building the standalone client

To build a running standalone client using the module code, you will clone two repositories as siblings (not children) to the jurism directory:

  prompt> git clone --recursive https://github.com/Juris-M/zotero-build.git
  prompt> git clone --recursive https://github.com/Juris-M/zotero-standalone-build.git

Build steps must be performed in each of these repositories to yield a client installer. See their respective README files for details.