Roger's approach needs experimenting with, before we commit much more time to this, Don.
But your approach does at least have the merit of migrating smoothly to a Wiki-based Help. Also of hiliting those words which have some potential in following up (or down). Of course there's other ways of achieving that. I guess if all the Help pages were crammed into one HTML file, it wouldn't make an outsized webpage by today's standards. The whole Help folder only amounts to 12.3MB on my disk. Ian On Tue, Jan 19, 2010 at 4:53 PM, Roger Hui <rhui...@shaw.ca> wrote: > If I were trying to achieve the same objective, I would > catenate all the pages together into a single HTML page > (removing the prolog and epilog parts), and then just > use the "Find" facility of the browser on the one HTML page. > > > > ----- Original Message ----- > From: Ian Clark <earthspo...@googlemail.com> > Date: Tuesday, January 19, 2010 8:29 > Subject: Re: [Jprogramming] The Ambiguous Dictionary > To: Programming forum <programming@jsoftware.com> > >> Yes, Don, this is potentially most useful to me and I'd like to >> get it >> working (again). >> >> I tried converting all x.-->x y.-->y and \-->/ (for the Mac) but >> I hit >> snags, like use of (m.) So I gave up that approach, enabled (x.) and >> (y.) (etc...!!!) and ran it. Then it did indeed run, but all the >> hyperlinked words I tried either failed to move (=took me back >> to the >> same page) or took me back to Ndx and not to the next relevant page, >> as I understand you to say. A glance at the source of a few pages >> confirms this (but i've only looked at a few.) So I guess it's not >> building its word lists right? >> >> I bethought myself to take the precaution of duplicating the folder: >> "/Applications/j602/help/" before letting your app save back the >> files. Maybe you might warn the user more explicitly: "we are >> about to >> overwrite the contents of "/Applications/j602/help/" -- go and >> duplicate that folder now." >> >> As to what words to hyperlink, the words it chooses now seem good, >> though whether I'd think so after using it a lot I can't say. >> I'd find >> it straightforward though to edit a separate script of the words >> chosen (the app might write one out) -- or edit a stub script which >> originally looks like this: >> >> INCLUDETHESEWORDS=: 0 : 0 >> myword >> yourword >> etc >> >> EXCLUDETHESEWORDS=: 0 : 0 >> word >> memory >> Linux >> etc >> ) >> >> BTW same-page links don't do a lot in my browser: they behave like >> no-ops (unless the next word is off the screen) and I have to >> use Find >> to look for the last occurrence of a word like "icon" before I >> see a >> link that goes anywhere. I suggest that *all* hyperlinked words >> on a >> given page take you to the next relevant page, and that the user >> wanting all occurrences of "icon" (say) on a given page should use >> Find. Should simplify the app too. >> >> Having experience in generating HTML in APL, and needing the practice >> before I start porting my existing APL apps to J to run on the Mac, >> let me volunteer to help get this app up-to-date. I'll need to pester >> you with questions about your code (maybe off-list). Perhaps we might >> co-work the wiki page >> http://www.jsoftware.com/jwiki/DonGuinn/AddHelpLinks.ijs ? >> >> Ian >> >> >> On Tue, Jan 19, 2010 at 4:03 AM, Don Guinn >> <dongu...@gmail.com> wrote: >> > Several years ago I got tired of going to the J help cross >> reference, going >> > to a referenced page, then having to go back to the cross >> reference to find >> > other references. So I wrote a script that made words listed >> in the cross >> > reference into links in every help page where they occur. The >> links links to >> > the next occurrence of the word in help, whether it is later >> in the same >> > page or on another page. The last one found links back to the >> word in the >> > cross reference. >> > >> > I found it speeds up navigating through J help. I think it >> needs a better >> > way to choose words to link, but the cross reference was easy >> to use for >> > that purpose. If people are interested in this then a better >> way to choose >> > words can be made. >> > >> > I put this script at >> > http://www.jsoftware.com/jwiki/DonGuinn/AddHelpLinks.ijs to >> avoid attaching >> > the file to this note. I wrote this a long time ago, so it >> uses x. and y. >> > instead of x and y, but it still works if you enable x. and y. >> names. Also, >> > I still have lots of trouble navigating in the J wiki, so it >> looks like a >> > file to be viewed instead of one to download. >> > >> > The script runs when loaded. It pops up a few messages telling >> you what it >> > is doing and before it writes anything to the help files it >> asks you if you >> > want to proceed. At this point it has completed all processing >> and all left >> > to do is write out the files. > ---------------------------------------------------------------------- > For information about J forums see http://www.jsoftware.com/forums.htm > ---------------------------------------------------------------------- For information about J forums see http://www.jsoftware.com/forums.htm
