User Guide

Starting the App

1. open Terminal and cd to the project's build directory (e.g. cd ~/dev/netcreate-2018/build)
2. ./nc.js --dataset=projectname (e.g. --dataset=tacitus)
3. point your browser at http://localhost:3000

The nc.js script will set up the app to load the project called tacitus and start the server.

The script expects your database file and template file to have the same name. And it expects to find them in the build/runtime folder. So if you have some existing projects, e.g. tacitus, then you'll want to set up the build/runtime folder like this:

/build/runtime/tacitus.loki
/build/runtime/tacitus.template

If no database or template is found, it will create a new one with that name.

If you want to back up your data, back up the files in build/runtime.

See Pull Request #67 for more information.

Setting Up Users

To generate access tokens:

1. Open your browser to http://localhost:3000/ (or whatever URL you're using)
2. Open the Developer Web Console
3. Type ncMakeTokens('class','project','dataset',30) -- where class is a short designation of class name, project is any project name, 'dataset' is the name of the loki/template file you're working with, and 30 is the number of tokens you want to generate. e.g. ncMakeTokens('hist101','tacitus','Tacitus',50)
4. Copy the list of tokens output in the console and hand them out to students.

See Pull Request #32 for more information.

Admin Mode

Only admins are allowed to delete nodes. To log in as an admin user, you must either be on localhost, e.g. ip = 127.0.0.1 or add ?admin=true to the url.

NOTE: If you're running nc-multiplex, the URL looks like this: http://<domain-or-ip>/graph/SampleEventNetwork/#/?admin=true

Comments

Some rough notes on comments:

• Comments as implemented as of April 2024 requires login in order to track read/unread status.
• See PR #133 Comment UI First Pass for initial implementation.
• See PR #139 Handling Comment Deletion for how comments are deleted.