From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eshel Yaron via "Bug reports for GNU Emacs, the Swiss army knife of text editors" Newsgroups: gmane.emacs.bugs Subject: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals Date: Sun, 22 Sep 2024 18:06:16 +0200 Message-ID: Reply-To: Eshel Yaron Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="21030"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Cc: Philip Kaludercic To: 73425@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun Sep 22 18:07:01 2024 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1ssP6y-0005Kt-QD for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 22 Sep 2024 18:07:00 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ssP6k-0001MV-Dh; Sun, 22 Sep 2024 12:06:46 -0400 Original-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 ) id 1ssP6g-0001M1-7Q for bug-gnu-emacs@gnu.org; Sun, 22 Sep 2024 12:06:42 -0400 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1ssP6e-0008T7-V1 for bug-gnu-emacs@gnu.org; Sun, 22 Sep 2024 12:06:41 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=MIME-Version:Date:From:To:Subject; bh=8M3+v+GPjzDs00rRGUeMLILsE0Vjs4HN9+bEw8TdyFA=; b=gV0oE/YBl6lb8tXCABUmBRRWk0DI314hynUWw9nKvd4S0Ilr2gUPIzLx2NwIWi78VAOHikhuBQ61uCElNXm8nYzgteLtRpcBxj9ClPjmiUNMTlPvPJN6PJRfMfdDzettNOLVqp/Z4QVc/Y8SH9sYOQL6QUbmA0xw2XWTIXFgqqDDgJ6EJDL7wxcfyZZjeUxf0qtT9/GNP3o+ZikYS0SCO7OuK30tguIZ4B521lAw0vxjm4cgTuNF7uK/X8vSDYfBJ4+vUZAiRf2pZH4nAgzcMo3eRKBJQM9NPt+pIiu+KFfGSLooCI7cmVYvBIvOGSCMlyj2hlzOmHEsDfsrdV0NaQ==; Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1ssP6z-0003ZE-SS; Sun, 22 Sep 2024 12:07:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eshel Yaron Original-Sender: "Debbugs-submit" Resent-CC: philipk@posteo.net, bug-gnu-emacs@gnu.org Resent-Date: Sun, 22 Sep 2024 16:07:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 73425 X-GNU-PR-Package: emacs X-Debbugs-Original-To: bug-gnu-emacs@gnu.org X-Debbugs-Original-Xcc: Philip Kaludercic Original-Received: via spool by submit@debbugs.gnu.org id=B.172702121213695 (code B ref -1); Sun, 22 Sep 2024 16:07:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 22 Sep 2024 16:06:52 +0000 Original-Received: from localhost ([127.0.0.1]:42681 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ssP6p-0003Yo-VV for submit@debbugs.gnu.org; Sun, 22 Sep 2024 12:06:52 -0400 Original-Received: from lists.gnu.org ([209.51.188.17]:34618) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ssP6n-0003Yg-9n for submit@debbugs.gnu.org; Sun, 22 Sep 2024 12:06:50 -0400 Original-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 ) id 1ssP6R-0001L2-6q for bug-gnu-emacs@gnu.org; Sun, 22 Sep 2024 12:06:27 -0400 Original-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 ) id 1ssP6P-0008SO-Og for bug-gnu-emacs@gnu.org; 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== X-Hashcash: 1:20:240922:bug-gnu-emacs@gnu.org::5tivIehc0MLDLvUJ:6Mjm Received-SPF: pass client-ip=107.175.124.16; envelope-from=me@eshelyaron.com; 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-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:292239 Archived-At: 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