From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: phillip.lord@newcastle.ac.uk (Phillip Lord) Newsgroups: gmane.emacs.devel Subject: Re: On being web-friendly and why info must die Date: Fri, 12 Dec 2014 14:46:33 +0000 Message-ID: <87k31xhqnq.fsf@newcastle.ac.uk> References: <20141205123549.GA29331@thyrsus.com> <87ppbqb6s1.fsf@gnu.org> <87h9x2f9me.fsf@fencepost.gnu.org> <87a92uf8ik.fsf@fencepost.gnu.org> <8761dif6ib.fsf@fencepost.gnu.org> <87k31xkue1.fsf@newcastle.ac.uk> <87mw6tj8gp.fsf@newcastle.ac.uk> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1418395637 31812 80.91.229.3 (12 Dec 2014 14:47:17 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 12 Dec 2014 14:47:17 +0000 (UTC) Cc: David Kastrup , Emacs-Devel devel To: Lennart Borgman Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Dec 12 15:47:08 2014 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1XzRUp-0002hL-6O for ged-emacs-devel@m.gmane.org; Fri, 12 Dec 2014 15:47:07 +0100 Original-Received: from localhost ([::1]:57629 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XzRUo-0007L6-Ny for ged-emacs-devel@m.gmane.org; Fri, 12 Dec 2014 09:47:06 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:39843) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XzRUf-0007Kt-QL for emacs-devel@gnu.org; Fri, 12 Dec 2014 09:47:03 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XzRUZ-0003EP-Jk for emacs-devel@gnu.org; Fri, 12 Dec 2014 09:46:57 -0500 Original-Received: from cheviot22.ncl.ac.uk ([128.240.234.22]:60219) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XzRUZ-0003E6-AC; Fri, 12 Dec 2014 09:46:51 -0500 Original-Received: from smtpauth-vm.ncl.ac.uk ([10.8.233.129] helo=smtpauth.ncl.ac.uk) by cheviot22.ncl.ac.uk with esmtp (Exim 4.63) (envelope-from ) id 1XzRUY-0007Tj-De; Fri, 12 Dec 2014 14:46:50 +0000 Original-Received: from jangai.ncl.ac.uk ([10.66.67.223] helo=localhost) by smtpauth.ncl.ac.uk with esmtpsa (TLSv1:AES128-SHA:128) (Exim 4.63) (envelope-from ) id 1XzRUH-0007V3-9j; Fri, 12 Dec 2014 14:46:33 +0000 In-Reply-To: (Lennart Borgman's message of "Fri, 12 Dec 2014 15:18:49 +0100") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 128.240.234.22 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:179913 Archived-At: Lennart Borgman writes: >>> You may be right. It depends on what you want to do. Perhaps you have some >>> code to clarify what you mean? >> >> So, consider slidy: >> >> http://www.w3.org/Talks/Tools/Slidy2/#%281%29 >> >> This implements next and previous buttons like info. At the bottom, you >> should see a "contents?" button which gives you a table of contents. The >> table of contents that you see is implemented in about 50 lines of >> Javascript (including action handlers which always take up lots of >> space). In this case the TOC is generated from the H1 tags in the >> underlying HTML. >> >> An index is, essentially, similar to a table of contents although more >> complex. Index items could be added to an HTML presentation either as >> div tags, which could be parsed for as slidy uses H1. Or, alternatively, >> they could be placed in a XML file (index item to anchor) which would >> save parsing the entire HTML file. On top of that, I would add a GUI -- >> so "i" would pop up an index with type ahead, so you could see what you >> are searching through; there are, of course, quite a few type ahead >> libraries available for HTML. >> >> Of course, you might want to do more complex things; an "other pages >> that point here" might be useful to give bidirectional links. A >> set of categories pages to give richer context. A hover over tooltip >> giving glossary information (might be quite useful given that many >> users will misunderstand what the word "window" means in emacs space). >> >> But at heart, I don't see indexes as a show stopper. It's probably >> something that could have been added to texinfo HTML output years ago. >> >> Note that when I say "javascript" where, the all the same things would >> be possible in lisp. It has quite a few type ahead completion libraries >> too, I believe... >> >> Phil > > Thanks Phil, I see what you mean now. > > I was thinking of more complex queries. Say you start with one word, > "word1". You get too many alternatives so you add "word2" to the > search string (or the search completion string). Perhaps you also have > fields you want to specify to narrow the search. > > I guess that searching like that is what people are used to today > (except for fields, of course). I like the Emacs built in > documentation for functions and variables very much. However that is > limited to elisp. To me Info is much more inconvenient. Personally I > would prefer some searching enhanced with fields there. I would agree with this. I am, of course, glad that Emacs doc has an index, but in general, indexes are disappearing from documentation, because it's just as easy to search and less effort for the authors. Also, of course, you can search outside the existing resource. This was Eric's original motivation for moving from texinfo. With the index as is, though, type ahead allows narrowing (buffer to buffer,creating). Phil