CSH only search facility
[I am not sure whether this is the appropriate forum for this - forgive me if not. I was hoping that Implementors has more watchers that Developers.]
The current Drupal system was built well before the CSH system was developed, and then it was quite appropriate to have the search facility look across everything.
Now we have a CSH system, it would be better to allow people to search just the CSH text - and more specifically just the version they want (ie 1.7 only rather that 1.7 and 1.8).
A bit of googling shows that there are 'book search' modules.
Should we consider installing one?
Regards, Tim G
Re: CSH only search facility
Tim - I created a Jira project just for stuff like this - put it in and either I or yourself can get to it.
I am swamped at the moment doing a PABX port and trying to reconfigure our vpns and the like .....the IAD provided only has a basic web interface and you have to work in CLI in a BSD like environment.
Re: CSH only search facility
I have implemented this on my test system - because this increases the size of the search box area, one needs to change the design slighty - so we get the following:
Does anyone object to this design change?
Note that this is not a complete solution. Ideally one needs to be able to search just the CSH text for the revision that you are using - ie just the 1.7 text, and not also the 1.8 text
You can see below the results for searching for "relative date" in 'Book page'. The two highlighted entries are from 1.7 and 1.8 respectively.
There is a book search module, and this gives the following:
Note that in order to get to this I 'derived a copy' of the CSH book to create a new one named 'Context Sensitive Help (1.8)' and deleted from it all the 1.7 stuff.
However, I am very wary of this (ie having separate CSH books for each release) and I am uncertain of the effect on the Alt-F1 code. I do know that the copy I made is useless, because its page URLs are like
../documentation/csh/1.8/customers/charges/invoice-0
ie a '-0' has been added as a result of the deriving process.
We need to do two things: 1) adjust Tim A's recipe for copying parts of a book so that we can build the new book for the next release; 2) see if we can pull the existing 1.8 CSH out of the current 1.7+1.8 book without killing the page URLs
Regards, Tim G