From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao!not-for-mail From: Gavin Smith Newsgroups: gmane.emacs.devel,gmane.comp.tex.texinfo.general Subject: Re: html manual +css Date: Wed, 15 Jan 2020 11:20:08 +0000 Message-ID: References: <05A866DB-4211-476E-9107-14E5F9BE9232@gmail.com> <53DA475D-B063-470A-BB87-D3FFC9A7CF79@gmail.com> <834lvyct3t.fsf@gnu.org> <01B655FC-51F0-4A33-ADBF-3E1268E9E0EA@gmail.com> <3D282E00-27F3-451A-9895-5BCEEE0B7FA8@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: ciao.gmane.io; posting-host="ciao:159.69.161.202"; logging-data="60627"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Texinfo Help , emacs-devel To: Jean-Christophe Helary Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Wed Jan 15 16:23:37 2020 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1iridq-0003d4-0d for ged-emacs-devel@m.gmane-mx.org; Wed, 15 Jan 2020 14:23:26 +0100 Original-Received: from localhost ([::1]:54022 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iridp-0004hU-3M for ged-emacs-devel@m.gmane-mx.org; Wed, 15 Jan 2020 08:23:25 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:38347) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1irgiy-0000zn-Pa for emacs-devel@gnu.org; Wed, 15 Jan 2020 06:20:38 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1irgix-00089U-IT for emacs-devel@gnu.org; Wed, 15 Jan 2020 06:20:36 -0500 Original-Received: from mail-il1-x12a.google.com ([2607:f8b0:4864:20::12a]:32955) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1irgix-00088x-Do; Wed, 15 Jan 2020 06:20:35 -0500 Original-Received: by mail-il1-x12a.google.com with SMTP id v15so14539968iln.0; Wed, 15 Jan 2020 03:20:35 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=fOiN7T/it1tX8Z3vdCm809zE0MzP7+dsnsCYd3+f4+I=; b=JCx1ftsNtXrQwU4LN6h1QM05+GO2msVmncZKV7E+Vb9NjkH4pxvzyhQxsm06ade2JO 6lCvyYKwUm0q1+6QWCTH2ZmCRpLg1CGVP6g9n/iDOi/zVtZrMk3VdI3RmBvJOeXUO44r i9XItcE+31lcFe6jXpJC/4Yb3JlpKyIJeZEqoeu6Ry4CBbWid7p1GvqsF2j7MbyC3+qu aIhL5MA5LAMt+z6xODMHHxLOqhp4e4LGAaAo3omDYnNE2d+kBEgGvihG4JQ2Ub4ZQpnA lPrvax/weKJhVp63HAM9sFF2UiUdfcxsIb5w3uma7hNRMsQpqXxfg9l/LaJYeaDIl6g4 tLNQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=fOiN7T/it1tX8Z3vdCm809zE0MzP7+dsnsCYd3+f4+I=; b=gEoKTf3pftgyQB1lHEhtdhnavVD5GJsZzcM4YhWTfnEfJjM/4ZKhofyet8aZ99md2M iAzRrbFeOaJLTtYKxMmBH6tqmvQKAUKYO2XSbFWzf1qi8UqwRo78rjxMAWHPR6g8NQ21 ZCk+vYt8twekWzZ3tMImS5zYhqeVkml9CyrkC7mRqMzpKFMyTL+DwCVdrYwADa8iNprq 9xTxvU9fQgzIDCRBA7TwRsAw7KsepHTk0oeshfEmtuCmtxY4rWEONOBZJR4mShtAECkV 5wvsph6Nfsr+SON6pAAZmsrnWtSrDpEsOSgj2GyFE+M7hO/HZcIuUUAXS/EVzXu2GhJz FKOA== X-Gm-Message-State: APjAAAWIRg5pPNNdTJivuHFtwCTrIqi2LqEtfP80L8ViQq/72Tu9k6F1 7a8B6WTMDwqYd0elpEesALLfxJxkXsS3CrZBy74= X-Google-Smtp-Source: APXvYqw6dlJLFrpHLM7TBl29dUJR/qYI/bk8yVIWPq96/eRAyI4f1bSbZbnkfu/W+J2zA1ow5pia0H9fUsGVIoMzgbA= X-Received: by 2002:a92:3a07:: with SMTP id h7mr3038843ila.203.1579087234592; Wed, 15 Jan 2020 03:20:34 -0800 (PST) In-Reply-To: <3D282E00-27F3-451A-9895-5BCEEE0B7FA8@gmail.com> X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2607:f8b0:4864:20::12a X-Mailman-Approved-At: Wed, 15 Jan 2020 08:22:45 -0500 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 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-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:244273 gmane.comp.tex.texinfo.general:2340 Archived-At: On Mon, Dec 23, 2019 at 5:02 PM Jean-Christophe Helary wrote: > > I have eventually resumed "work" on this and here is what I got: > > Original: > https://www.gnu.org/software/emacs/manual/html_node/elisp/Visiting-Functions.html > > Sample: > https://brandelune.github.io/code/Visiting-Functions.html > > The css I wrote: > https://github.com/brandelune/brandelune.github.io/blob/gh-pages/code/emacs.css This looks quite good. > It is something I had done a while ago so I just spent a few hours today cleaning it up but I'm really not sure how I came up with the various values anymore :) > > Anyway, if it looks useful I'd like to think of ways to have it more widely used. > > Also, there are plenty of things that would be nice to have but in a way we're hitting the limits of the texinfo output (and my css skills too, of course). > > For ex: > > @deffn Command find-file filename &optional wildcards > > becomes > >
Command: find-file filename &optional wildcards
> > it would be nice to have the arguments tagged individually and the &optional or &rest keywords tagged in a different way. Also to have the various templates identified for what they are. Possibly: this should be possible if somebody would implement it in texi2any. texinfo.tex already detects the &optional keyword and outputs it in boldface. > Also, examples should have similar tagging: > > @smallexample > (switch-to-buffer (find-file-noselect filename nil nil wildcards)) > @end smallexample > > could be something like > > @smallexample > (@commandname switch-to-buffer (@commandname find-file-noselect @arguments filename nil nil wildcards)) > @end smallexample > > so that we can have ways to target their contents with css. The Guix developers managed to implement syntax highlighting by post-processing the HTML. (https://lists.gnu.org/archive/html/bug-texinfo/2019-11/msg00004.html)