From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Jean-Christophe Helary Newsgroups: gmane.comp.tex.texinfo.general,gmane.emacs.devel Subject: Re: html manual +css Date: Tue, 24 Dec 2019 01:54:43 +0900 Message-ID: <3D282E00-27F3-451A-9895-5BCEEE0B7FA8@gmail.com> 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> Mime-Version: 1.0 (Mac OS X Mail 13.0 \(3608.40.2.2.4\)) Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="150880"; mail-complaints-to="usenet@blaine.gmane.org" Cc: help-texinfo@gnu.org To: emacs-devel Original-X-From: help-texinfo-bounces+gnu-help-texinfo2=m.gmane.org@gnu.org Mon Dec 23 18:02:09 2019 Return-path: Envelope-to: gnu-help-texinfo2@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1ijR5s-000d6w-BL for gnu-help-texinfo2@m.gmane.org; Mon, 23 Dec 2019 18:02:08 +0100 Original-Received: from localhost ([::1]:59142 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ijR5p-0003Wh-Pp for gnu-help-texinfo2@m.gmane.org; Mon, 23 Dec 2019 12:02:05 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:44357) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ijQzQ-0003Jk-HJ for help-texinfo@gnu.org; Mon, 23 Dec 2019 11:55:29 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ijQzO-0003bu-Gb for help-texinfo@gnu.org; Mon, 23 Dec 2019 11:55:28 -0500 Original-Received: from mail-pf1-x444.google.com ([2607:f8b0:4864:20::444]:40784) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1ijQzK-0003WY-GU; Mon, 23 Dec 2019 11:55:22 -0500 Original-Received: by mail-pf1-x444.google.com with SMTP id q8so9449544pfh.7; Mon, 23 Dec 2019 08:55:21 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:subject:from:in-reply-to:date:cc :content-transfer-encoding:message-id:references:to; bh=53Wy/mXIXoBcmTXkKCSYdJqQooGE4tq1SwGe+qX6kUQ=; b=ZQOFPZO2EAAi2T8J3A8+McNCriiZMfmTTAG5/jZz/1RNnF0dP1e/VqBNAOH9fy2kLZ jSNymcz/Txvf+nwEOzC4MuRm3ukV6w5Srnm5mq65hUDmTUIbE+CIccf1PMRJzCUYVcMp 5EIkgN1CWsvFyYGEVBBOZvmPIWCvzoOx4UjTx94yvC2g6sSiR7gKerdI61DXomgoWjbl 7nb/M0mpkVfP5y7VHDx9CP3Q0XptAjDKBoB8Jun7p9RyCaLy9Eke8yimuYeV4hsEYAe/ ynnx4gV6fG8Mkv4GXPZiIxVCEhNv6Z8ls/yyS3h9mXMIcmZY7DQUol1ldm7hqzfeYbOT ViIw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:subject:from:in-reply-to:date:cc :content-transfer-encoding:message-id:references:to; bh=53Wy/mXIXoBcmTXkKCSYdJqQooGE4tq1SwGe+qX6kUQ=; b=K0kH4/cOY0oPVzGGiRMhocxAFvC6Vpc9323/eNiiGhkruVHBuB5lyrdBBYYAQPVbBS pK9ZAR4Qw3f1KTBP01wvHvPRKfvvwipOC13Lq6wDYdmP7Mnrz8P8H3hoCoihrUmJKzrl psT5Vbh33SCZnnwavtk22BKbxc/fcv7tlzZ9sbxw/6+DHvfVnVZ6v/W8+WPDzfqLPQhL PSKNnuR/6XkF44Z/IzXh+gJY3bm5za7ZU7m1T8otQaoDJVHWUKjvovsTTYYIaQualJN0 TSdEsQ6Cs+n9VHjaxxoYZZiKiYx26Qi5HlpJ16DG+omhvBwWBqmNo5SP50o1LJN2ZGxS LBRQ== X-Gm-Message-State: APjAAAXY3abXl8prlg+HcHYW+Vy5oozQRgXBDmvJR8mzdqqYwb191fjH zNyav4y6srOdoT5tuGi7VnjPJyNB X-Google-Smtp-Source: APXvYqw9Roc8dIGP7TFVYQRhz4dCqHrAfB/ATRL4RHxr5hKXYyB7tfP54L1w56oSUPDeAVaIOLL/kQ== X-Received: by 2002:a65:4c06:: with SMTP id u6mr32948955pgq.412.1577120120664; Mon, 23 Dec 2019 08:55:20 -0800 (PST) Original-Received: from [172.20.10.3] (KD182251133105.au-net.ne.jp. [182.251.133.105]) by smtp.gmail.com with ESMTPSA id x22sm24089547pgc.2.2019.12.23.08.55.09 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 23 Dec 2019 08:55:19 -0800 (PST) In-Reply-To: <01B655FC-51F0-4A33-ADBF-3E1268E9E0EA@gmail.com> X-Mailer: Apple Mail (2.3608.40.2.2.4) X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2607:f8b0:4864:20::444 X-BeenThere: help-texinfo@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Users list for the Texinfo documentation system List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-texinfo-bounces+gnu-help-texinfo2=m.gmane.org@gnu.org Original-Sender: "help-texinfo" Xref: news.gmane.org gmane.comp.tex.texinfo.general:2317 gmane.emacs.devel:243589 Archived-At: 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-Functio= ns.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/emac= s.css 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. Maybe something like:
Command: find-file filename &optional wildcards
Also, examples should have similar tagging: @smallexample (switch-to-buffer (find-file-noselect filename nil nil wildcards)) @end smallexample could be something like=20 @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. Jean-Christophe=20 > On Jun 7, 2017, at 23:27, Jean-Christophe Helary = wrote: >=20 >=20 >> Jun 7, 2017 8:47=E3=80=81Jean-Christophe Helary = =E3=81=AE=E3=83=A1=E3=83=BC=E3=83=AB: >>=20 >>>> What I did to get the same CSS as the site is curl the css files. = There are 3 of those: >>>> https://www.gnu.org/software/emacs/manual.css >>>> https://www.gnu.org/style.css >>>> https://www.gnu.org/reset.css >>>=20 >>> Each of these files has a licensing problem. I asked FSF staff to = fix >>> the last two, and mailed to emacs-devel about the first. >>>=20 >>> In the meantime, please don't copy any of that code, with or without = changes, >>> to any other file that will be distributed to the public. >>=20 >> CSS is not high level wizardry, maybe it would be simpler to create a = new set of rules for the offline manual ? >=20 > I've created a single css file which renders in a way that's similar = to the web version of the HTML pages (it is not identical though). >=20 > I'd like to know what kind of licence should such a CSS file come = with. >=20 > Jean-Christophe Jean-Christophe Helary ----------------------------------------------- http://mac4translators.blogspot.com @brandelune