Yes, it can be done.
It’s relatively easy, except if you installed the Workbench in Program Files (x86), which I believe is the default location (and therefore the most likely place on most user’s systems; at any rate, it’s where mine is). Having to deal with Windows’ security measures requires jumping through a few hoops in order to write to the TADS system files. Otherwise, it’s just a matter of adding an href to the Workbench’s documentation index files.
The file that writes the Bookshelf (the page that appears when you click User Manual on the Help Menu) is named indexwb.htm (not index.htm, I assume wb is for Workbench) and it’s located in the C:/Program Files (x86)/TADS3/docs folder.
Or, you can add a link to the list of help topics displayed when you click the Workbench Help menu item. That file is named WBCONT.HTM and it’s located in the TADS3/doc/wb folder.
If the Workbench is installed under Program Files, it is probably easiest to copy these files out to a temp location, make your edits, then copy them back to the folder under Program Files. Otherwise, Windows will demand that you grant administrative permission each time you try to write to the file, and at least some editor programs will flat out refuse to write to the file while the Workbench is running. (I use Notepad++ and I run into that problem, although I believe I have used vim in the past without running into the problem. YMMV.)
Another complication when Workbench is in Program Files is a Windows security measure. You cannot link to a document that is not within the TADS3 file system under Program Files. Windows will insist that all links start from C:\Program Files…. That means that if your Adv3Lite library files are in some other location (I keep mine in D:\dev\TADS…), you won’t be able to point an href at the documentation files in that location. You will have to create a directory within the TADS file system and copy your Adv3Lite documentation to that location, then add a relative link to the Workbench files (relative to the location of the Workbench file you are editing).
I added an adv3Lite/docs folder to the TADS/lib/extensions folder in Program Files (x86) and then use this link in the Workbench files:
Actually, on the Bookshelf page, I copied the entire reference to the first book on the list, then changed all the URLS (two to the book, one to an image file) as follows…
[code]
|
|
Adv3Lite Documentation Index
Bookshelf for Adv3Lite documentation. [/code]
Now, when I click on the User Manual item on the help menu, the Adv3 Bookshelf starts with a link to the Adv3Lite Bookshelf.
Jerry
|