From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Lennart Borgman Newsgroups: gmane.emacs.devel Subject: Re: On being web-friendly and why info must die Date: Fri, 12 Dec 2014 15:18:49 +0100 Message-ID: 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; charset=UTF-8 X-Trace: ger.gmane.org 1418394001 4464 80.91.229.3 (12 Dec 2014 14:20:01 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 12 Dec 2014 14:20:01 +0000 (UTC) Cc: David Kastrup , Emacs-Devel devel To: Phillip Lord Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Dec 12 15:19:51 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 1XzR4R-0003cI-7f for ged-emacs-devel@m.gmane.org; Fri, 12 Dec 2014 15:19:51 +0100 Original-Received: from localhost ([::1]:57529 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XzR4Q-0004W4-O2 for ged-emacs-devel@m.gmane.org; Fri, 12 Dec 2014 09:19:50 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:33897) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XzR4B-0004Vz-Vw for emacs-devel@gnu.org; Fri, 12 Dec 2014 09:19:37 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XzR47-0000tb-OH for emacs-devel@gnu.org; Fri, 12 Dec 2014 09:19:35 -0500 Original-Received: from mail-wg0-x230.google.com ([2a00:1450:400c:c00::230]:51084) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XzR45-0000tF-VD; Fri, 12 Dec 2014 09:19:30 -0500 Original-Received: by mail-wg0-f48.google.com with SMTP id y19so9202061wgg.7 for ; Fri, 12 Dec 2014 06:19:29 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc:content-type; bh=FwIdhP+ExBUqZUshau8JJs3WWBefsQfCO+P/dHTTu4I=; b=ispQuqr0/flPp3NuQb4UEq+VX/rnHfYNHBMGDgpUQyeHG6DI+SD7puoMwI7idw/TWu EyOGpXDmvDUjnlBL9UNFlBCgPgpdJ+K/QXinUY8vH3AcfoaZpO5CGRN0+lCaY6I+Cj0E A7WOsYQnt1/jQtvY1LN0cW/U1wjE3yjeVNE3XYZKWBzlPaBzLNalBoOjgl2BbWwzrLjT KDMHF253+bpTQLvULVCp5qh6PDnR9p8pCO8EDSGtxV484MUeSEe6f7casy97xjXOpWxC Ip7Tt2aLQnSe4f+q23xoaQLdKulUYjBosug6uIytKCNSp5p3zMIVjiVc6fqSrNzdqzh/ pnyw== X-Received: by 10.180.95.37 with SMTP id dh5mr8151128wib.64.1418393969225; Fri, 12 Dec 2014 06:19:29 -0800 (PST) Original-Received: by 10.194.93.228 with HTTP; Fri, 12 Dec 2014 06:18:49 -0800 (PST) In-Reply-To: <87mw6tj8gp.fsf@newcastle.ac.uk> X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2a00:1450:400c:c00::230 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:179904 Archived-At: On Fri, Dec 12, 2014 at 2:36 PM, Phillip Lord wrote: > Lennart Borgman writes: >>> I don't think it is a tough job. If the index data is in the source >>> format, and can be dumped in XML, then the JavaScript (or the lisp with >>> which to pimp up EWW) is really very simple. >>> >>> Phil >> >> 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.