Re: AJAX-search field in the docs (Proof-of-concept)

[John Mandereau]

Reinhold Kainhofer a écrit :
> A few days ago, I decided it's finally time to learn what all that 
> hype about AJAX is about. What would be a better guinea pig than 
> trying to implement a seach box in our docs??? Well -- it turned out 
> incredibly easy. Here it is: 
> http://kainhofer.com/~lilypond/ajax/Documentation/user/lilypond-learning/index.html
> (or any other manual there, like the NR or so)
>   
Excellent!


> If JavaScript is disabled (so that AJAX won't work, either) or the files 
> are viewed as static files on your harddisk (i.e. not over http, so
> the AJAX call would fail for sure), no search box is shown.
>   
It's certainly possible to enable the search for local docs by replacing 
AJAX calls with loading files locally.

> The other problem is that the www-post script doesn't seem to install
> the *.de.idx, *.ja.idx, *.fr.idx and *.es.idx files, while the *.en.idx files
> are properly installed to Documentation/user/... So for now the search 
> only works in the English docs.
The "culprit" is not www_post.py, it's the command that links translated 
doc files
to Documentation/user in make/doc-i18n-user-targets.make.


> These search boxes are for now meant as a proof-of-concept 
> implementation mainly. I haven't done any work on the corresponding
> CSS styling to make the results look nicer.
>   
I'm sure you'll push the implementation further to add it in our 
documentation :-)

Cheers,
John