CWRC-GitWriter is an instance of the CWRC-Writer, a WYSIWYG text editor for in-browser simultaneous XML editing and stand-off RDF annotation using the Open Annotation Data Model. CWRC-GitWriter stores documents, annotations, templates, and XML schemas in GitHub.
The code in this repository serves two purposes:
- To back the sandbox deployment http://208.75.74.217
- To provide an example configuration of the CWRC-Writer for those who might like to substitute a different backend (e.g., database, file system on server, different entity lookup.)
A running deployment of the code in this repository is available for anyone's use at:
Although the sandbox version provides a freely usable instance, you may of course install an instance of the CWRC-GitWriter on your own server. CWRC-GitWriter also requires a running instance1 of CWRC-GitServer, which in turn interacts with GitHub through the GitHub API.
Note that if you want to create a new version of the CWRC-Writer that is configured to work with your own document repository (e.g., a database), this repository still provides you with the best example to follow. You'll also want to look at the cwrc-git-dialogs repository, which holds the javascript class that handles calls to the backend storage, in this case to Github via the CWRC-GitServer. This is the class you'd want to replace with your own. To replace the entity lookups you'd replace cwrc-public-entity-dialogs
This repository contains two JS files: the app file and the config file. The app file does not contain much code itself; it's main purpose to load/require other code bases, and then configure and instantiate the CWRC-Writer. It must first be built in order to be useable. To build:
- Download the code for this repository, or clone the repository
- Install all the NPM package dependencies:
npm install - Browserify the code to package it up for deployment:
npm run build
The built code resides in the newly created build directory. It contains the app, along with all the necessary CSS, XML, and image files. To deploy the CWRC-GitWriter simply copy the build directory to your server, probably the same server from which you'd serve the CWRC-GitServer. You might choose to use ftp, scp, rsync, etc. An example rsync command might be:
rsync -azvh -e ssh build/ [email protected]:cwrc
where you'd subsitute your own userid (for jchartrand), ip address (for 1.1.1.1) and directory on server (for 'cwrc')
Another alternative would be to fork this repository, adjust the configuration as needed, and deploy to a host that allows git deployment.
The code in this repository simply brings together and configures code from other repositories and wouldn't in itself typically be usefully modified. You could, however, clone this repository as a base from which to create a new configuration of the CWRC-Writer, or simply use the code here as a guide in creating your own configuration. Your configuration might, for example, use Fedora to store documents, rather than GitHub.
CWRC-GitWriter uses NPM both for dependency management and for running it's main build script. The build script in turn uses Browserify to bundle all code into the single build/js/app.js file. The package.json file contains the script for invoking Browserify as well as the full list of NPM packages required.
The entry point into the CWRC-GitWriter code, on which Browserify is invoked, is src/js/app.js which uses node.js module loading to 'require' - either from the NPM public registry or from local files - the bits and pieces that make up the CWRC-GitWriter, and plug them together. Browserify resolves all the 'require' statements, and bundles all the code, including NPM packages and local files, into a single javascript file that is loaded into the web browser.
To develop a new configuration of the CWRC-Writer, you'll therefore need to understand NPM and Browserify. Then you can get into the CWRC-GitWriter NPM package.json file and src/js/app.js and adapt it to your own project.
The src/js/app.js is in particular a good example of how to configure a instance of a CWRC-Writer to use a different backend (other than Github, e.g., file system, database).
The app.js file imports ('requires') the following NPM CWRC packages:
-
The base CWRC-Writer
-
The javascript class that handles calls to the backend storage, in this case to Github via the CWRC-GitServer.2 This is the class you'd want to replace with your own.
-
The javascript class that handles lookups of named entities. You may want to replace this with your own entity lookup
The app.js file also imports a config file:
-
Javascript object that describes the XML schemas supported, and is used to pass in other objects to the CWRC-Writer.
The src/js/app.js file ties all these together as you would for your own configuration of the CWRC-Writer.
Note that the authentication for Github is invoked in app.js since it redirects to the GitHub site if the user isn't loaded. Better to redirect here at the outset before loading up all the other CWRC related code.
If you are making changes to the npm packages that contribute to the GitWriter (or more likely to some custom instance of the GitWriter that you've built) and you find yourself repeatedly packaging and publishing the NPM packages and reimporting the newly published packages (e.g.,npm i cwrc-writer-base@latest) then you can instead point the package.json dependencies at the local instances, like so:
"dependencies": {
"bootstrap": "3.3.7",
"cwrc-public-entity-dialogs": "file:///Users/jc/Dropbox/cwrc/github/CWRC-PublicEntityDialogs",
"cwrc-git-dialogs": "file:///Users/jc/Dropbox/cwrc/github/cwrc-git-dialogs",
"cwrc-writer-base": "file:///Users/jc/Dropbox/cwrc/github/CWRC-WriterBase",
"jquery": "3.1.0",
"jquery-ui": "1.12",
"js-cookie": "2.1.3"
}
When doing a new build, first pull in any changes you made to the local packages:
rm -rf node_modules/cwrc-public-entity-dialogs && rm -rf node_modules/cwrc-writer-base && rm -rf node_modules/cwrc-git-dialogs && npm install && npm run build
Once finished making and testing local changes, publish the new NPM packages, including the local packages, and remove the dependencies from package.json:
"dependencies": {
"bootstrap": "3.3.7",
"jquery": "3.1.0",
"jquery-ui": "1.12",
"js-cookie": "2.1.3"
}
and finally reinstall them from NPM:
npm i cwrc-writer-base cwrc-git-dialogs cwrc-public-entity-dialogs -S
NOTE: another alternative to working with local packages is npm link
As explained in the development section you wouldn't typically usefully modify anything here for use by others. Nevertheless, if there is something we've missed, please submit an Issue. If you are interested, however, please take a look at our Development Docs
1. Instructions for installing the CWRC-GitServer are here: CWRC-GitServer. ↩