*NOTE: This project integrates with my other [`asl-articles`](https://code.pacman-ghost.com/public/asl-articles) project, so that if an article references a rule, it becomes a clickable link that will open a browser showing that rule. The [`vasl-templates`](https://code.pacman-ghost.com/public/vasl-templates) project can also be configured to allow vehicles and ordnance to open their corresponding Chapter H entries.*
A few things need to be set up before the program can be used; the webapp will guide you through the process.
*NOTE: If you are running from source, you will also need Ghostscript installed.*
### Preparing the data files
The first time the program is run, the MMP eASLRB PDF must be analyzed, and some key data extracted and prepared. The webapp will do this for you automatically, but in the event there are problems, [this page](doc/prepare.md) describes how to do it manually.
### FAQ
- Why is this project called ASL Rulebook *2*? <br> *Several years ago, I wrote a similar *ASL Rulebook* project that worked from a scanned copy of the ASLRB. Since it required a prepared version of the PDF, which couldn't be distributed, there was no point releasing the source code. When MMP released their official eASLRB, I updated the code to work with that, and have released it here.*
- Why doesn't the sidebar update (e.g. to show Q+A) when I click on links within the PDF itself? <br> *This is due to the way the program is architected. The PDF is shown in an iframe, and so the outer application can't get event notifications for things that happen inside that iframe. I might revisit this later (but it's a *lot* of work :-/).*