jsNG


Introduction

jsNG is a small JavaScript library for reading Norton GUide database files.
It also contains a handful of command line utility tools for looking inside
guides, including ngserve, a simple Norton Guide web server.

This is still a bit of a work-in-progress. It is, in part, my "Hello, World"
for getting to know ES6-ish ways of coding, and also seeing what's possible
with node (which I've never used before to write CLI tools).

The code itself is mostly based on what I wrote for
the WEGLib library that
forms part of weg.

I don't offer this as good ES6 code. I don't offer this as good code at all.
At the moment I'm also not really considering taking contributions to the
code as this is still a pet project.

Anyone looking for background documentation for the format of Norton Guide
files might
find
my page of documentation about it useful.

Contents

lib/jsNG*.js - The main jsNG library code.
See the docs for details on how to use it.

bin/ngabout -- Tool to get the credits for one or more Norton Guide files.

bin/ngdir -- Simple tool to show a directory of Norton Guide files. Shows
the name, the type and the title of each guide.

bin/ngserve -- Simple Norton Guide database server. By default it serves
all of the guides named on the command line
on localhost:8080.

bin/ng2html -- Simple tool for turning a Norton Guide file into a
collection of HTML files.

Make targets

The top level directory contains a Makefile. The most useful targets are:

make tests -- Runs a simple test (found in test/) to ensure some of the
core functions of jsNG are working fine.

make dump -- Runs bin/ngdump on a test guide.

make dir -- Runs bin/ngdir on the test guides.

make about -- Runs bin/ngabout on a test guide.

make serve -- Runs bin/ngserve on the test guides.