CWRC-GitServer

Table of Contents

1. Overview
2. API
3. Demo
4. Setup

Overview

The CWRC-GitServer is a node.js Express server acting as a proxy between cwrc-git-dialogs and the GitHub API. The CWRC-GitServer in turn invokes CWRC-Git which is used to make the actual calls to GitHub.

CWRC-GitServer provides http endpoints for listing, creating, and updating XML documents.

API

View the full API here

Demo

The CWRC-GitWriter Sandbox is running an instance of CWRC-GitWriter, which uses the code from CWRC-WriterBase and cwrc-git-dialogs. There is a corresponding server component running this code and using the CWRC-Git module. The same code is easily (for someone with modest development experience) installed on any server to run your own instance. If you are looking to put together your own CWRC-Writer, CWRC-GitWriter is a good place to start.

Setup

There are two approached to install the sandbox version of the CWRC-GitWriter.

1. Install the dockerized verion of Git-Server/Git-Writer. The instruction for this approach is descibed in the CWRC-GitWriter-Docker repo.

2. Manually install each component. Instruction is down below:

Install node.js on a server (one approach for ubuntu is described here: https://nodejs.org/en/download/package-manager/#debian-and-ubuntu-based-linux-distributions

Clone this repository to the server, or copy the files to the server.

On the server switch into the CWRC-GitServer directory and run:

npm install (to install the npm packages on the server)

Install pm2 to run Express.js as a service:

sudo npm install pm2 -g
cd ~/cwrcserver
pm2 start ./src/index.js

OAuth

Next you'll need to create an OAuth app so that CWRC-GitServer can access GitHub on behalf of the user.

Config

Once you have the client ID and client secret for your OAuth app, you'll need to edit the config.json file. The following fields need to customized:

github_client_cors

Set to true if CWRC-GitServer is at a different origin than CWRC-GitWriter.

github_client_origin

The origin for CWRC-GitWriter (used if github_client_cors is true).

github_client_id

The client ID for your OAuth app.

github_client_secret

The client secret for your OAuth app.

github_oath_callback

The URL that GitHub should redirect to, after the user authorizes the OAuth app. It should lead to the github/callback route as seen here.

github_oath_callback_redirect

The URL that CWRC-GitServer should redirect to, after handling the OAuth callback. It should lead to your installation of CWRC-GitWriter.

CWRC-GitWriter

You will also have to install the CWRC-GitWriter code on the server, as explained in its README.