Reference implementation of the cslEdit library for searching and editing .csl (Citation Style Language) files

This web application allows users of CSL based reference managers to search for citation styles and edit them. It's still an alpha version, but the Visual Editor supports all the features of independent CSL styles (AFAIK) and it should be possible to do real work with it.

It is an implementation of the CSL editor library.

Play with it here: Citation Style Editor

Prerequisites

• bash (on Windows, I recommend git bash included with msysgit)
• git
• Jekyll
• Node.js 0.8.4 or later
• Java runtime (optional - for running trang to convert the CSL schema)
• Mail server (for sending feedback emails)

To Setup Development Version

• Run git clone --recursive https://github.com/citation-style-language/csl-editor-demo-site.git csl-demo to checkout the repo.

• In the repo directory, run jekyll serve (optional: add --watch to automatically rebuild when source changes).

• Point your browser to localhost:5001 to view the site locally.

• Point your browser to localhost:5001/cslEditorLib/pages/unitTests.html to run the unit tests

To Deploy

For detailed deployment instructions, see DEPLOYMENT.md.

Quick deploy:

# Update library and build
cd cslEditorLib
git submodule update --recursive --remote
npm run build:styles
npm run build:citations
npm run build
cd ..

# Deploy to GitHub Pages (docs/ directory)
./deploy.sh

The site will be automatically deployed to editor.citationstyles.org.

Customising the editor to integrate with your website or application

Create a fork of this csl-editor-demo-site repository and feel free to alter everything for your own needs except for the core library within the cslEditorLib git submodule.

Customisable features include:

• Load/Save functions, see src/visualEditorPage.js
• Navigation bar and feedback widget, see html/navigation.html

You can override these without touching cslEditorLib.

Customising the core library

See documentation for the core library code and it's API at the CSLEditorLib wiki.

If you fix bugs or otherwise improve the core cslEditorLib library, ensure the changes are not specific to your implementation and please issue a pull request so that everyone can benefit. Thanks!