Stefan Kangas <stefankangas@HIDDEN>
to control <at> debbugs.gnu.org.
Full text available.
Received: (at 73425) by debbugs.gnu.org; 26 Sep 2024 20:11:36 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Thu Sep 26 16:11:36 2024
Received: from localhost ([127.0.0.1]:51900 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1stupr-0002Li-0I
for submit <at> debbugs.gnu.org; Thu, 26 Sep 2024 16:11:36 -0400
Received: from mailscanner.iro.umontreal.ca ([132.204.25.50]:10950)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <monnier@HIDDEN>) id 1stupm-0002LP-4L
for 73425 <at> debbugs.gnu.org; Thu, 26 Sep 2024 16:11:33 -0400
Received: from pmg2.iro.umontreal.ca (localhost.localdomain [127.0.0.1])
by pmg2.iro.umontreal.ca (Proxmox) with ESMTP id 35E658099D;
Thu, 26 Sep 2024 16:10:56 -0400 (EDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=iro.umontreal.ca;
s=mail; t=1727381454;
bh=KzNpQJBl0c5dG2dZp5wu4V+lOKWyuPDQDou1kXY06aQ=;
h=From:To:Cc:Subject:In-Reply-To:References:Date:From;
b=by4WqK6lHZkPR8E4k2LzOTCoYywbZsLT4I757UbQvmD2T1ewycJfFBB8jiEd/2l+H
JC2thFlRUe+pAqInju0jf3tPPwlRFJPyveYe8sGEd2F4ww6jq3gjmFefeWcox9Rz4f
fqYYpzsd4mAi5GM3AEKJqZAwqCr8BQOVrlx3JzGthWL1xvA/WPBQBVOP9nuMftyXAH
w1tgVWAdK/nCwa+7KFMIs/ZzO7ZgtJarfpisp4VR80wErh+8rjBwrVDBR3Uu1eqQc6
+b0xu66Sbqow9T1+sFYcTmbayyHYclhVaDDQAr+gVCQnvxDfEcOsRNQUwTsJ62Mnhl
T0upE9WLBIhDQ==
Received: from mail01.iro.umontreal.ca (unknown [172.31.2.1])
by pmg2.iro.umontreal.ca (Proxmox) with ESMTP id 5087F80781;
Thu, 26 Sep 2024 16:10:54 -0400 (EDT)
Received: from alfajor (modemcable115.250-20-96.mc.videotron.ca
[96.20.250.115])
by mail01.iro.umontreal.ca (Postfix) with ESMTPSA id 193591204C2;
Thu, 26 Sep 2024 16:10:54 -0400 (EDT)
From: Stefan Monnier <monnier@HIDDEN>
To: Stefan Kangas <stefankangas@HIDDEN>
Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA
package manuals
In-Reply-To: <CADwFkmknPrXs2TyodEzxR_dbicDeb31X7y1SVYDLKp8=i6xLMA@HIDDEN>
(Stefan Kangas's message of "Wed, 25 Sep 2024 21:02:45 -0700")
Message-ID: <jwvmsjuw5c8.fsf-monnier+emacs@HIDDEN>
References: <m1msjzlll3.fsf@HIDDEN> <86v7ynh9au.fsf@HIDDEN>
<87h6a78t1t.fsf@HIDDEN> <86ldzjh7vu.fsf@HIDDEN>
<87y13j7djp.fsf@HIDDEN> <86ikunh5kg.fsf@HIDDEN>
<87ldzifxx2.fsf@HIDDEN> <86zfnyfug8.fsf@HIDDEN>
<87ploutu5a.fsf@HIDDEN>
<CADwFkmknPrXs2TyodEzxR_dbicDeb31X7y1SVYDLKp8=i6xLMA@HIDDEN>
Date: Thu, 26 Sep 2024 16:10:53 -0400
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: text/plain
X-SPAM-INFO: Spam detection results: 0
ALL_TRUSTED -1 Passed through trusted hosts only via SMTP
BAYES_00 -1.9 Bayes spam probability is 0 to 1%
DKIM_SIGNED 0.1 Message has a DKIM or DK signature,
not necessarily valid
DKIM_VALID -0.1 Message has at least one valid DKIM or DK signature
DKIM_VALID_AU -0.1 Message has a valid DKIM or DK signature from author's
domain
DKIM_VALID_EF -0.1 Message has a valid DKIM or DK signature from envelope-from
domain
X-SPAM-LEVEL:
X-Spam-Score: -2.3 (--)
X-Debbugs-Envelope-To: 73425
Cc: Philip Kaludercic <philipk@HIDDEN>, me@HIDDEN,
Eli Zaretskii <eliz@HIDDEN>, 73425 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)
>> Yes. My suggestion is to allow listing additional non-.texi/.org files
>> under :doc that would be copied out to the web server. So in Eshel's
>> case, we could update the specification to be
>>
>> (kubed :url "https://git.sr.ht/~eshel/kubed"
>> :doc ("kubed.texi" "images/"))
>>
>> and the HTTP server could host all files under images/.
>
> That has a significant drawback: when package maintainers want to add a
> new image, they have to patch the (Non-)GNU ELPA package listing.
Agreed.
> It would be better to keep that information it in the package itself
> somehow, like we do with .elpaignore. Or we could just copy all image
> files automatically.
I think we should provide a "generic" way to provide some of the
`elpa-packages` contents directly from the package's own files.
I was thinking of something like a
;; ELPA-spec: (:readme "README.md" :doc "clear.texi" ...)
there's a security implication, so we'd need to "sanitize" this info
before using it, but other than that it should not be too hard
to implement.
But to get back to the "real" problem of images: in order for manual
`foo` to be able to have (working) cross-links to manual `bar`, it's
important that they are both exposed as `.../doc/foo.html` and
`.../doc/bar.html`, so they can't both use an image with a relative
URL of `snapshot1.png`.
Stefan
bug-gnu-emacs@HIDDEN:bug#73425; Package emacs.
Full text available.
Received: (at 73425) by debbugs.gnu.org; 26 Sep 2024 04:04:23 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Thu Sep 26 00:04:23 2024
Received: from localhost ([127.0.0.1]:41909 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1stfjq-0003wZ-Tf
for submit <at> debbugs.gnu.org; Thu, 26 Sep 2024 00:04:23 -0400
Received: from mail-lj1-f176.google.com ([209.85.208.176]:48600)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <stefankangas@HIDDEN>) id 1stfjn-0003wJ-Jl
for 73425 <at> debbugs.gnu.org; Thu, 26 Sep 2024 00:04:20 -0400
Received: by mail-lj1-f176.google.com with SMTP id
38308e7fff4ca-2f75c0b78fbso5732411fa.1
for <73425 <at> debbugs.gnu.org>; Wed, 25 Sep 2024 21:03:52 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=gmail.com; s=20230601; t=1727323367; x=1727928167; darn=debbugs.gnu.org;
h=cc:to:subject:message-id:date:mime-version:references:in-reply-to
:from:from:to:cc:subject:date:message-id:reply-to;
bh=SnKaKrbaLJJK64DkMoYsPx2FKdIW2Y7XEmbMJO0IpyY=;
b=JmkjcF6/YK4HKAlwwIrdkdHpiqUVWWe/7dRRzFdDJ9m6+n/8ErmJta4vtNyckHBTiJ
WWDaOI4+53YAPxPBfMIdG6oHwIFDVaptuMJUeCCZbfC2MPRfLsSTPsjyU6dD+cqogD7i
Wh6iDQnfQkEcZsjceMJuvTDHsSo/67OK5cvbZaTLTZMVC2WiEkQ6FWPZoOhUwDgC6Jao
yV/pvSxc5Vy8EsHQvZhwAq1EZQbhswo4Z3feBzMBR86/LTXzOQ0qZ41DX3ILihwxi4Ej
Tf5MO4z/mo2/KQpl3P6lLm/P5S5Yf2nFWNpuJZncGKbG716QLjV2a6Xefkh3ErtNCopV
cBag==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=1e100.net; s=20230601; t=1727323367; x=1727928167;
h=cc:to:subject:message-id:date:mime-version:references:in-reply-to
:from:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to;
bh=SnKaKrbaLJJK64DkMoYsPx2FKdIW2Y7XEmbMJO0IpyY=;
b=MoJ6vWsYxBUtRlcIhNB6NxN00TCy9SNOdXPPFFxlA8VgQp3jRbO43Bf92oca2zPHQX
x91ASohmjUlNeFxD3lvZhz6VBA8A09R/hqdPpW8fNcp3q/eTDxf+0xFqPquDVn8DRLu1
1rqQJhvc0S97RoOkWshdHs+fu9nOgZn7/NLXTiMzOqcqQJCCAFCqdAsokvDjbKR/k5kx
AgSVLqdTNNjQX6wBvb/KvUd1mPZTMUQVLw4n2XfyDw0tEa9AqKyGHflXmFvS9l+0AhBJ
N1oYo6Oy3hq8p6J/1cGMBkUnaeYR0r5K0mjUTsrLstRrG5HWObcFFqOecROckwMOOBY2
gaHA==
X-Gm-Message-State: AOJu0YymKmbHirihT436tKgtD7w5cKkyzClMeC6tFBcd4ErM1TP6Ohn7
9AcvtrK6Bif+c9U4u3CNpJC/XTN1fLV7LCwbqGkaHa1PQkeD1tTM0vpLlYLAxb0UugXfkuwBUhb
ZWjZIN/hR3b1ZVnd7rXNjWFijn1w=
X-Google-Smtp-Source: AGHT+IE0fImr0GrsN/thx//3fFwGcvNE5e5HkzIjjixa1vhVYSj/W1eWlX7m2/iZlCm+1jg4aRe1IWXMi44NTvAB24Y=
X-Received: by 2002:a05:6512:1313:b0:536:568f:c5ed with SMTP id
2adb3069b0e04-53873455efemr3013606e87.1.1727323366460; Wed, 25 Sep 2024
21:02:46 -0700 (PDT)
Received: from 753933720722 named unknown by gmailapi.google.com with
HTTPREST; Wed, 25 Sep 2024 21:02:45 -0700
From: Stefan Kangas <stefankangas@HIDDEN>
In-Reply-To: <87ploutu5a.fsf@HIDDEN>
References: <m1msjzlll3.fsf@HIDDEN> <86v7ynh9au.fsf@HIDDEN>
<87h6a78t1t.fsf@HIDDEN> <86ldzjh7vu.fsf@HIDDEN>
<87y13j7djp.fsf@HIDDEN>
<86ikunh5kg.fsf@HIDDEN> <87ldzifxx2.fsf@HIDDEN> <86zfnyfug8.fsf@HIDDEN>
<87ploutu5a.fsf@HIDDEN>
MIME-Version: 1.0
Date: Wed, 25 Sep 2024 21:02:45 -0700
Message-ID: <CADwFkmknPrXs2TyodEzxR_dbicDeb31X7y1SVYDLKp8=i6xLMA@HIDDEN>
Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA
package manuals
To: Philip Kaludercic <philipk@HIDDEN>, Eli Zaretskii <eliz@HIDDEN>
Content-Type: text/plain; charset="UTF-8"
X-Spam-Score: -0.0 (/)
X-Debbugs-Envelope-To: 73425
Cc: 73425 <at> debbugs.gnu.org, me@HIDDEN, monnier@HIDDEN
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.0 (-)
Philip Kaludercic <philipk@HIDDEN> writes:
> Yes. My suggestion is to allow listing additional non-.texi/.org files
> under :doc that would be copied out to the web server. So in Eshel's
> case, we could update the specification to be
>
> (kubed :url "https://git.sr.ht/~eshel/kubed"
> :doc ("kubed.texi" "images/"))
>
> and the HTTP server could host all files under images/.
That has a significant drawback: when package maintainers want to add a
new image, they have to patch the (Non-)GNU ELPA package listing.
It would be better to keep that information it in the package itself
somehow, like we do with .elpaignore. Or we could just copy all image
files automatically.
bug-gnu-emacs@HIDDEN:bug#73425; Package emacs.
Full text available.Received: (at 73425) by debbugs.gnu.org; 23 Sep 2024 14:20:12 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Mon Sep 23 10:20:12 2024 Received: from localhost ([127.0.0.1]:44522 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1ssjvA-0000XI-0J for submit <at> debbugs.gnu.org; Mon, 23 Sep 2024 10:20:12 -0400 Received: from eggs.gnu.org ([209.51.188.92]:48668) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <eliz@HIDDEN>) id 1ssjv7-0000X4-8g for 73425 <at> debbugs.gnu.org; Mon, 23 Sep 2024 10:20:10 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from <eliz@HIDDEN>) id 1ssjud-0002nB-KY; Mon, 23 Sep 2024 10:19:39 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=kKrtLdvVT5ceuqJ1pZ+EX+Zn2USvCTjHZ4yd62R+tMQ=; b=X9lgS8m9+ULy b0WjQaXPowi04YmqbJMJ8c2rGmHmQQHA+uX0EOqgBhGZ/IzgAMlywwtaf/YOskns7CZtC4nsVn38w J/OlkYhL9jOqXrx4H3wKcAThxMjDwTixUUaczSNKRB54k5pLU8P5bhtN9oHSEUxbDUh6U2wB2r7WN q/ZOyrBNWs77N8p/9pMrM5nLjNR1S7Nc/rEEFSguN+nfgwRcTozoWyzaUvWWipC5t0v+DT9p8K0NZ PJrK4VSFbi8bn6ZMA322czeM+SsFuCJZqotSUHjtval9Fq4fRRjQ2ysitA0jHrtmryZ1oJR0wVHl8 WnVJPZUR5FiGwKL5dWc7wA==; Date: Mon, 23 Sep 2024 17:19:30 +0300 Message-Id: <86wmj2fo5p.fsf@HIDDEN> From: Eli Zaretskii <eliz@HIDDEN> To: Philip Kaludercic <philipk@HIDDEN> In-Reply-To: <87ploutu5a.fsf@HIDDEN> (message from Philip Kaludercic on Mon, 23 Sep 2024 12:46:25 +0000) Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals References: <m1msjzlll3.fsf@HIDDEN> <86v7ynh9au.fsf@HIDDEN> <87h6a78t1t.fsf@HIDDEN> <86ldzjh7vu.fsf@HIDDEN> <87y13j7djp.fsf@HIDDEN> <86ikunh5kg.fsf@HIDDEN> <87ldzifxx2.fsf@HIDDEN> <86zfnyfug8.fsf@HIDDEN> <87ploutu5a.fsf@HIDDEN> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 73425 Cc: 73425 <at> debbugs.gnu.org, me@HIDDEN, monnier@HIDDEN X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -3.3 (---) > From: Philip Kaludercic <philipk@HIDDEN> > Cc: me@HIDDEN, 73425 <at> debbugs.gnu.org, monnier@HIDDEN > Date: Mon, 23 Sep 2024 12:46:25 +0000 > > >> Some kind of --embed flag, that would inline images. So instead of > >> generating > >> > >> <img src="/path/to/image.png" /> > >> > >> makeinfo could produce > >> > >> <img src="data:image/png;base64,iVBORw0KGgoAAAANS..." > > > > Ah, apologies for my misunderstanding. No, such inlining is not > > supported by Texinfo for HTML, AFAIK, they only support external image > > files for HTML. (DVI and PDF outputs do embed the image, I believe.) > > What about the Info viewer in Emacs? Same: it displays external image files, given a special control sequence which refers to it.
bug-gnu-emacs@HIDDEN:bug#73425; Package emacs.
Full text available.
Received: (at 73425) by debbugs.gnu.org; 23 Sep 2024 14:00:38 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Mon Sep 23 10:00:37 2024
Received: from localhost ([127.0.0.1]:44491 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1ssjcD-0007yE-Ha
for submit <at> debbugs.gnu.org; Mon, 23 Sep 2024 10:00:37 -0400
Received: from mailscanner.iro.umontreal.ca ([132.204.25.50]:24400)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <monnier@HIDDEN>) id 1ssjc9-0007s4-5R
for 73425 <at> debbugs.gnu.org; Mon, 23 Sep 2024 10:00:36 -0400
Received: from pmg3.iro.umontreal.ca (localhost [127.0.0.1])
by pmg3.iro.umontreal.ca (Proxmox) with ESMTP id B5B694438A9;
Mon, 23 Sep 2024 10:00:03 -0400 (EDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=iro.umontreal.ca;
s=mail; t=1727100002;
bh=GYXyH3DCXhK4tDU8ZkDu82B8PXDym0chiaCxvQNkM/I=;
h=From:To:Cc:Subject:In-Reply-To:References:Date:From;
b=aeT5u6iV1bPtwzASziwNVlW96CXB1dUOguGZspFQkA/EVmJdqw48joQTDUW5olIxB
Q/nNSdCFOKp1UhwWAhXxvDHZPnk+h0lcyGsbHNdKOi0AeXnGg2rgPhAneDlhjRb7I/
2HNLQeF1UUIWJKMWb7WM3heFVNI3WH/dldCNGa8VaFnvbgtx84yUt6z5FffCW+9reD
tg06Y46wjB1fLK7Cm5TOGJJ/Z6Z3dakUHTT6X7WXm4LhrpfEilaWqqjVXm0WoE+m0K
c/tTCzB9j8SPbdcz5SXYS/TkkrzXbD3gPYdZKXoGlL6tCWfqgZQzT3LbY7hLEB2qIU
X/3WyE7dCY7Wg==
Received: from mail01.iro.umontreal.ca (unknown [172.31.2.1])
by pmg3.iro.umontreal.ca (Proxmox) with ESMTP id 23FCD44386E;
Mon, 23 Sep 2024 10:00:02 -0400 (EDT)
Received: from pastel (unknown [45.72.221.103])
by mail01.iro.umontreal.ca (Postfix) with ESMTPSA id E62E41208A5;
Mon, 23 Sep 2024 10:00:01 -0400 (EDT)
From: Stefan Monnier <monnier@HIDDEN>
To: Philip Kaludercic <philipk@HIDDEN>
Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA
package manuals
In-Reply-To: <87ldzifxx2.fsf@HIDDEN> (Philip Kaludercic's message of "Mon,
23 Sep 2024 10:48:41 +0000")
Message-ID: <jwvmsjy4gt8.fsf-monnier+emacs@HIDDEN>
References: <m1msjzlll3.fsf@HIDDEN> <86v7ynh9au.fsf@HIDDEN>
<87h6a78t1t.fsf@HIDDEN> <86ldzjh7vu.fsf@HIDDEN>
<87y13j7djp.fsf@HIDDEN> <86ikunh5kg.fsf@HIDDEN>
<87ldzifxx2.fsf@HIDDEN>
Date: Mon, 23 Sep 2024 10:00:00 -0400
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: text/plain
X-SPAM-INFO: Spam detection results: 0
ALL_TRUSTED -1 Passed through trusted hosts only via SMTP
AWL -0.154 Adjusted score from AWL reputation of From: address
BAYES_00 -1.9 Bayes spam probability is 0 to 1%
DKIM_SIGNED 0.1 Message has a DKIM or DK signature,
not necessarily valid
DKIM_VALID -0.1 Message has at least one valid DKIM or DK signature
DKIM_VALID_AU -0.1 Message has a valid DKIM or DK signature from author's
domain
DKIM_VALID_EF -0.1 Message has a valid DKIM or DK signature from envelope-from
domain
X-SPAM-LEVEL:
X-Spam-Score: -2.3 (--)
X-Debbugs-Envelope-To: 73425
Cc: Eli Zaretskii <eliz@HIDDEN>, me@HIDDEN, 73425 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)
>> How do we generate these HTML files from the Texinfo sources?
>
> Basically by executing,
>
> --8<---------------cut here---------------start------------->8---
> makeinfo --no-split [input-name] -o [output-name] --html --css-ref=[css-url]
> --8<---------------cut here---------------end--------------->8---
>
>>> plus the manual under https://elpa.gnu.org/packages/doc/[package name]
>>
>> So we have the HTML docs in two places? Why two? And why do I see
>> both https://elpa.gnu.org/packages/doc/compat.html and
>> https://elpa.gnu.org/packages/doc/compat/compat.html?
>
> I am not sure, my suspicion is some kind of historical backwards
> compatibility. I have CC'ed Stefan who might know more.
On disk, this is only one place: the `doc/compat.html` is a symlink to
`doc/compat/compat.html`. The only URL we want to expose is
the `doc/compat.html`, OTOH (which is why `doc/compat.html` is a symlink
rather than an HTTP redirect).
The reason is the following:
- We put all the generated files into the `doc/PKG/` subdir so we know
which files belong to which package when we need to "garbage collect"
old files when updating a package.
- We need to the URL to be `doc/compat.html` (i.e. include only the
manual name but not the package name) so that links from one
manual to the other work correctly regardless if the other manual
belongs to the same package or not.
Stefan
bug-gnu-emacs@HIDDEN:bug#73425; Package emacs.
Full text available.
Received: (at 73425) by debbugs.gnu.org; 23 Sep 2024 12:47:01 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Mon Sep 23 08:47:01 2024
Received: from localhost ([127.0.0.1]:43463 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1ssiSy-0003Yg-N2
for submit <at> debbugs.gnu.org; Mon, 23 Sep 2024 08:47:01 -0400
Received: from mout02.posteo.de ([185.67.36.66]:55667)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <philipk@HIDDEN>) id 1ssiSw-0003YR-9j
for 73425 <at> debbugs.gnu.org; Mon, 23 Sep 2024 08:46:59 -0400
Received: from submission (posteo.de [185.67.36.169])
by mout02.posteo.de (Postfix) with ESMTPS id 4A470240101
for <73425 <at> debbugs.gnu.org>; Mon, 23 Sep 2024 14:46:28 +0200 (CEST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017;
t=1727095588; bh=Adsf0AmO0u2LfJ3aaA+f///z3n2rlenMLSmV1YT9HXA=;
h=From:To:Cc:Subject:Autocrypt:OpenPGP:Date:Message-ID:MIME-Version:
Content-Type:From;
b=HmnKgEKKb1hk85XqVXS2osf2iY5xiJBUk5cIYbypOlP5tumyo/DfNGKIqqtv/Lnsr
m67nL+Pb6Q2gTVofdmLu7El/zbeTSnZZJofBtsUmYiAJWT/Ur9T1aqh0OtVfgeTElj
Zclzc6SfcUuSv+aRpY/hOTrrcfQdDMN4ETXfja3ZGDAp333CyzfLaE0KfrTbvYNyjA
ODQwFYt8vPWrlDzlbPDipHN2NRV1Mi/ftw3+jpPXkrX6src3fKKATh02K1qaxxvrpM
cw3U0ZsJMfdGQJuS6+4UqzWTdII+13Uy3y/IAMtAq7/xFSuXn0Uwrt3jqKiwg0JIUt
R1lv0z8CouXxw==
Received: from customer (localhost [127.0.0.1])
by submission (posteo.de) with ESMTPSA id 4XC2mf4D1xz9rxM;
Mon, 23 Sep 2024 14:46:26 +0200 (CEST)
From: Philip Kaludercic <philipk@HIDDEN>
To: Eli Zaretskii <eliz@HIDDEN>
Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA
package manuals
In-Reply-To: <86zfnyfug8.fsf@HIDDEN> (Eli Zaretskii's message of "Mon, 23 Sep
2024 15:03:35 +0300")
References: <m1msjzlll3.fsf@HIDDEN> <86v7ynh9au.fsf@HIDDEN>
<87h6a78t1t.fsf@HIDDEN> <86ldzjh7vu.fsf@HIDDEN>
<87y13j7djp.fsf@HIDDEN> <86ikunh5kg.fsf@HIDDEN>
<87ldzifxx2.fsf@HIDDEN> <86zfnyfug8.fsf@HIDDEN>
Autocrypt: addr=philipk@HIDDEN; keydata=
mDMEZBBQQhYJKwYBBAHaRw8BAQdAHJuofBrfqFh12uQu0Yi7mrl525F28eTmwUDflFNmdui0QlBo
aWxpcCBLYWx1ZGVyY2ljIChnZW5lcmF0ZWQgYnkgYXV0b2NyeXB0LmVsKSA8cGhpbGlwa0Bwb3N0
ZW8ubmV0PoiWBBMWCAA+FiEEDg7HY17ghYlni8XN8xYDWXahwukFAmQQUEICGwMFCQHhM4AFCwkI
BwIGFQoJCAsCBBYCAwECHgECF4AACgkQ8xYDWXahwulikAEA77hloUiSrXgFkUVJhlKBpLCHUjA0
mWZ9j9w5d08+jVwBAK6c4iGP7j+/PhbkxaEKa4V3MzIl7zJkcNNjHCXmvFcEuDgEZBBQQhIKKwYB
BAGXVQEFAQEHQI5NLiLRjZy3OfSt1dhCmFyn+fN/QKELUYQetiaoe+MMAwEIB4h+BBgWCAAmFiEE
Dg7HY17ghYlni8XN8xYDWXahwukFAmQQUEICGwwFCQHhM4AACgkQ8xYDWXahwukm+wEA8cml4JpK
NeAu65rg+auKrPOP6TP/4YWRCTIvuYDm0joBALw98AMz7/qMHvSCeU/hw9PL6u6R2EScxtpKnWof
z4oM
OpenPGP: id=philipk@HIDDEN;
url="https://keys.openpgp.org/vks/v1/by-email/philipk@HIDDEN";
preference=signencrypt
Date: Mon, 23 Sep 2024 12:46:25 +0000
Message-ID: <87ploutu5a.fsf@HIDDEN>
MIME-Version: 1.0
Content-Type: text/plain
X-Spam-Score: -2.3 (--)
X-Debbugs-Envelope-To: 73425
Cc: 73425 <at> debbugs.gnu.org, me@HIDDEN, monnier@HIDDEN
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)
Eli Zaretskii <eliz@HIDDEN> writes:
>> From: Philip Kaludercic <philipk@HIDDEN>
>> Cc: me@HIDDEN, 73425 <at> debbugs.gnu.org, "Stefan Monnier"
>> <monnier@HIDDEN>
>> Date: Mon, 23 Sep 2024 10:48:41 +0000
>>
>> Eli Zaretskii <eliz@HIDDEN> writes:
>>
>> > Then the image files should be in the same directory (or in its
>> > images/ subdirectory, but that would need to be coordinated with the
>> > package developers).
>>
>> Right, and we can facilitate this by allowing package specifications to
>> annotate where images are found.
>>
>> > How do we generate these HTML files from the Texinfo sources?
>>
>> Basically by executing,
>>
>> --8<---------------cut here---------------start------------->8---
>> makeinfo --no-split [input-name] -o [output-name] --html --css-ref=[css-url]
>> --8<---------------cut here---------------end--------------->8---
>>
>> >> plus the manual under https://elpa.gnu.org/packages/doc/[package name]
>> >
>> > So we have the HTML docs in two places? Why two? And why do I see
>> > both https://elpa.gnu.org/packages/doc/compat.html and
>> > https://elpa.gnu.org/packages/doc/compat/compat.html?
>>
>> I am not sure, my suspicion is some kind of historical backwards
>> compatibility. I have CC'ed Stefan who might know more.
>>
>> > In any case, what I propose is to have the image files right near the
>> > HTML files which reference them.
>>
>> That would make sense.
>
> OK, so we agree. I guess what's left is to somehow make sure this all
> does indeed happen?
Yes. My suggestion is to allow listing additional non-.texi/.org files
under :doc that would be copied out to the web server. So in Eshel's
case, we could update the specification to be
(kubed :url "https://git.sr.ht/~eshel/kubed"
:doc ("kubed.texi" "images/"))
and the HTTP server could host all files under images/.
>> >> >> Do you know if TeXinfo has an option to inline images? If the
>> >> >> "makeinfo" command could somehow generate data: urls when exporting
>> >> >> images, then this could be very easily solved.
>> >> >
>> >> > This is already supported, for a long time, both in Info and HTML
>> >> > formats (and in other formats as well; see the node "Image Syntax" in
>> >> > the Texinfo manual.
>> >>
>> >> I did take a look at that node, but I couldn't find anything that would
>> >> help me.
>> >
>> > ??? What are you looking for that is not there?
>>
>> Some kind of --embed flag, that would inline images. So instead of
>> generating
>>
>> <img src="/path/to/image.png" />
>>
>> makeinfo could produce
>>
>> <img src="data:image/png;base64,iVBORw0KGgoAAAANS..."
>
> Ah, apologies for my misunderstanding. No, such inlining is not
> supported by Texinfo for HTML, AFAIK, they only support external image
> files for HTML. (DVI and PDF outputs do embed the image, I believe.)
What about the Info viewer in Emacs?
--
Philip Kaludercic on siskin
bug-gnu-emacs@HIDDEN:bug#73425; Package emacs.
Full text available.Received: (at 73425) by debbugs.gnu.org; 23 Sep 2024 12:04:11 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Mon Sep 23 08:04:11 2024 Received: from localhost ([127.0.0.1]:43399 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1sshnX-00017p-2Q for submit <at> debbugs.gnu.org; Mon, 23 Sep 2024 08:04:11 -0400 Received: from eggs.gnu.org ([209.51.188.92]:41298) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <eliz@HIDDEN>) id 1sshnU-00017W-SE for 73425 <at> debbugs.gnu.org; Mon, 23 Sep 2024 08:04:09 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from <eliz@HIDDEN>) id 1sshn0-00010f-4M; Mon, 23 Sep 2024 08:03:38 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=VC3gfTf332gxOqGvvXxDgvEGwXjRpLO2qFOM14nu+3Q=; b=FyC5QHYQqOhP u5sadX2ghb0Ojy+zKxOVMjEn6wCI8ZE5N7gY8LfVAJOfPwMwIY0OxR5ZM+n6MUGrqimnDoNODRprp dDD7+PwaYpIta09ev9v++E/iqcJ8RjC3yQgk95uuG/frty7Bc1JhbPpkgsmjKaGQx7BrolKFvv5aj LkrMMc3FrNkiKJjEBHXQDR9fRf8cKK3nZIhsVNtJhvEWHbJpRKoYwjbbQyHsJ/OLHj4xHqa1hgYZs jt7va54hJmXmcEsbaG3OEx6QstNvRd3VvSl1yohgxVv3k/Mchw8RRqdKTgNIaev8WnRw67inyERji 3gKTp01nWUp6bCX45PZe4w==; Date: Mon, 23 Sep 2024 15:03:35 +0300 Message-Id: <86zfnyfug8.fsf@HIDDEN> From: Eli Zaretskii <eliz@HIDDEN> To: Philip Kaludercic <philipk@HIDDEN> In-Reply-To: <87ldzifxx2.fsf@HIDDEN> (message from Philip Kaludercic on Mon, 23 Sep 2024 10:48:41 +0000) Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals References: <m1msjzlll3.fsf@HIDDEN> <86v7ynh9au.fsf@HIDDEN> <87h6a78t1t.fsf@HIDDEN> <86ldzjh7vu.fsf@HIDDEN> <87y13j7djp.fsf@HIDDEN> <86ikunh5kg.fsf@HIDDEN> <87ldzifxx2.fsf@HIDDEN> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 73425 Cc: 73425 <at> debbugs.gnu.org, me@HIDDEN, monnier@HIDDEN X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -3.3 (---) > From: Philip Kaludercic <philipk@HIDDEN> > Cc: me@HIDDEN, 73425 <at> debbugs.gnu.org, "Stefan Monnier" > <monnier@HIDDEN> > Date: Mon, 23 Sep 2024 10:48:41 +0000 > > Eli Zaretskii <eliz@HIDDEN> writes: > > > Then the image files should be in the same directory (or in its > > images/ subdirectory, but that would need to be coordinated with the > > package developers). > > Right, and we can facilitate this by allowing package specifications to > annotate where images are found. > > > How do we generate these HTML files from the Texinfo sources? > > Basically by executing, > > --8<---------------cut here---------------start------------->8--- > makeinfo --no-split [input-name] -o [output-name] --html --css-ref=[css-url] > --8<---------------cut here---------------end--------------->8--- > > >> plus the manual under https://elpa.gnu.org/packages/doc/[package name] > > > > So we have the HTML docs in two places? Why two? And why do I see > > both https://elpa.gnu.org/packages/doc/compat.html and > > https://elpa.gnu.org/packages/doc/compat/compat.html? > > I am not sure, my suspicion is some kind of historical backwards > compatibility. I have CC'ed Stefan who might know more. > > > In any case, what I propose is to have the image files right near the > > HTML files which reference them. > > That would make sense. OK, so we agree. I guess what's left is to somehow make sure this all does indeed happen? > >> >> Do you know if TeXinfo has an option to inline images? If the > >> >> "makeinfo" command could somehow generate data: urls when exporting > >> >> images, then this could be very easily solved. > >> > > >> > This is already supported, for a long time, both in Info and HTML > >> > formats (and in other formats as well; see the node "Image Syntax" in > >> > the Texinfo manual. > >> > >> I did take a look at that node, but I couldn't find anything that would > >> help me. > > > > ??? What are you looking for that is not there? > > Some kind of --embed flag, that would inline images. So instead of > generating > > <img src="/path/to/image.png" /> > > makeinfo could produce > > <img src="data:image/png;base64,iVBORw0KGgoAAAANS..." Ah, apologies for my misunderstanding. No, such inlining is not supported by Texinfo for HTML, AFAIK, they only support external image files for HTML. (DVI and PDF outputs do embed the image, I believe.)
bug-gnu-emacs@HIDDEN:bug#73425; Package emacs.
Full text available.Received: (at 73425) by debbugs.gnu.org; 23 Sep 2024 10:49:17 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Mon Sep 23 06:49:17 2024 Received: from localhost ([127.0.0.1]:43256 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1ssgd3-0005H1-4t for submit <at> debbugs.gnu.org; Mon, 23 Sep 2024 06:49:17 -0400 Received: from mout01.posteo.de ([185.67.36.65]:36403) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <philipk@HIDDEN>) id 1ssgcz-0005Gj-C2 for 73425 <at> debbugs.gnu.org; Mon, 23 Sep 2024 06:49:15 -0400 Received: from submission (posteo.de [185.67.36.169]) by mout01.posteo.de (Postfix) with ESMTPS id 92CE2240028 for <73425 <at> debbugs.gnu.org>; Mon, 23 Sep 2024 12:48:42 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1727088523; bh=VeEuYqhQZeR0OCEpe5hwfcpNvAm4xzFMZGvSySYqugU=; h=From:To:Cc:Subject:Autocrypt:OpenPGP:Date:Message-ID:MIME-Version: Content-Type:From; b=lBtpmBRzvlJTh2yFNtBOFvqUS4HCybbOC+YlBu7iZs+Fy9Xg4eYZsXDw9VIHhldsY 4wo3NW0H3D9SbM7uVT9kQSmmLV1lp+bmFykWyKPw3XxPY1rCeODme+k34cDuy/TKv8 HG0cZ8/jkGNiVDCOaOxMMqthji5KDExkywmir4O9pSSCpBq61dh1merwqUGzSERGsB eQd/Wxv0vPzui9lSJ/zzqBubG0XS60U+xMX5XkWVlgtWYBXm0NaewTH+vqTs+sVzDN 9n8zl8Sv1PJ5wapkEG9Lpi/aLW5oKwvpKSbPXw8dBmNH+SvWveEd3XLs87BKTVBjFf 2crs/+XRJ8nMg== Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4XC08n4XjWz6tvJ; Mon, 23 Sep 2024 12:48:41 +0200 (CEST) From: Philip Kaludercic <philipk@HIDDEN> To: Eli Zaretskii <eliz@HIDDEN> Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: <86ikunh5kg.fsf@HIDDEN> (Eli Zaretskii's message of "Sun, 22 Sep 2024 22:05:51 +0300") References: <m1msjzlll3.fsf@HIDDEN> <86v7ynh9au.fsf@HIDDEN> <87h6a78t1t.fsf@HIDDEN> <86ldzjh7vu.fsf@HIDDEN> <87y13j7djp.fsf@HIDDEN> <86ikunh5kg.fsf@HIDDEN> Autocrypt: addr=philipk@HIDDEN; keydata= mDMEZBBQQhYJKwYBBAHaRw8BAQdAHJuofBrfqFh12uQu0Yi7mrl525F28eTmwUDflFNmdui0QlBo aWxpcCBLYWx1ZGVyY2ljIChnZW5lcmF0ZWQgYnkgYXV0b2NyeXB0LmVsKSA8cGhpbGlwa0Bwb3N0 ZW8ubmV0PoiWBBMWCAA+FiEEDg7HY17ghYlni8XN8xYDWXahwukFAmQQUEICGwMFCQHhM4AFCwkI BwIGFQoJCAsCBBYCAwECHgECF4AACgkQ8xYDWXahwulikAEA77hloUiSrXgFkUVJhlKBpLCHUjA0 mWZ9j9w5d08+jVwBAK6c4iGP7j+/PhbkxaEKa4V3MzIl7zJkcNNjHCXmvFcEuDgEZBBQQhIKKwYB BAGXVQEFAQEHQI5NLiLRjZy3OfSt1dhCmFyn+fN/QKELUYQetiaoe+MMAwEIB4h+BBgWCAAmFiEE Dg7HY17ghYlni8XN8xYDWXahwukFAmQQUEICGwwFCQHhM4AACgkQ8xYDWXahwukm+wEA8cml4JpK NeAu65rg+auKrPOP6TP/4YWRCTIvuYDm0joBALw98AMz7/qMHvSCeU/hw9PL6u6R2EScxtpKnWof z4oM OpenPGP: id=philipk@HIDDEN; url="https://keys.openpgp.org/vks/v1/by-email/philipk@HIDDEN"; preference=signencrypt Date: Mon, 23 Sep 2024 10:48:41 +0000 Message-ID: <87ldzifxx2.fsf@HIDDEN> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 73425 Cc: 73425 <at> debbugs.gnu.org, me@HIDDEN, Stefan Monnier <monnier@HIDDEN> X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -3.3 (---) Eli Zaretskii <eliz@HIDDEN> writes: >> From: Philip Kaludercic <philipk@HIDDEN> >> Cc: me@HIDDEN, 73425 <at> debbugs.gnu.org >> Date: Sun, 22 Sep 2024 18:23:38 +0000 >> >> Eli Zaretskii <eliz@HIDDEN> writes: >> >> >> What we need is some kind of an indication in the package specification, >> >> what files should be copied out for the manual to access, as otherwise >> >> the images would only be hidden in the package tarball, that a web >> >> browser cannot access (AFAIK). >> > >> > "Copied" where and why? Aren't the HTML docs generated in the >> > package's tree, like the Info docs? >> >> No, these are the files we generate for a package under >> https://elpa.gnu.org/packages: >> >> -rw-r--r-- 1 phi phi 368640 Mar 22 2024 compat-29.1.4.5.tar >> -rw-r--r-- 1 phi phi 11183 Mar 22 2024 compat.html >> -rw-r--r-- 1 phi phi 997 Mar 22 2024 compat-readme.txt >> -rw-r--r-- 1 phi phi 1230 Mar 22 2024 compat.svg >> lrwxrwxrwx 1 phi phi 19 Mar 22 2024 compat.tar -> compat-29.1.4.5.tar >> -rw-r--r-- 1 phi phi 1016 Mar 22 2024 compat.xml > > Then the image files should be in the same directory (or in its > images/ subdirectory, but that would need to be coordinated with the > package developers). Right, and we can facilitate this by allowing package specifications to annotate where images are found. > How do we generate these HTML files from the Texinfo sources? Basically by executing, --8<---------------cut here---------------start------------->8--- makeinfo --no-split [input-name] -o [output-name] --html --css-ref=[css-url] --8<---------------cut here---------------end--------------->8--- >> plus the manual under https://elpa.gnu.org/packages/doc/[package name] > > So we have the HTML docs in two places? Why two? And why do I see > both https://elpa.gnu.org/packages/doc/compat.html and > https://elpa.gnu.org/packages/doc/compat/compat.html? I am not sure, my suspicion is some kind of historical backwards compatibility. I have CC'ed Stefan who might know more. > In any case, what I propose is to have the image files right near the > HTML files which reference them. That would make sense. >> >> Do you know if TeXinfo has an option to inline images? If the >> >> "makeinfo" command could somehow generate data: urls when exporting >> >> images, then this could be very easily solved. >> > >> > This is already supported, for a long time, both in Info and HTML >> > formats (and in other formats as well; see the node "Image Syntax" in >> > the Texinfo manual. >> >> I did take a look at that node, but I couldn't find anything that would >> help me. > > ??? What are you looking for that is not there? Some kind of --embed flag, that would inline images. So instead of generating <img src="/path/to/image.png" /> makeinfo could produce <img src="data:image/png;base64,iVBORw0KGgoAAAANS..." -- Philip Kaludercic on siskin
bug-gnu-emacs@HIDDEN:bug#73425; Package emacs.
Full text available.Received: (at 73425) by debbugs.gnu.org; 22 Sep 2024 19:06:33 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Sun Sep 22 15:06:33 2024 Received: from localhost ([127.0.0.1]:42763 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1ssRuj-0004Vo-9c for submit <at> debbugs.gnu.org; Sun, 22 Sep 2024 15:06:33 -0400 Received: from eggs.gnu.org ([209.51.188.92]:49370) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <eliz@HIDDEN>) id 1ssRue-0004VS-F8 for 73425 <at> debbugs.gnu.org; Sun, 22 Sep 2024 15:06:31 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from <eliz@HIDDEN>) id 1ssRuA-00078g-TW; Sun, 22 Sep 2024 15:05:59 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=j5vE/sSdLJXdhc3BKtegq+2Bgko9aRRkHitYuAU3BxA=; b=FaYDGHNgI/dw T8TUk8ZsV4aVFdgdqP2Mi1fWzibkHhKHmTetEeR2IyjKaygZ1b5nLYlpMkMhcNsylSigv/vJy800a QDAefbgDb+1+WMlmh1jRZAb/+d5g2V2IHC9lL2qgG/Yc/jnyVLiWvfiwpkIEbTpfdVWcdyiOshe2Y tzuJDgFoYeOY1njq2Fo79/MgjmXpUzND5FQ3Gtfqybgvxkqy6elWfu1gdRyxEDyg2aLPgCWiAjg0p aVN/N7YwCnZU7b/StCxmUo7Ax/1tr4Q9OxIBcsAUHwgJ+HgGJNCmZt/Pm0LJKBeKmHQze5AykboIE YQttjUdS4hNiNVX8QkOigQ==; Date: Sun, 22 Sep 2024 22:05:51 +0300 Message-Id: <86ikunh5kg.fsf@HIDDEN> From: Eli Zaretskii <eliz@HIDDEN> To: Philip Kaludercic <philipk@HIDDEN> In-Reply-To: <87y13j7djp.fsf@HIDDEN> (message from Philip Kaludercic on Sun, 22 Sep 2024 18:23:38 +0000) Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals References: <m1msjzlll3.fsf@HIDDEN> <86v7ynh9au.fsf@HIDDEN> <87h6a78t1t.fsf@HIDDEN> <86ldzjh7vu.fsf@HIDDEN> <87y13j7djp.fsf@HIDDEN> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 73425 Cc: 73425 <at> debbugs.gnu.org, me@HIDDEN X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -3.3 (---) > From: Philip Kaludercic <philipk@HIDDEN> > Cc: me@HIDDEN, 73425 <at> debbugs.gnu.org > Date: Sun, 22 Sep 2024 18:23:38 +0000 > > Eli Zaretskii <eliz@HIDDEN> writes: > > >> What we need is some kind of an indication in the package specification, > >> what files should be copied out for the manual to access, as otherwise > >> the images would only be hidden in the package tarball, that a web > >> browser cannot access (AFAIK). > > > > "Copied" where and why? Aren't the HTML docs generated in the > > package's tree, like the Info docs? > > No, these are the files we generate for a package under > https://elpa.gnu.org/packages: > > -rw-r--r-- 1 phi phi 368640 Mar 22 2024 compat-29.1.4.5.tar > -rw-r--r-- 1 phi phi 11183 Mar 22 2024 compat.html > -rw-r--r-- 1 phi phi 997 Mar 22 2024 compat-readme.txt > -rw-r--r-- 1 phi phi 1230 Mar 22 2024 compat.svg > lrwxrwxrwx 1 phi phi 19 Mar 22 2024 compat.tar -> compat-29.1.4.5.tar > -rw-r--r-- 1 phi phi 1016 Mar 22 2024 compat.xml Then the image files should be in the same directory (or in its images/ subdirectory, but that would need to be coordinated with the package developers). How do we generate these HTML files from the Texinfo sources? > plus the manual under https://elpa.gnu.org/packages/doc/[package name] So we have the HTML docs in two places? Why two? And why do I see both https://elpa.gnu.org/packages/doc/compat.html and https://elpa.gnu.org/packages/doc/compat/compat.html? In any case, what I propose is to have the image files right near the HTML files which reference them. > >> Do you know if TeXinfo has an option to inline images? If the > >> "makeinfo" command could somehow generate data: urls when exporting > >> images, then this could be very easily solved. > > > > This is already supported, for a long time, both in Info and HTML > > formats (and in other formats as well; see the node "Image Syntax" in > > the Texinfo manual. > > I did take a look at that node, but I couldn't find anything that would > help me. ??? What are you looking for that is not there?
bug-gnu-emacs@HIDDEN:bug#73425; Package emacs.
Full text available.Received: (at 73425) by debbugs.gnu.org; 22 Sep 2024 18:44:26 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Sun Sep 22 14:44:26 2024 Received: from localhost ([127.0.0.1]:42753 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1ssRZJ-0003GF-SF for submit <at> debbugs.gnu.org; Sun, 22 Sep 2024 14:44:26 -0400 Received: from mail.eshelyaron.com ([107.175.124.16]:53920 helo=eshelyaron.com) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <me@HIDDEN>) id 1ssRZH-0003G2-DS for 73425 <at> debbugs.gnu.org; Sun, 22 Sep 2024 14:44:25 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=eshelyaron.com; s=mail; t=1727030640; bh=FoJelv6AgfJcAfklIccoRU7TF41TVwkFuF66FaVbiV4=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=rcckG7QTlLoKUVQfmHKYYGLlwbc7ZCGXSEJqiNJPQ+8OxOK9GmkKL67OHvE1dWUYR laV1pOCT8J7OgQiFJrdSYjKdHWRk+7kOqUAgg+VKYj9LfCu+aOyp3xIbK8hMehQOjI 5fZdt/XPuKh/qgKRVtZTd9WE5TiCIsAxcr8Rap6jAWejwCfv/U8N5DUUlriWAeXIgQ Z264KEoXesJFt8N/GWoXWSdhdGbrl5AnoWLsDMgmNjVcL48pE+nS7eqRiH3GbYJrco MYojHF+1lUbxS0DAh/FBYhhou3fMYYMs2dOomEcil8tm7Cica9up2UNSe6CKrMczCN HpzL3a4QAcjLQ== From: Eshel Yaron <me@HIDDEN> To: Philip Kaludercic <philipk@HIDDEN> Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: <8734lr8sfn.fsf@HIDDEN> (Philip Kaludercic's message of "Sun, 22 Sep 2024 18:16:44 +0000") References: <m1msjzlll3.fsf@HIDDEN> <86v7ynh9au.fsf@HIDDEN> <87h6a78t1t.fsf@HIDDEN> <m1r09bsgin.fsf@HIDDEN> <8734lr8sfn.fsf@HIDDEN> Date: Sun, 22 Sep 2024 20:43:56 +0200 Message-ID: <m1msjzsf4j.fsf@HIDDEN> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 73425 Cc: Eli Zaretskii <eliz@HIDDEN>, 73425 <at> debbugs.gnu.org X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -1.0 (-) Philip Kaludercic <philipk@HIDDEN> writes: > Eshel Yaron <me@HIDDEN> writes: > >> Philip Kaludercic <philipk@HIDDEN> writes: >> >>> Do you know if TeXinfo has an option to inline images? If the >>> "makeinfo" command could somehow generate data: urls when exporting >>> images, then this could be very easily solved. >> >> I'm not aware of such an option. BTW, which version of Texinfo does the >> ELPA server run? > > $ ssh elpa makeinfo --version > texi2any (GNU texinfo) 6.8 > > Copyright (C) 2021 Free Software Foundation, Inc. > License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html> > This is free software: you are free to change and redistribute it. > There is NO WARRANTY, to the extent permitted by law. > > I.e. the version distributed by Debian stable. Good to know, thanks!
bug-gnu-emacs@HIDDEN:bug#73425; Package emacs.
Full text available.Received: (at 73425) by debbugs.gnu.org; 22 Sep 2024 18:24:11 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Sun Sep 22 14:24:11 2024 Received: from localhost ([127.0.0.1]:42748 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1ssRFi-0002Bb-O7 for submit <at> debbugs.gnu.org; Sun, 22 Sep 2024 14:24:11 -0400 Received: from mout01.posteo.de ([185.67.36.65]:41271) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <philipk@HIDDEN>) id 1ssRFf-0002B0-9O for 73425 <at> debbugs.gnu.org; Sun, 22 Sep 2024 14:24:08 -0400 Received: from submission (posteo.de [185.67.36.169]) by mout01.posteo.de (Postfix) with ESMTPS id 54DD4240028 for <73425 <at> debbugs.gnu.org>; Sun, 22 Sep 2024 20:23:39 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1727029419; bh=DY+LRCMwXIxzSbeJgmx12ZPTMg2XEuR6r0TSoa7cnfg=; h=From:To:Cc:Subject:Autocrypt:OpenPGP:Date:Message-ID:MIME-Version: Content-Type:From; b=pgYk00t9cPbu9zw0Px4wxGT+4WNHlbXSybn0UETS3ZHnyht91nyCxkPYdBqUimkoQ w1zkbtIchLYHdwKTjxGZcyqFnyPkVONn3zjoKHQvWKpX16Knsu13K/3izS2v7gZeZd i2xLuTLzD5YoSbdglcnJaimSqHOzYutdozzFapH9SH0sy72hmjwtPobSIKPQwF+8t1 tbjW35780ADzwpIrXO2506Y7rszb4Bct3fjEnCMAFT2gMWdrk2TOtUDfrQdJZLwfei bUrzsOGJhsa3ldvAPtuxXMODpRvQ7FjoVX1H2rN0L/yMPKS7qWF0I2Uq7qTjjLtp10 ea1mnWBgKR84Q== Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4XBZJB6Txkz6tyK; Sun, 22 Sep 2024 20:23:38 +0200 (CEST) From: Philip Kaludercic <philipk@HIDDEN> To: Eli Zaretskii <eliz@HIDDEN> Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: <86ldzjh7vu.fsf@HIDDEN> (Eli Zaretskii's message of "Sun, 22 Sep 2024 21:15:49 +0300") References: <m1msjzlll3.fsf@HIDDEN> <86v7ynh9au.fsf@HIDDEN> <87h6a78t1t.fsf@HIDDEN> <86ldzjh7vu.fsf@HIDDEN> Autocrypt: addr=philipk@HIDDEN; keydata= mDMEZBBQQhYJKwYBBAHaRw8BAQdAHJuofBrfqFh12uQu0Yi7mrl525F28eTmwUDflFNmdui0QlBo aWxpcCBLYWx1ZGVyY2ljIChnZW5lcmF0ZWQgYnkgYXV0b2NyeXB0LmVsKSA8cGhpbGlwa0Bwb3N0 ZW8ubmV0PoiWBBMWCAA+FiEEDg7HY17ghYlni8XN8xYDWXahwukFAmQQUEICGwMFCQHhM4AFCwkI BwIGFQoJCAsCBBYCAwECHgECF4AACgkQ8xYDWXahwulikAEA77hloUiSrXgFkUVJhlKBpLCHUjA0 mWZ9j9w5d08+jVwBAK6c4iGP7j+/PhbkxaEKa4V3MzIl7zJkcNNjHCXmvFcEuDgEZBBQQhIKKwYB BAGXVQEFAQEHQI5NLiLRjZy3OfSt1dhCmFyn+fN/QKELUYQetiaoe+MMAwEIB4h+BBgWCAAmFiEE Dg7HY17ghYlni8XN8xYDWXahwukFAmQQUEICGwwFCQHhM4AACgkQ8xYDWXahwukm+wEA8cml4JpK NeAu65rg+auKrPOP6TP/4YWRCTIvuYDm0joBALw98AMz7/qMHvSCeU/hw9PL6u6R2EScxtpKnWof z4oM OpenPGP: id=7126E1DE2F0CE35C770BED01F2C3CC513DB89F66; url="https://keys.openpgp.org/vks/v1/by-fingerprint/7126E1DE2F0CE35C770BED01F2C3CC513DB89F66"; preference=signencrypt Date: Sun, 22 Sep 2024 18:23:38 +0000 Message-ID: <87y13j7djp.fsf@HIDDEN> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 73425 Cc: 73425 <at> debbugs.gnu.org, me@HIDDEN X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -3.3 (---) Eli Zaretskii <eliz@HIDDEN> writes: >> From: Philip Kaludercic <philipk@HIDDEN> >> Cc: Eshel Yaron <me@HIDDEN>, 73425 <at> debbugs.gnu.org >> Date: Sun, 22 Sep 2024 18:03:26 +0000 >> >> Eli Zaretskii <eliz@HIDDEN> writes: >> >> >> Cc: Philip Kaludercic <philipk@HIDDEN> >> >> Date: Sun, 22 Sep 2024 18:06:16 +0200 >> >> From: Eshel Yaron via "Bug reports for GNU Emacs, >> >> the Swiss army knife of text editors" <bug-gnu-emacs@HIDDEN> >> >> >> >> I'm opening this feature request following a discussion with Philip >> >> elsewhere: Texinfo manual can include images, but AFAIK (and please >> >> correct me if I'm wrong here) there's currently no way for ELPA packages >> >> to include images in their manuals and have these images appear also in >> >> the HTML version of the manual that the ELPA server builds and serves. >> > >> > Why "no way"? If the image files are present at their filenames as >> > mentioned by the HTML version of the documentation, they will be shown >> > by the browser. >> >> The issue is that when generating the HTML documentation for >> elpa.gnu.org, we don't copy out any files, but just generate the HTML >> version of the manual. >> >> What we need is some kind of an indication in the package specification, >> what files should be copied out for the manual to access, as otherwise >> the images would only be hidden in the package tarball, that a web >> browser cannot access (AFAIK). > > "Copied" where and why? Aren't the HTML docs generated in the > package's tree, like the Info docs? No, these are the files we generate for a package under https://elpa.gnu.org/packages: -rw-r--r-- 1 phi phi 368640 Mar 22 2024 compat-29.1.4.5.tar -rw-r--r-- 1 phi phi 11183 Mar 22 2024 compat.html -rw-r--r-- 1 phi phi 997 Mar 22 2024 compat-readme.txt -rw-r--r-- 1 phi phi 1230 Mar 22 2024 compat.svg lrwxrwxrwx 1 phi phi 19 Mar 22 2024 compat.tar -> compat-29.1.4.5.tar -rw-r--r-- 1 phi phi 1016 Mar 22 2024 compat.xml plus the manual under https://elpa.gnu.org/packages/doc/[package name] -rw-r--r-- 1 phi phi 46640 Mar 21 2024 corfu.html (there is another symlink to this file but that is not important now). Other than that, no files are copied out. >> >> - Include images in the package repository, somehow indicate in the >> >> package specification that the manual refers to these images, and have >> >> the ELPA server keep the images around in a predictable location, so I >> >> can link to it from the manual. >> > >> > I don't understand why this would be needed. Simply include the image >> > files with the package, and the rest should "just work", AFAIU. >> >> Do you know if TeXinfo has an option to inline images? If the >> "makeinfo" command could somehow generate data: urls when exporting >> images, then this could be very easily solved. > > This is already supported, for a long time, both in Info and HTML > formats (and in other formats as well; see the node "Image Syntax" in > the Texinfo manual. I did take a look at that node, but I couldn't find anything that would help me. -- Philip Kaludercic on siskin
bug-gnu-emacs@HIDDEN:bug#73425; Package emacs.
Full text available.Received: (at 73425) by debbugs.gnu.org; 22 Sep 2024 18:17:16 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Sun Sep 22 14:17:16 2024 Received: from localhost ([127.0.0.1]:42743 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1ssR91-0001rl-Li for submit <at> debbugs.gnu.org; Sun, 22 Sep 2024 14:17:16 -0400 Received: from mout02.posteo.de ([185.67.36.66]:54315) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <philipk@HIDDEN>) id 1ssR90-0001rY-2l for 73425 <at> debbugs.gnu.org; Sun, 22 Sep 2024 14:17:14 -0400 Received: from submission (posteo.de [185.67.36.169]) by mout02.posteo.de (Postfix) with ESMTPS id 827C4240101 for <73425 <at> debbugs.gnu.org>; Sun, 22 Sep 2024 20:16:46 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1727029006; bh=CFECyzHQOQ9JrQqmvw0PhyRT0wamMgDm51EWGt9IEf8=; h=From:To:Cc:Subject:Autocrypt:OpenPGP:Date:Message-ID:MIME-Version: Content-Type:From; b=HYV7OcIZ4JhkQn3fjdnc8/g/+U1X3lydCBOWpd79L0gsXmQNvup25fFS2idXRaVcd P6zrnIbxfi4x9FEy5BDww6I27NkM+e3JxmoReiy4930w7jNIkRBluoaNYjs+hn/2DI ytkJKpXD9Od8e7Mp9O09O1nkVGr8O58Hf5Tgl4/O99UkKKd4NoV2OHKZd2TS8CQFAt jlr/ioGJjhy5IpyKf0CJn4w8HJ7xXHNVjExzAN43UW1k2Vz7RutffDigtWt68oWe0b k5UO+2aBzAMtlM10wctbnL0Zd8EC/LP86l02/ItW6T6/+rWoUEdufbYUOde4qUB79S rk/OlQjbjuDtQ== Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4XBZ8F2wQ8z9rxD; Sun, 22 Sep 2024 20:16:44 +0200 (CEST) From: Philip Kaludercic <philipk@HIDDEN> To: Eshel Yaron <me@HIDDEN> Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: <m1r09bsgin.fsf@HIDDEN> (Eshel Yaron's message of "Sun, 22 Sep 2024 20:13:52 +0200") References: <m1msjzlll3.fsf@HIDDEN> <86v7ynh9au.fsf@HIDDEN> <87h6a78t1t.fsf@HIDDEN> <m1r09bsgin.fsf@HIDDEN> Autocrypt: addr=philipk@HIDDEN; keydata= mDMEZBBQQhYJKwYBBAHaRw8BAQdAHJuofBrfqFh12uQu0Yi7mrl525F28eTmwUDflFNmdui0QlBo aWxpcCBLYWx1ZGVyY2ljIChnZW5lcmF0ZWQgYnkgYXV0b2NyeXB0LmVsKSA8cGhpbGlwa0Bwb3N0 ZW8ubmV0PoiWBBMWCAA+FiEEDg7HY17ghYlni8XN8xYDWXahwukFAmQQUEICGwMFCQHhM4AFCwkI BwIGFQoJCAsCBBYCAwECHgECF4AACgkQ8xYDWXahwulikAEA77hloUiSrXgFkUVJhlKBpLCHUjA0 mWZ9j9w5d08+jVwBAK6c4iGP7j+/PhbkxaEKa4V3MzIl7zJkcNNjHCXmvFcEuDgEZBBQQhIKKwYB BAGXVQEFAQEHQI5NLiLRjZy3OfSt1dhCmFyn+fN/QKELUYQetiaoe+MMAwEIB4h+BBgWCAAmFiEE Dg7HY17ghYlni8XN8xYDWXahwukFAmQQUEICGwwFCQHhM4AACgkQ8xYDWXahwukm+wEA8cml4JpK NeAu65rg+auKrPOP6TP/4YWRCTIvuYDm0joBALw98AMz7/qMHvSCeU/hw9PL6u6R2EScxtpKnWof z4oM OpenPGP: id=7126E1DE2F0CE35C770BED01F2C3CC513DB89F66; url="https://keys.openpgp.org/vks/v1/by-fingerprint/7126E1DE2F0CE35C770BED01F2C3CC513DB89F66"; preference=signencrypt Date: Sun, 22 Sep 2024 18:16:44 +0000 Message-ID: <8734lr8sfn.fsf@HIDDEN> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 73425 Cc: Eli Zaretskii <eliz@HIDDEN>, 73425 <at> debbugs.gnu.org X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -3.3 (---) Eshel Yaron <me@HIDDEN> writes: > Philip Kaludercic <philipk@HIDDEN> writes: > >> Eli Zaretskii <eliz@HIDDEN> writes: >> >>>> Cc: Philip Kaludercic <philipk@HIDDEN> >>>> Date: Sun, 22 Sep 2024 18:06:16 +0200 >>>> From: Eshel Yaron via "Bug reports for GNU Emacs, >>>> the Swiss army knife of text editors" <bug-gnu-emacs@HIDDEN> >>>> >>>> I'm opening this feature request following a discussion with Philip >>>> elsewhere: Texinfo manual can include images, but AFAIK (and please >>>> correct me if I'm wrong here) there's currently no way for ELPA packages >>>> to include images in their manuals and have these images appear also in >>>> the HTML version of the manual that the ELPA server builds and serves. >>> >>> Why "no way"? If the image files are present at their filenames as >>> mentioned by the HTML version of the documentation, they will be shown >>> by the browser. >> >> The issue is that when generating the HTML documentation for >> elpa.gnu.org, we don't copy out any files, but just generate the HTML >> version of the manual. >> >> What we need is some kind of an indication in the package specification, >> what files should be copied out for the manual to access, as otherwise >> the images would only be hidden in the package tarball, that a web >> browser cannot access (AFAIK). > > Yes. > >>>> An example is my GNU ELPA package Kubed. In the development version, >>>> the manual refers to images which are present on my web server, where I >>>> provide HTML versions[1][2] of the manual. There, the images are >>>> displayed properly. >> >> Unrelated to this issue, have you considered rendering screenshots as >> SVG files using `x-export-frames'? > > I haven't, but I'll be sure to check it out. Thanks for the tip :) > >>>> On the ELPA server[3], OTOH, the images are nowhere >>>> to be found, and we instead get just the alt text and caption. That's >>>> expected, but the alt text is shown with no distinctive styling so the >>>> result seems quite confusing. >>> >>> To show images, your HTML version of the manual should reference local >>> files, not URLs from your some other server. And, of course, the >>> image files should be part of the package tarball. >>> >>>> - Include images in the package repository, somehow indicate in the >>>> package specification that the manual refers to these images, and have >>>> the ELPA server keep the images around in a predictable location, so I >>>> can link to it from the manual. >>> >>> I don't understand why this would be needed. Simply include the image >>> files with the package, and the rest should "just work", AFAIU. >> >> Do you know if TeXinfo has an option to inline images? If the >> "makeinfo" command could somehow generate data: urls when exporting >> images, then this could be very easily solved. > > I'm not aware of such an option. BTW, which version of Texinfo does the > ELPA server run? --8<---------------cut here---------------start------------->8--- $ ssh elpa makeinfo --version texi2any (GNU texinfo) 6.8 Copyright (C) 2021 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html> This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law. --8<---------------cut here---------------end--------------->8--- I.e. the version distributed by Debian stable. > > > Thanks, > > Eshel -- Philip Kaludercic on siskin
bug-gnu-emacs@HIDDEN:bug#73425; Package emacs.
Full text available.Received: (at 73425) by debbugs.gnu.org; 22 Sep 2024 18:16:35 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Sun Sep 22 14:16:35 2024 Received: from localhost ([127.0.0.1]:42738 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1ssR8N-0001pj-63 for submit <at> debbugs.gnu.org; Sun, 22 Sep 2024 14:16:35 -0400 Received: from eggs.gnu.org ([209.51.188.92]:32862) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <eliz@HIDDEN>) id 1ssR8L-0001pV-Ll for 73425 <at> debbugs.gnu.org; Sun, 22 Sep 2024 14:16:34 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from <eliz@HIDDEN>) id 1ssR7t-0002ku-AS; Sun, 22 Sep 2024 14:16:06 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=e5WacKO0+ZqEJ1t4DvOkaO7CxdkLPH/ePjTEK1/k9gw=; b=do2sFc563wcr zVvij5awwymxkllFJ0E0VkbeTwYULJ2vNoR/TriqvEs7Hk3ui7R7aqhG+pVb2/MEjkX/tsV6j2CpN nLPfWHsEnjf2uj2qP5lI4ZwNzjvL7T6rlNrEi4boP27nlzu0h50WIW1yIP+a63La+90ZLrovP+FGX vMgYLzSUl3WpFZAL6O5/jVzjtddofpbYmm7ed4jiFHhKsi9O+iojYBB+vIPaW0j0Y2v8KNT3u7X2e 8XnliBw6HdwFG6b2po7ZzCZs8SsgeEJhLsq7yvenJp8gAELcJE9d+3nBNUEQFNV42DBGFAuvtl14s z6gBOBmDGRiDrkcaIabPog==; Date: Sun, 22 Sep 2024 21:15:49 +0300 Message-Id: <86ldzjh7vu.fsf@HIDDEN> From: Eli Zaretskii <eliz@HIDDEN> To: Philip Kaludercic <philipk@HIDDEN> In-Reply-To: <87h6a78t1t.fsf@HIDDEN> (message from Philip Kaludercic on Sun, 22 Sep 2024 18:03:26 +0000) Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals References: <m1msjzlll3.fsf@HIDDEN> <86v7ynh9au.fsf@HIDDEN> <87h6a78t1t.fsf@HIDDEN> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 73425 Cc: 73425 <at> debbugs.gnu.org, me@HIDDEN X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -3.3 (---) > From: Philip Kaludercic <philipk@HIDDEN> > Cc: Eshel Yaron <me@HIDDEN>, 73425 <at> debbugs.gnu.org > Date: Sun, 22 Sep 2024 18:03:26 +0000 > > Eli Zaretskii <eliz@HIDDEN> writes: > > >> Cc: Philip Kaludercic <philipk@HIDDEN> > >> Date: Sun, 22 Sep 2024 18:06:16 +0200 > >> From: Eshel Yaron via "Bug reports for GNU Emacs, > >> the Swiss army knife of text editors" <bug-gnu-emacs@HIDDEN> > >> > >> I'm opening this feature request following a discussion with Philip > >> elsewhere: Texinfo manual can include images, but AFAIK (and please > >> correct me if I'm wrong here) there's currently no way for ELPA packages > >> to include images in their manuals and have these images appear also in > >> the HTML version of the manual that the ELPA server builds and serves. > > > > Why "no way"? If the image files are present at their filenames as > > mentioned by the HTML version of the documentation, they will be shown > > by the browser. > > The issue is that when generating the HTML documentation for > elpa.gnu.org, we don't copy out any files, but just generate the HTML > version of the manual. > > What we need is some kind of an indication in the package specification, > what files should be copied out for the manual to access, as otherwise > the images would only be hidden in the package tarball, that a web > browser cannot access (AFAIK). "Copied" where and why? Aren't the HTML docs generated in the package's tree, like the Info docs? > >> - Include images in the package repository, somehow indicate in the > >> package specification that the manual refers to these images, and have > >> the ELPA server keep the images around in a predictable location, so I > >> can link to it from the manual. > > > > I don't understand why this would be needed. Simply include the image > > files with the package, and the rest should "just work", AFAIU. > > Do you know if TeXinfo has an option to inline images? If the > "makeinfo" command could somehow generate data: urls when exporting > images, then this could be very easily solved. This is already supported, for a long time, both in Info and HTML formats (and in other formats as well; see the node "Image Syntax" in the Texinfo manual.
bug-gnu-emacs@HIDDEN:bug#73425; Package emacs.
Full text available.Received: (at 73425) by debbugs.gnu.org; 22 Sep 2024 18:14:21 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Sun Sep 22 14:14:20 2024 Received: from localhost ([127.0.0.1]:42733 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1ssR6C-0001dv-FT for submit <at> debbugs.gnu.org; Sun, 22 Sep 2024 14:14:20 -0400 Received: from mail.eshelyaron.com ([107.175.124.16]:58048 helo=eshelyaron.com) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <me@HIDDEN>) id 1ssR69-0001dl-Or for 73425 <at> debbugs.gnu.org; Sun, 22 Sep 2024 14:14:18 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=eshelyaron.com; s=mail; t=1727028835; bh=6AiDSwyQLAIR8/nsb6Tp0B/lD6VadXFttufoTqm6Y3E=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=kip7q7oNOBoN4YFQl8Lkh+M7fV2/eiAQe9+doSA3CMzKntf/meUqVkjkfU8byNItY aaA7GSopmSEtivQYygyLpcOd1nI8JQhQ0YQtIuslPfPaFrQOArQItQg1KSM5c3L/uG gbiPPcMtz01/CNEx2vuna5ufhW03pNH7eVVpoOXPFPJpbqy0isg6zJ6ZZIzp/b0br2 /G3tGdxIt7WAkaziaBsRIgvh8j5pPKY8EBJNREm/yM50sJoYd+WNA6H9wVX+QjAimw +mghCzUtB2uM79YlpfDCMkuupKzSQPAQlpc0slq8CtbJ+fSSqc0pqmNeVH9Tist1xN oEaoRx2B1DfWg== From: Eshel Yaron <me@HIDDEN> To: Philip Kaludercic <philipk@HIDDEN> Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: <87h6a78t1t.fsf@HIDDEN> (Philip Kaludercic's message of "Sun, 22 Sep 2024 18:03:26 +0000") References: <m1msjzlll3.fsf@HIDDEN> <86v7ynh9au.fsf@HIDDEN> <87h6a78t1t.fsf@HIDDEN> Date: Sun, 22 Sep 2024 20:13:52 +0200 Message-ID: <m1r09bsgin.fsf@HIDDEN> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 73425 Cc: Eli Zaretskii <eliz@HIDDEN>, 73425 <at> debbugs.gnu.org X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -1.0 (-) Philip Kaludercic <philipk@HIDDEN> writes: > Eli Zaretskii <eliz@HIDDEN> writes: > >>> Cc: Philip Kaludercic <philipk@HIDDEN> >>> Date: Sun, 22 Sep 2024 18:06:16 +0200 >>> From: Eshel Yaron via "Bug reports for GNU Emacs, >>> the Swiss army knife of text editors" <bug-gnu-emacs@HIDDEN> >>> >>> I'm opening this feature request following a discussion with Philip >>> elsewhere: Texinfo manual can include images, but AFAIK (and please >>> correct me if I'm wrong here) there's currently no way for ELPA packages >>> to include images in their manuals and have these images appear also in >>> the HTML version of the manual that the ELPA server builds and serves. >> >> Why "no way"? If the image files are present at their filenames as >> mentioned by the HTML version of the documentation, they will be shown >> by the browser. > > The issue is that when generating the HTML documentation for > elpa.gnu.org, we don't copy out any files, but just generate the HTML > version of the manual. > > What we need is some kind of an indication in the package specification, > what files should be copied out for the manual to access, as otherwise > the images would only be hidden in the package tarball, that a web > browser cannot access (AFAIK). Yes. >>> An example is my GNU ELPA package Kubed. In the development version, >>> the manual refers to images which are present on my web server, where I >>> provide HTML versions[1][2] of the manual. There, the images are >>> displayed properly. > > Unrelated to this issue, have you considered rendering screenshots as > SVG files using `x-export-frames'? I haven't, but I'll be sure to check it out. Thanks for the tip :) >>> On the ELPA server[3], OTOH, the images are nowhere >>> to be found, and we instead get just the alt text and caption. That's >>> expected, but the alt text is shown with no distinctive styling so the >>> result seems quite confusing. >> >> To show images, your HTML version of the manual should reference local >> files, not URLs from your some other server. And, of course, the >> image files should be part of the package tarball. >> >>> - Include images in the package repository, somehow indicate in the >>> package specification that the manual refers to these images, and have >>> the ELPA server keep the images around in a predictable location, so I >>> can link to it from the manual. >> >> I don't understand why this would be needed. Simply include the image >> files with the package, and the rest should "just work", AFAIU. > > Do you know if TeXinfo has an option to inline images? If the > "makeinfo" command could somehow generate data: urls when exporting > images, then this could be very easily solved. I'm not aware of such an option. BTW, which version of Texinfo does the ELPA server run? Thanks, Eshel
bug-gnu-emacs@HIDDEN:bug#73425; Package emacs.
Full text available.
Received: (at 73425) by debbugs.gnu.org; 22 Sep 2024 18:04:00 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sun Sep 22 14:04:00 2024
Received: from localhost ([127.0.0.1]:42723 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1ssQwB-000188-Nu
for submit <at> debbugs.gnu.org; Sun, 22 Sep 2024 14:04:00 -0400
Received: from mout01.posteo.de ([185.67.36.65]:38461)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <philipk@HIDDEN>) id 1ssQw8-00017r-ET
for 73425 <at> debbugs.gnu.org; Sun, 22 Sep 2024 14:03:57 -0400
Received: from submission (posteo.de [185.67.36.169])
by mout01.posteo.de (Postfix) with ESMTPS id 31B52240028
for <73425 <at> debbugs.gnu.org>; Sun, 22 Sep 2024 20:03:27 +0200 (CEST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017;
t=1727028208; bh=C8BnFhsj0b+ZldmwpsFWSNTvQllknSOdrLFjG7fSVQo=;
h=From:To:Cc:Subject:Autocrypt:OpenPGP:Date:Message-ID:MIME-Version:
Content-Type:From;
b=DtdS/rBAQZkwqwAIGmkw0Lh+cZn5k5tNNwjex/aumL2cqmycS3D9ZOOFrgg4LOsbX
YqbEncUDR1u2SyDBtacK8QNS6qp5EhirN0LJUzbqcXw7syNmkF134lLFyHfN8E0N/9
NUGpK/q24gw7iv6lagg4Eyl1rP8M6OJiwUMeLScROno2SV0wknN3vKAKoPtsieai+S
e/aPLJwkGRSRQDWgxHhpBxFSIW8Tpp3YPmd1LKiVJZ5kR4ld9yIDjtiBzNiXw7hCh8
QqiKPRQpFg6idEPz9cOM8q7pZcWswTsv5IZcWUgMl9hVijVMIetUxKdLkh0CTVWViu
n0PRG5BmgwIlQ==
Received: from customer (localhost [127.0.0.1])
by submission (posteo.de) with ESMTPSA id 4XBYrv1CvXz6ty5;
Sun, 22 Sep 2024 20:03:26 +0200 (CEST)
From: Philip Kaludercic <philipk@HIDDEN>
To: Eli Zaretskii <eliz@HIDDEN>
Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA
package manuals
In-Reply-To: <86v7ynh9au.fsf@HIDDEN> (Eli Zaretskii's message of "Sun, 22 Sep
2024 20:45:13 +0300")
References: <m1msjzlll3.fsf@HIDDEN> <86v7ynh9au.fsf@HIDDEN>
Autocrypt: addr=philipk@HIDDEN; keydata=
mDMEZBBQQhYJKwYBBAHaRw8BAQdAHJuofBrfqFh12uQu0Yi7mrl525F28eTmwUDflFNmdui0QlBo
aWxpcCBLYWx1ZGVyY2ljIChnZW5lcmF0ZWQgYnkgYXV0b2NyeXB0LmVsKSA8cGhpbGlwa0Bwb3N0
ZW8ubmV0PoiWBBMWCAA+FiEEDg7HY17ghYlni8XN8xYDWXahwukFAmQQUEICGwMFCQHhM4AFCwkI
BwIGFQoJCAsCBBYCAwECHgECF4AACgkQ8xYDWXahwulikAEA77hloUiSrXgFkUVJhlKBpLCHUjA0
mWZ9j9w5d08+jVwBAK6c4iGP7j+/PhbkxaEKa4V3MzIl7zJkcNNjHCXmvFcEuDgEZBBQQhIKKwYB
BAGXVQEFAQEHQI5NLiLRjZy3OfSt1dhCmFyn+fN/QKELUYQetiaoe+MMAwEIB4h+BBgWCAAmFiEE
Dg7HY17ghYlni8XN8xYDWXahwukFAmQQUEICGwwFCQHhM4AACgkQ8xYDWXahwukm+wEA8cml4JpK
NeAu65rg+auKrPOP6TP/4YWRCTIvuYDm0joBALw98AMz7/qMHvSCeU/hw9PL6u6R2EScxtpKnWof
z4oM
OpenPGP: id=7126E1DE2F0CE35C770BED01F2C3CC513DB89F66;
url="https://keys.openpgp.org/vks/v1/by-fingerprint/7126E1DE2F0CE35C770BED01F2C3CC513DB89F66";
preference=signencrypt
Date: Sun, 22 Sep 2024 18:03:26 +0000
Message-ID: <87h6a78t1t.fsf@HIDDEN>
MIME-Version: 1.0
Content-Type: text/plain
X-Spam-Score: -2.3 (--)
X-Debbugs-Envelope-To: 73425
Cc: 73425 <at> debbugs.gnu.org, Eshel Yaron <me@HIDDEN>
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)
Eli Zaretskii <eliz@HIDDEN> writes:
>> Cc: Philip Kaludercic <philipk@HIDDEN>
>> Date: Sun, 22 Sep 2024 18:06:16 +0200
>> From: Eshel Yaron via "Bug reports for GNU Emacs,
>> the Swiss army knife of text editors" <bug-gnu-emacs@HIDDEN>
>>
>> I'm opening this feature request following a discussion with Philip
>> elsewhere: Texinfo manual can include images, but AFAIK (and please
>> correct me if I'm wrong here) there's currently no way for ELPA packages
>> to include images in their manuals and have these images appear also in
>> the HTML version of the manual that the ELPA server builds and serves.
>
> Why "no way"? If the image files are present at their filenames as
> mentioned by the HTML version of the documentation, they will be shown
> by the browser.
The issue is that when generating the HTML documentation for
elpa.gnu.org, we don't copy out any files, but just generate the HTML
version of the manual.
What we need is some kind of an indication in the package specification,
what files should be copied out for the manual to access, as otherwise
the images would only be hidden in the package tarball, that a web
browser cannot access (AFAIK).
>> An example is my GNU ELPA package Kubed. In the development version,
>> the manual refers to images which are present on my web server, where I
>> provide HTML versions[1][2] of the manual. There, the images are
>> displayed properly.
Unrelated to this issue, have you considered rendering screenshots as
SVG files using `x-export-frames'?
On the ELPA server[3], OTOH, the images are nowhere
>> to be found, and we instead get just the alt text and caption. That's
>> expected, but the alt text is shown with no distinctive styling so the
>> result seems quite confusing.
>
> To show images, your HTML version of the manual should reference local
> files, not URLs from your some other server. And, of course, the
> image files should be part of the package tarball.
>
>> - Include images in the package repository, somehow indicate in the
>> package specification that the manual refers to these images, and have
>> the ELPA server keep the images around in a predictable location, so I
>> can link to it from the manual.
>
> I don't understand why this would be needed. Simply include the image
> files with the package, and the rest should "just work", AFAIU.
Do you know if TeXinfo has an option to inline images? If the
"makeinfo" command could somehow generate data: urls when exporting
images, then this could be very easily solved.
[0] https://developer.mozilla.org/en-US/docs/Web/URI/Schemes/data
>> - Provide a IMAGE_LINK_PREFIX value (e.g. pointing to my web server)
>> that the ELPA server will use while building the HTML manual.
>
> That's definitely not TRT: ELPA packages should be self-contained as
> far as their documentation is concerned.
>
>> - Override the creation of the HTML manual entirely, and have the ELPA
>> server redirect or link to the version hosted on my web server.
>
> Likewise: there should be no dependency on any server.
I agree.
> Apologies if I misunderstood the problem.
--
Philip Kaludercic on siskin
bug-gnu-emacs@HIDDEN:bug#73425; Package emacs.
Full text available.Received: (at 73425) by debbugs.gnu.org; 22 Sep 2024 17:46:06 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Sun Sep 22 13:46:06 2024 Received: from localhost ([127.0.0.1]:42712 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1ssQes-0000Fn-CQ for submit <at> debbugs.gnu.org; Sun, 22 Sep 2024 13:46:06 -0400 Received: from eggs.gnu.org ([209.51.188.92]:36164) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <eliz@HIDDEN>) id 1ssQep-0000Ef-F0 for 73425 <at> debbugs.gnu.org; Sun, 22 Sep 2024 13:46:05 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from <eliz@HIDDEN>) id 1ssQeI-0000BM-JZ; Sun, 22 Sep 2024 13:45:34 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=rk2aa5OS4Oxw3wvK1zj9WPAs7AM6FxGVJvD/4emThtA=; b=PCX7JtReBF7F /1zmOgrKdTNIlpHaPYTkVhSdnFGVwO1tSFR29x5vt+PLeqxNcOaMq7pHdAnd2V7iPB41tIqcbK/UZ VJZY/E1cWCAa6WWp6fkzuX/PNY7ewjblV/ufRPRcVfTJJvuICfnDmuGM3KpJ8wCv9VOTag5bWX0Ms UAjyfYsk/RTsuAThBELNA9H7U7KnDPFdbdLgQrNs6ZjCkgdIcoVVId/ibWJMhAqJReb47fuCI9oSf m9vC4/7ylMvU09hQY1He/PZ90wLzrfFXYzHqs7GYC1t6rAUFupO6bE+4QOg1J2Eo66k/5yR6QXmOf 8uMwKOJjJalOQPUxStZFSQ==; Date: Sun, 22 Sep 2024 20:45:13 +0300 Message-Id: <86v7ynh9au.fsf@HIDDEN> From: Eli Zaretskii <eliz@HIDDEN> To: Eshel Yaron <me@HIDDEN> In-Reply-To: <m1msjzlll3.fsf@HIDDEN> (bug-gnu-emacs@HIDDEN) Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals References: <m1msjzlll3.fsf@HIDDEN> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 73425 Cc: 73425 <at> debbugs.gnu.org, philipk@HIDDEN X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -3.3 (---) > Cc: Philip Kaludercic <philipk@HIDDEN> > Date: Sun, 22 Sep 2024 18:06:16 +0200 > From: Eshel Yaron via "Bug reports for GNU Emacs, > the Swiss army knife of text editors" <bug-gnu-emacs@HIDDEN> > > I'm opening this feature request following a discussion with Philip > elsewhere: Texinfo manual can include images, but AFAIK (and please > correct me if I'm wrong here) there's currently no way for ELPA packages > to include images in their manuals and have these images appear also in > the HTML version of the manual that the ELPA server builds and serves. Why "no way"? If the image files are present at their filenames as mentioned by the HTML version of the documentation, they will be shown by the browser. > An example is my GNU ELPA package Kubed. In the development version, > the manual refers to images which are present on my web server, where I > provide HTML versions[1][2] of the manual. There, the images are > displayed properly. On the ELPA server[3], OTOH, the images are nowhere > to be found, and we instead get just the alt text and caption. That's > expected, but the alt text is shown with no distinctive styling so the > result seems quite confusing. To show images, your HTML version of the manual should reference local files, not URLs from your some other server. And, of course, the image files should be part of the package tarball. > - Include images in the package repository, somehow indicate in the > package specification that the manual refers to these images, and have > the ELPA server keep the images around in a predictable location, so I > can link to it from the manual. I don't understand why this would be needed. Simply include the image files with the package, and the rest should "just work", AFAIU. > - Provide a IMAGE_LINK_PREFIX value (e.g. pointing to my web server) > that the ELPA server will use while building the HTML manual. That's definitely not TRT: ELPA packages should be self-contained as far as their documentation is concerned. > - Override the creation of the HTML manual entirely, and have the ELPA > server redirect or link to the version hosted on my web server. Likewise: there should be no dependency on any server. Apologies if I misunderstood the problem.
bug-gnu-emacs@HIDDEN:bug#73425; Package emacs.
Full text available.Received: (at submit) by debbugs.gnu.org; 22 Sep 2024 16:06:52 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Sun Sep 22 12:06:52 2024 Received: from localhost ([127.0.0.1]:42681 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1ssP6p-0003Yo-VV for submit <at> debbugs.gnu.org; Sun, 22 Sep 2024 12:06:52 -0400 Received: from lists.gnu.org ([209.51.188.17]:34618) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <me@HIDDEN>) id 1ssP6n-0003Yg-9n for submit <at> debbugs.gnu.org; Sun, 22 Sep 2024 12:06:50 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from <me@HIDDEN>) id 1ssP6R-0001L2-6q for bug-gnu-emacs@HIDDEN; Sun, 22 Sep 2024 12:06:27 -0400 Received: from mail.eshelyaron.com ([107.175.124.16] helo=eshelyaron.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from <me@HIDDEN>) id 1ssP6P-0008SO-Og for bug-gnu-emacs@HIDDEN; Sun, 22 Sep 2024 12:06:26 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=eshelyaron.com; s=mail; t=1727021184; bh=boi/8YjIXQIYRr93URBH/X5/qhq8oYAvMlhVpqzok24=; h=From:To:Subject:Date:From; b=ILnGl/SNo2wlLbQKGGGWGa7YTFF5UbLoZ+xR7W0nSBLbMGes0HkMCyJhNSae8+oou 75j/Cf10DfeJdiggttKhrP/2IXzDzdq39cZDmWymNfhF1PfliMwhAC7EPisQBD4lIR ceeIOdPsRpk0NI23p6X+12H/jxMBn5G/nZOY3rkULTySCGUw2NTBhP369WtbCxACil ysdELfHzmTiT411ltYMtwCC9d/V+vnLT70Xc9kezPMHXAV8kjtcAE0GBb5xob701E4 udov4NSdxwys9OWEc2zjj5cMldfTpbEHWCXKeWpeBqriLCoS0UJRh/9S9nuNabOibk KWxXCH3G3f5yw== From: Eshel Yaron <me@HIDDEN> To: bug-gnu-emacs@HIDDEN Subject: 31.0.50; Support images in HTML versions of ELPA package manuals X-Debbugs-Cc: Philip Kaludercic <philipk@HIDDEN> X-Hashcash: 1:20:240922:bug-gnu-emacs@HIDDEN::5tivIehc0MLDLvUJ:6Mjm Date: Sun, 22 Sep 2024 18:06:16 +0200 Message-ID: <m1msjzlll3.fsf@HIDDEN> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=107.175.124.16; envelope-from=me@HIDDEN; helo=eshelyaron.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.4 (-) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -2.4 (--) Hi, I'm opening this feature request following a discussion with Philip elsewhere: Texinfo manual can include images, but AFAIK (and please correct me if I'm wrong here) there's currently no way for ELPA packages to include images in their manuals and have these images appear also in the HTML version of the manual that the ELPA server builds and serves. An example is my GNU ELPA package Kubed. In the development version, the manual refers to images which are present on my web server, where I provide HTML versions[1][2] of the manual. There, the images are displayed properly. On the ELPA server[3], OTOH, the images are nowhere to be found, and we instead get just the alt text and caption. That's expected, but the alt text is shown with no distinctive styling so the result seems quite confusing. Ideally, I would like a way to be able to do one of the following: - Include images in the package repository, somehow indicate in the package specification that the manual refers to these images, and have the ELPA server keep the images around in a predictable location, so I can link to it from the manual. - Provide a IMAGE_LINK_PREFIX value (e.g. pointing to my web server) that the ELPA server will use while building the HTML manual. - Override the creation of the HTML manual entirely, and have the ELPA server redirect or link to the version hosted on my web server. Thanks, Eshel [1] https://eshelyaron.com/kubed.html [2] https://eshelyaron.com/man/kubed/ [3] https://elpa.gnu.org/devel/doc/kubed.html
Eshel Yaron <me@HIDDEN>:philipk@HIDDEN, bug-gnu-emacs@HIDDEN.
Full text available.philipk@HIDDEN, bug-gnu-emacs@HIDDEN:bug#73425; Package emacs.
Full text available.
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997 nCipher Corporation Ltd,
1994-97 Ian Jackson.