apg.html
Discontinued: not working and no longer maintained.
apg.html is a web page GUI for developing and testing SABNF syntax and the JavaScript APG parsers it generates. It has been removed from the apg repository because of several updates that make it more of an independent project apart from apg.
First, it has been updated to use jQuery for better cross-browser behavior. Second, and more importantly, is the major enhancement of a visual, trace tree using the d3 library.
Installation
The installation uses less and webpack to bundle the node.js code for the web pages and docco to generate the documentation.
npm install -g webpack@2.3.3
npm install -g less@2.7.1
npm install -g docco@0.7.0
Other versions may work fine. These are the versions that the applications have been tested with.
From GitHub:
git clone https://github.com/ldthomas/apg-html.git apg-html
cd apg-html
npm install
From npm:
npm install apg-html
cd node_modules/apg-html
To bundle the applications for web page use and generate the documentation
npm run build
./docco-gen
To view the documentation, open docs/setup.html in any web browser to get started.
Use the "JUMP TO" links in the upper right corner to navigate the documentation for the different pages.
If you want to rebuild the apg or tree bundles separately,
npm run build-apg
npm run build-tree
Usage
apg.html is a single web page, driven by (Webpack) bundled JavaScript. In essence, it provides a panel to input an SABNF grammar, generate a parser from it and test it with an input string. For details, click on
apg.html
and read the Help panel.
New with this version is a feature for viewing a d3.js graphic display of the parse tree. The file
tree.html
can be popped up from apg.html (see the Trace Help) or can be run stand-alone with the tree data in a <script> file. Including the helper function
js/tree-save.js
can assist in getting the data in the right format. See the examples
Copyright
Copyright © 2017 Lowell D. Thomas, all rights reserved
License
Released with the BSD-3-Clause license.