From unknown Thu Aug 14 12:23:11 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#73425 <73425@debbugs.gnu.org> To: bug#73425 <73425@debbugs.gnu.org> Subject: Status: 31.0.50; Support images in HTML versions of ELPA package manuals Reply-To: bug#73425 <73425@debbugs.gnu.org> Date: Thu, 14 Aug 2025 19:23:11 +0000 retitle 73425 31.0.50; Support images in HTML versions of ELPA package manu= als reassign 73425 emacs submitter 73425 Eshel Yaron severity 73425 wishlist thanks From debbugs-submit-bounces@debbugs.gnu.org Sun Sep 22 12:06:52 2024 Received: (at submit) by debbugs.gnu.org; 22 Sep 2024 16:06:52 +0000 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 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 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 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== From: Eshel Yaron To: bug-gnu-emacs@gnu.org Subject: 31.0.50; Support images in HTML versions of ELPA package manuals X-Debbugs-Cc: Philip Kaludercic X-Hashcash: 1:20:240922:bug-gnu-emacs@gnu.org::5tivIehc0MLDLvUJ:6Mjm Date: Sun, 22 Sep 2024 18:06:16 +0200 Message-ID: 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@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-Spam-Score: -1.4 (-) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" 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 From debbugs-submit-bounces@debbugs.gnu.org Sun Sep 22 13:46:06 2024 Received: (at 73425) by debbugs.gnu.org; 22 Sep 2024 17:46:06 +0000 Received: from localhost ([127.0.0.1]:42712 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ssQes-0000Fn-CQ for submit@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 ) id 1ssQep-0000Ef-F0 for 73425@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 ) 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@gnu.org> From: Eli Zaretskii To: Eshel Yaron In-Reply-To: (bug-gnu-emacs@gnu.org) Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals References: X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 73425 Cc: 73425@debbugs.gnu.org, philipk@posteo.net X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > Cc: Philip Kaludercic > 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" > > 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. From debbugs-submit-bounces@debbugs.gnu.org Sun Sep 22 14:04:00 2024 Received: (at 73425) by debbugs.gnu.org; 22 Sep 2024 18:04:00 +0000 Received: from localhost ([127.0.0.1]:42723 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ssQwB-000188-Nu for submit@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 ) id 1ssQw8-00017r-ET for 73425@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@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 To: Eli Zaretskii Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: <86v7ynh9au.fsf@gnu.org> (Eli Zaretskii's message of "Sun, 22 Sep 2024 20:45:13 +0300") References: <86v7ynh9au.fsf@gnu.org> Autocrypt: addr=philipk@posteo.net; 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@posteo.net> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 73425 Cc: 73425@debbugs.gnu.org, Eshel Yaron X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Eli Zaretskii writes: >> Cc: Philip Kaludercic >> 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" >> >> 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 From debbugs-submit-bounces@debbugs.gnu.org Sun Sep 22 14:14:20 2024 Received: (at 73425) by debbugs.gnu.org; 22 Sep 2024 18:14:21 +0000 Received: from localhost ([127.0.0.1]:42733 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ssR6C-0001dv-FT for submit@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 ) id 1ssR69-0001dl-Or for 73425@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 To: Philip Kaludercic Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: <87h6a78t1t.fsf@posteo.net> (Philip Kaludercic's message of "Sun, 22 Sep 2024 18:03:26 +0000") References: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> Date: Sun, 22 Sep 2024 20:13:52 +0200 Message-ID: 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 , 73425@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Philip Kaludercic writes: > Eli Zaretskii writes: > >>> Cc: Philip Kaludercic >>> 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" >>> >>> 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 From debbugs-submit-bounces@debbugs.gnu.org Sun Sep 22 14:16:35 2024 Received: (at 73425) by debbugs.gnu.org; 22 Sep 2024 18:16:35 +0000 Received: from localhost ([127.0.0.1]:42738 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ssR8N-0001pj-63 for submit@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 ) id 1ssR8L-0001pV-Ll for 73425@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 ) 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@gnu.org> From: Eli Zaretskii To: Philip Kaludercic In-Reply-To: <87h6a78t1t.fsf@posteo.net> (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: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 73425 Cc: 73425@debbugs.gnu.org, me@eshelyaron.com X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Philip Kaludercic > Cc: Eshel Yaron , 73425@debbugs.gnu.org > Date: Sun, 22 Sep 2024 18:03:26 +0000 > > Eli Zaretskii writes: > > >> Cc: Philip Kaludercic > >> 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" > >> > >> 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. From debbugs-submit-bounces@debbugs.gnu.org Sun Sep 22 14:17:16 2024 Received: (at 73425) by debbugs.gnu.org; 22 Sep 2024 18:17:16 +0000 Received: from localhost ([127.0.0.1]:42743 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ssR91-0001rl-Li for submit@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 ) id 1ssR90-0001rY-2l for 73425@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@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 To: Eshel Yaron Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: (Eshel Yaron's message of "Sun, 22 Sep 2024 20:13:52 +0200") References: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> Autocrypt: addr=philipk@posteo.net; 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@posteo.net> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 73425 Cc: Eli Zaretskii , 73425@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Eshel Yaron writes: > Philip Kaludercic writes: > >> Eli Zaretskii writes: >> >>>> Cc: Philip Kaludercic >>>> 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" >>>> >>>> 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 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 From debbugs-submit-bounces@debbugs.gnu.org Sun Sep 22 14:24:11 2024 Received: (at 73425) by debbugs.gnu.org; 22 Sep 2024 18:24:11 +0000 Received: from localhost ([127.0.0.1]:42748 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ssRFi-0002Bb-O7 for submit@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 ) id 1ssRFf-0002B0-9O for 73425@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@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 To: Eli Zaretskii Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: <86ldzjh7vu.fsf@gnu.org> (Eli Zaretskii's message of "Sun, 22 Sep 2024 21:15:49 +0300") References: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> Autocrypt: addr=philipk@posteo.net; 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@posteo.net> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 73425 Cc: 73425@debbugs.gnu.org, me@eshelyaron.com X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Eli Zaretskii writes: >> From: Philip Kaludercic >> Cc: Eshel Yaron , 73425@debbugs.gnu.org >> Date: Sun, 22 Sep 2024 18:03:26 +0000 >> >> Eli Zaretskii writes: >> >> >> Cc: Philip Kaludercic >> >> 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" >> >> >> >> 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 From debbugs-submit-bounces@debbugs.gnu.org Sun Sep 22 14:44:26 2024 Received: (at 73425) by debbugs.gnu.org; 22 Sep 2024 18:44:26 +0000 Received: from localhost ([127.0.0.1]:42753 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ssRZJ-0003GF-SF for submit@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 ) id 1ssRZH-0003G2-DS for 73425@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 To: Philip Kaludercic Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: <8734lr8sfn.fsf@posteo.net> (Philip Kaludercic's message of "Sun, 22 Sep 2024 18:16:44 +0000") References: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <8734lr8sfn.fsf@posteo.net> Date: Sun, 22 Sep 2024 20:43:56 +0200 Message-ID: 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 , 73425@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Philip Kaludercic writes: > Eshel Yaron writes: > >> Philip Kaludercic 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 > 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! From debbugs-submit-bounces@debbugs.gnu.org Sun Sep 22 15:06:33 2024 Received: (at 73425) by debbugs.gnu.org; 22 Sep 2024 19:06:33 +0000 Received: from localhost ([127.0.0.1]:42763 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ssRuj-0004Vo-9c for submit@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 ) id 1ssRue-0004VS-F8 for 73425@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 ) 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@gnu.org> From: Eli Zaretskii To: Philip Kaludercic In-Reply-To: <87y13j7djp.fsf@posteo.net> (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: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> <87y13j7djp.fsf@posteo.net> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 73425 Cc: 73425@debbugs.gnu.org, me@eshelyaron.com X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Philip Kaludercic > Cc: me@eshelyaron.com, 73425@debbugs.gnu.org > Date: Sun, 22 Sep 2024 18:23:38 +0000 > > Eli Zaretskii 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? From debbugs-submit-bounces@debbugs.gnu.org Mon Sep 23 06:49:17 2024 Received: (at 73425) by debbugs.gnu.org; 23 Sep 2024 10:49:17 +0000 Received: from localhost ([127.0.0.1]:43256 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ssgd3-0005H1-4t for submit@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 ) id 1ssgcz-0005Gj-C2 for 73425@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@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 To: Eli Zaretskii Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: <86ikunh5kg.fsf@gnu.org> (Eli Zaretskii's message of "Sun, 22 Sep 2024 22:05:51 +0300") References: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> <87y13j7djp.fsf@posteo.net> <86ikunh5kg.fsf@gnu.org> Autocrypt: addr=philipk@posteo.net; 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@posteo.net; url="https://keys.openpgp.org/vks/v1/by-email/philipk@posteo.net"; preference=signencrypt Date: Mon, 23 Sep 2024 10:48:41 +0000 Message-ID: <87ldzifxx2.fsf@posteo.net> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 73425 Cc: 73425@debbugs.gnu.org, me@eshelyaron.com, Stefan Monnier X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Eli Zaretskii writes: >> From: Philip Kaludercic >> Cc: me@eshelyaron.com, 73425@debbugs.gnu.org >> Date: Sun, 22 Sep 2024 18:23:38 +0000 >> >> Eli Zaretskii 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 makeinfo could produce ) id 1sshnX-00017p-2Q for submit@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 ) id 1sshnU-00017W-SE for 73425@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 ) 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@gnu.org> From: Eli Zaretskii To: Philip Kaludercic In-Reply-To: <87ldzifxx2.fsf@posteo.net> (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: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> <87y13j7djp.fsf@posteo.net> <86ikunh5kg.fsf@gnu.org> <87ldzifxx2.fsf@posteo.net> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 73425 Cc: 73425@debbugs.gnu.org, me@eshelyaron.com, monnier@iro.umontreal.ca X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Philip Kaludercic > Cc: me@eshelyaron.com, 73425@debbugs.gnu.org, "Stefan Monnier" > > Date: Mon, 23 Sep 2024 10:48:41 +0000 > > Eli Zaretskii 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 > > > > makeinfo could produce > > ) id 1ssiSy-0003Yg-N2 for submit@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 ) id 1ssiSw-0003YR-9j for 73425@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@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 To: Eli Zaretskii Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: <86zfnyfug8.fsf@gnu.org> (Eli Zaretskii's message of "Mon, 23 Sep 2024 15:03:35 +0300") References: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> <87y13j7djp.fsf@posteo.net> <86ikunh5kg.fsf@gnu.org> <87ldzifxx2.fsf@posteo.net> <86zfnyfug8.fsf@gnu.org> Autocrypt: addr=philipk@posteo.net; 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@posteo.net; url="https://keys.openpgp.org/vks/v1/by-email/philipk@posteo.net"; preference=signencrypt Date: Mon, 23 Sep 2024 12:46:25 +0000 Message-ID: <87ploutu5a.fsf@posteo.net> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 73425 Cc: 73425@debbugs.gnu.org, me@eshelyaron.com, monnier@iro.umontreal.ca X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Eli Zaretskii writes: >> From: Philip Kaludercic >> Cc: me@eshelyaron.com, 73425@debbugs.gnu.org, "Stefan Monnier" >> >> Date: Mon, 23 Sep 2024 10:48:41 +0000 >> >> Eli Zaretskii 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 >> >> >> >> makeinfo could produce >> >> > 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 From debbugs-submit-bounces@debbugs.gnu.org Mon Sep 23 10:00:37 2024 Received: (at 73425) by debbugs.gnu.org; 23 Sep 2024 14:00:38 +0000 Received: from localhost ([127.0.0.1]:44491 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ssjcD-0007yE-Ha for submit@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 ) id 1ssjc9-0007s4-5R for 73425@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 To: Philip Kaludercic Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: <87ldzifxx2.fsf@posteo.net> (Philip Kaludercic's message of "Mon, 23 Sep 2024 10:48:41 +0000") Message-ID: References: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> <87y13j7djp.fsf@posteo.net> <86ikunh5kg.fsf@gnu.org> <87ldzifxx2.fsf@posteo.net> 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 , me@eshelyaron.com, 73425@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" 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 From debbugs-submit-bounces@debbugs.gnu.org Mon Sep 23 10:20:12 2024 Received: (at 73425) by debbugs.gnu.org; 23 Sep 2024 14:20:12 +0000 Received: from localhost ([127.0.0.1]:44522 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ssjvA-0000XI-0J for submit@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 ) id 1ssjv7-0000X4-8g for 73425@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 ) 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@gnu.org> From: Eli Zaretskii To: Philip Kaludercic In-Reply-To: <87ploutu5a.fsf@posteo.net> (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: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> <87y13j7djp.fsf@posteo.net> <86ikunh5kg.fsf@gnu.org> <87ldzifxx2.fsf@posteo.net> <86zfnyfug8.fsf@gnu.org> <87ploutu5a.fsf@posteo.net> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 73425 Cc: 73425@debbugs.gnu.org, me@eshelyaron.com, monnier@iro.umontreal.ca X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Philip Kaludercic > Cc: me@eshelyaron.com, 73425@debbugs.gnu.org, monnier@iro.umontreal.ca > Date: Mon, 23 Sep 2024 12:46:25 +0000 > > >> Some kind of --embed flag, that would inline images. So instead of > >> generating > >> > >> > >> > >> makeinfo could produce > >> > >> > > > 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. From debbugs-submit-bounces@debbugs.gnu.org Thu Sep 26 00:04:23 2024 Received: (at 73425) by debbugs.gnu.org; 26 Sep 2024 04:04:23 +0000 Received: from localhost ([127.0.0.1]:41909 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1stfjq-0003wZ-Tf for submit@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 ) id 1stfjn-0003wJ-Jl for 73425@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@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 In-Reply-To: <87ploutu5a.fsf@posteo.net> References: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> <87y13j7djp.fsf@posteo.net> <86ikunh5kg.fsf@gnu.org> <87ldzifxx2.fsf@posteo.net> <86zfnyfug8.fsf@gnu.org> <87ploutu5a.fsf@posteo.net> MIME-Version: 1.0 Date: Wed, 25 Sep 2024 21:02:45 -0700 Message-ID: Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals To: Philip Kaludercic , Eli Zaretskii Content-Type: text/plain; charset="UTF-8" X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 73425 Cc: 73425@debbugs.gnu.org, me@eshelyaron.com, monnier@iro.umontreal.ca X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Philip Kaludercic 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. From debbugs-submit-bounces@debbugs.gnu.org Thu Sep 26 16:11:36 2024 Received: (at 73425) by debbugs.gnu.org; 26 Sep 2024 20:11:36 +0000 Received: from localhost ([127.0.0.1]:51900 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1stupr-0002Li-0I for submit@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 ) id 1stupm-0002LP-4L for 73425@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 To: Stefan Kangas Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: (Stefan Kangas's message of "Wed, 25 Sep 2024 21:02:45 -0700") Message-ID: References: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> <87y13j7djp.fsf@posteo.net> <86ikunh5kg.fsf@gnu.org> <87ldzifxx2.fsf@posteo.net> <86zfnyfug8.fsf@gnu.org> <87ploutu5a.fsf@posteo.net> 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 , me@eshelyaron.com, Eli Zaretskii , 73425@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" 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 From debbugs-submit-bounces@debbugs.gnu.org Sun Sep 29 21:37:36 2024 Received: (at control) by debbugs.gnu.org; 30 Sep 2024 01:37:37 +0000 Received: from localhost ([127.0.0.1]:43491 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sv5M0-00081U-2i for submit@debbugs.gnu.org; Sun, 29 Sep 2024 21:37:36 -0400 Received: from mail-ed1-f53.google.com ([209.85.208.53]:52481) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sv5LY-0007vO-9m for control@debbugs.gnu.org; Sun, 29 Sep 2024 21:37:10 -0400 Received: by mail-ed1-f53.google.com with SMTP id 4fb4d7f45d1cf-5c5b9bf9d8bso2808227a12.1 for ; Sun, 29 Sep 2024 18:36:36 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1727660130; x=1728264930; darn=debbugs.gnu.org; h=to:subject:message-id:date:mime-version:from:from:to:cc:subject :date:message-id:reply-to; bh=gL2vfAq6VgzD0M5SI4ZhvbaTzUTpBmdxsBdomfYfbTY=; b=lg4u1+xlhSaxM3vIxl+BHbfgBL5H/5oE0ibOKqzj/avn40K8OlrnOyQMcr9aJQnAhp QaQ19tqJElbAo/cHvNsU3Rg/V1i7Y3FVcgl+wXcGmLVvqrwntj73vb/vMgmDxtzzKDcQ SPvzH27os46KJLEckn5zXP2QSoAXmm4LgDrOQVtoZ1bFKSK+Tg27uC0kRjgSRxClYnIO NTSQOtyE7Xhc6vUJMlmq14oTcvofdvzrmh0lj7tQP/ahu3CVDJOg50K6QdGf8TBToyWM 8nuyhhb9QFM5ju8lDF3LcrrsWWv6u87dDluzE5MfcVvboAJBKDFNbik0xP9FRYUoHE1f Yy2A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1727660130; x=1728264930; h=to:subject:message-id:date:mime-version:from:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=gL2vfAq6VgzD0M5SI4ZhvbaTzUTpBmdxsBdomfYfbTY=; b=A9CZiW+6IlW6sxXV5nJPM9bU4egBCX2X1mUp9ozo6aNHx6rZZtyWZIEEgghBCRAV3W VnMG16FLSlzAkRhNMBndyoDqvyzeaAsUeefX4kw5QEbSLVTP1ig1X0Bll68HRm3BgGSA FQIkvQERqEqf43h04XhGuuNRTqhqtfw8d2z8mLeeiG25X4y01gYG+yD/d00kHJkZ5l3x BN3DbOR8z9Do7h59W79RR7eaZCDp6GXwvobZEJCM1LNMbYRQjPzLAcMV4fk6UvNJII8C 4IFvh2YbUu/IyxmCH9kixisCAhE0HuW4/hea3+8HFTFp+QyN6GmO51+CO2eHqr1Ffla3 bGPg== X-Gm-Message-State: AOJu0Yy61J3lAEezcEJhIV0X/emiKTTrIAeW4G19x9qYB3vfXvItoUbA xBtnL8fuE53fIt1WQlYK05jqBe7zPVJ0LWUsGKnoLvYX3R8RBWHCEF0yTITrZ078K9L6OphHiCU kY4HSoamnJHcQuJX25VFBfQGeeSm6nQ== X-Google-Smtp-Source: AGHT+IGmTQ61W5O2tLCFReL01D3kuIFAVTLgoUfaWQol0BYkYqe0LweOjuVcUj5r1XCTF5hBMRluxDVJXwB7m7X9ppY= X-Received: by 2002:a05:6402:1d54:b0:5c4:2384:c485 with SMTP id 4fb4d7f45d1cf-5c8825fe1e3mr18978224a12.27.1727660130335; Sun, 29 Sep 2024 18:35:30 -0700 (PDT) Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Sun, 29 Sep 2024 18:35:30 -0700 From: Stefan Kangas MIME-Version: 1.0 Date: Sun, 29 Sep 2024 18:35:30 -0700 Message-ID: Subject: control message for bug #73425 To: control@debbugs.gnu.org Content-Type: text/plain; charset="UTF-8" X-Spam-Score: -0.9 (/) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.9 (-) severity 73425 wishlist quit From debbugs-submit-bounces@debbugs.gnu.org Thu Apr 10 15:17:54 2025 Received: (at 73425) by debbugs.gnu.org; 10 Apr 2025 19:17:54 +0000 Received: from localhost ([127.0.0.1]:47047 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u2xPN-0008Qr-O9 for submit@debbugs.gnu.org; Thu, 10 Apr 2025 15:17:54 -0400 Received: from mailscanner.iro.umontreal.ca ([132.204.25.50]:28886) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u2xPK-0008QW-HP for 73425@debbugs.gnu.org; Thu, 10 Apr 2025 15:17:50 -0400 Received: from pmg1.iro.umontreal.ca (localhost.localdomain [127.0.0.1]) by pmg1.iro.umontreal.ca (Proxmox) with ESMTP id 1F1B210004C; Thu, 10 Apr 2025 15:17:44 -0400 (EDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=iro.umontreal.ca; s=mail; t=1744312663; bh=ZmmoHp+Rskb3LTlWJEPEsAXQPo/ORbzqNHh+bX21B2E=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=Hlrruah2tdMAWbmcSUcQccG4p9Lz1TCX+p8G6atI5/vok9npDH+MOrfyKdUJ0s+sq oAMCNXnHbbnkLY4EFMJOE9EodyJuxAQuC3jYbCCpDLKuvd1n1/8ptex0fWQrwviWQH ht/6fE66j8sjr8xcF5v6E9qf1PlS9VrqQLiQzvtISTJvjPGEI5nuZCDMQvMq7SbNTg 9rqV+PPgId4UyWIo+fF+aDj4xBKt2PsY7GuMJCoqt5V2MNPhZLKRx4/uIXerlwT3Uz mrAGfShTXCqAvmJiSwESM3z9I/NygUHuyuf/QPqpXJkKDSJawrQaPYYL7fprMlDB8g PtK8Twl0d9bkw== Received: from mail01.iro.umontreal.ca (unknown [172.31.2.1]) by pmg1.iro.umontreal.ca (Proxmox) with ESMTP id 3CA87100029; Thu, 10 Apr 2025 15:17:43 -0400 (EDT) Received: from pastel (unknown [104.247.242.5]) by mail01.iro.umontreal.ca (Postfix) with ESMTPSA id F027B1201DD; Thu, 10 Apr 2025 15:17:42 -0400 (EDT) From: Stefan Monnier To: Philip Kaludercic Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: <87ploutu5a.fsf@posteo.net> Message-ID: References: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> <87y13j7djp.fsf@posteo.net> <86ikunh5kg.fsf@gnu.org> <87ldzifxx2.fsf@posteo.net> <86zfnyfug8.fsf@gnu.org> <87ploutu5a.fsf@posteo.net> Date: Thu, 10 Apr 2025 15:17:42 -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.368 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 KAM_SHORT 0.001 Use of a URL Shortener for very short URL X-SPAM-LEVEL: X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 73425 Cc: Eli Zaretskii , Robert Weiner , me@eshelyaron.com, 73425@debbugs.gnu.org, Mats Lidell X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" 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/")) That'd be kind of a problem because `:doc` already supports a list of strings where each string is expected to be the source file of a manual, so the above is currently treated as a package with two manuals: one produced from `kubed.texi` and the other from `images/`. IOW we'd need to tweak the format a bit to avoid the ambiguity. Maybe we can get away with just a `:doc-files` instead? Other than that I agree. AFAICT, the plan is as follows: - Add support in package specs for "associated files" for each of the manuals (ideally also for the `:readme`, BTW). - Arrange to copy those "associated files" to the `doc//` subdirectory of the `archive(-devel)/` area. - Massage the HTML files so that `href="snapshot.png"` becomes `href="/snapshot.png"`. For the `:readme` case, we should instead redirect them to `doc//snapshot.png`. This should make the HTML links to images work in the web versions of the manuals. Complements: - Offer a way to specify part of the package specs directly in the package itself (presumably within the pseudo-headers of the main file). Would be useful in general rather than just for "associated files". - Maybe also offer some support to generate the list of associated files dynamically/automatically by scrubbing the generated HTML files? There is apparently a related issue with the Info version of the manual when the Texinfo doc is not in the root of the package dir, in which case when the Info file is moved to the root of the package directory (which is necessary for the code in `package.el` which adds the package's dir in `Info-directory-list`), the links to the image files break. So another related change would be: - Make sure the links to associated files work also for the Info versions of the manuals, even when they're moved to the root directory. Beside `kubed` there's also `hyperbole` which can be used for experiments (`hyperbole` suffers from the problem both in the web version and in the Info version of their manual). Stefan From debbugs-submit-bounces@debbugs.gnu.org Fri Apr 18 14:04:04 2025 Received: (at 73425) by debbugs.gnu.org; 18 Apr 2025 18:04:05 +0000 Received: from localhost ([127.0.0.1]:52799 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u5q4I-0005nl-Ft for submit@debbugs.gnu.org; Fri, 18 Apr 2025 14:04:04 -0400 Received: from mailscanner.iro.umontreal.ca ([132.204.25.50]:63936) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u5q4F-0005m9-Ut for 73425@debbugs.gnu.org; Fri, 18 Apr 2025 14:04:01 -0400 Received: from pmg1.iro.umontreal.ca (localhost.localdomain [127.0.0.1]) by pmg1.iro.umontreal.ca (Proxmox) with ESMTP id 6431B1000BC; Fri, 18 Apr 2025 14:03:54 -0400 (EDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=iro.umontreal.ca; s=mail; t=1744999433; bh=oCfTnpGQux7UbJWIMNwehBcpINXuiR7KgQhdGoP3FGk=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=UNOSmkDK3VBXadyPkddU/2pAt/1UswhORn/RjN22k2cDPXdjqvyTeFRqbmll16JPI b+5huyoQrT7nKpeU4tOCCKtrmMFuprjqcz76T5XXAauNtiyi1QNHDdcUFmIQcSWqFw bzQcb2da6aAoOcphtBum4QgsgrhDRad4D5WjhB4PyaFiiEmYJEb2u2aaOnAkxlBFHv ffOLUPqN4qY84Ku/BYp/1gS1Oa1ZrfQ9QHXO98KNTjfwVVrA8AcwDRgSrx7MTDZhpB KJXkc/UCBPxZZheVl27mNw2vAEIbwHhrX8aVV/w9HgxPxP6z8oPCzQxVHZMBTUFKUv KkbyhbffvdaeA== Received: from mail01.iro.umontreal.ca (unknown [172.31.2.1]) by pmg1.iro.umontreal.ca (Proxmox) with ESMTP id A22A110002E; Fri, 18 Apr 2025 14:03:53 -0400 (EDT) Received: from alfajor (unknown [23.233.149.155]) by mail01.iro.umontreal.ca (Postfix) with ESMTPSA id 721781203C3; Fri, 18 Apr 2025 14:03:53 -0400 (EDT) From: Stefan Monnier To: Philip Kaludercic Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: Message-ID: References: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> <87y13j7djp.fsf@posteo.net> <86ikunh5kg.fsf@gnu.org> <87ldzifxx2.fsf@posteo.net> <86zfnyfug8.fsf@gnu.org> <87ploutu5a.fsf@posteo.net> Date: Fri, 18 Apr 2025 14:03:52 -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.209 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 KAM_SHORT 0.001 Use of a URL Shortener for very short URL X-SPAM-LEVEL: X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 73425 Cc: Eli Zaretskii , Robert Weiner , me@eshelyaron.com, 73425@debbugs.gnu.org, Mats Lidell X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > AFAICT, the plan is as follows: > > - Add support in package specs for "associated files" for each of the > manuals (ideally also for the `:readme`, BTW). OK, I added a `:doc-files` thingy. Currently it can be a list of file or dir names, and if it's a dir we copy all the files in it (but not recursively). > - Arrange to copy those "associated files" to the `doc//` > subdirectory of the `archive(-devel)/` area. Done. > - Massage the HTML files so that `href="snapshot.png"` becomes > `href="/snapshot.png"`. For the `:readme` case, we should > instead redirect them to `doc//snapshot.png`. Done to some extent but I'm not completely sure what to do with the Kubed manual (and I haven't looked at the `:readme` case at all). Eshel: could you explain to me the "/assets" thingy in the references to images in the Texi (and resulting HTML)? > This should make the HTML links to images work in the web versions of > the manuals. And indeed it seems to work for Hyerpbole. Mats&Robert: please check http://elpa.gnu.org/devel/doc/hyperbole.html > - Offer a way to specify part of the package specs directly in the > package itself (presumably within the pseudo-headers of the main > file). Would be useful in general rather than just for "associated > files". Not there yet. > - Maybe also offer some support to generate the list of associated files > dynamically/automatically by scrubbing the generated HTML files? Even less there yet. > - Make sure the links to associated files work also for the Info > versions of the manuals, even when they're moved to the > root directory. Not there yet either. Stefan From debbugs-submit-bounces@debbugs.gnu.org Fri Apr 18 17:35:58 2025 Received: (at 73425) by debbugs.gnu.org; 18 Apr 2025 21:35:58 +0000 Received: from localhost ([127.0.0.1]:53134 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u5tNN-0005gH-Eh for submit@debbugs.gnu.org; Fri, 18 Apr 2025 17:35:58 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:43872) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u5tNI-0005eU-Md for 73425@debbugs.gnu.org; Fri, 18 Apr 2025 17:35:54 -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 ) id 1u5tNB-000097-2Q; Fri, 18 Apr 2025 17:35:45 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:Date:References:In-Reply-To:Subject:To: From; bh=LH2qdAXMTkQDewXibpk8q12cn5ooxo7s5aonwb//4Xw=; b=JRr4ww7gKwA3UPLh+/QS Nf5JEjGi+rfmaTmgVC+Nf+XxLl9q3kaRl0ynq5NXPLd1JMiSGQOrbxy324K4coiLauhVJPxwyir29 e0JNNUR62UvpLwZyEE4iygaaMhV2Bnr57bnGw9LSwScisCLy5w1YIzYNg74QMxbzwUkpce5bWPBZ2 XhNmY8ElTxf6dAN5qX9lOFpHfm0UcJ9Rv0MgHyE0wBHJuFRXXcexV3AxhrXwiWuOU453/R8HwPHRm gfZyH7Al3KviKCfy2UhbitszCmKtgMhizFSg/BG7nBkaDXqVIU8Qk/vZoxiZ73h8KUaj/8g9lT7ar S89+QHDcWou4Sw==; From: Mats Lidell To: Stefan Monnier Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: References: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> <87y13j7djp.fsf@posteo.net> <86ikunh5kg.fsf@gnu.org> <87ldzifxx2.fsf@posteo.net> <86zfnyfug8.fsf@gnu.org> <87ploutu5a.fsf@posteo.net> Date: Fri, 18 Apr 2025 23:35:38 +0200 Message-ID: <8734e5taol.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 73425 Cc: Philip Kaludercic , Robert Weiner , me@eshelyaron.com, Eli Zaretskii , 73425@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > Stefan Monnier writes: > And indeed it seems to work for Hyerpbole. > Mats&Robert: please check http://elpa.gnu.org/devel/doc/hyperbole.html It looks OK, sort of. Two comments: - We use another css which is stored on the same level as the texi-file, in the man-folder. The css is missed and a "standard" css is used instead. So the formatting is not the expected but it is not bad. I guess having different css for each package will add some extra complexity, it has to be passed to the texinfo command line I think, but might be possible to support? WDYT? Not to mention that our css is for texinfo 7 so not sure how that would look with texinfo 6.8 that is currently used on ELPA. - I got the impression that the images would be copied to a flat structure. Looking in the generated html it looks like the file structure is kept. Was that the intention? Example: That src works so it is fine. Just want to check that there is no unintended magic going on here. >> - Make sure the links to associated files work also for the Info >> versions of the manuals, even when they're moved to the >> root directory. > Not there yet either. For hyperbole it should work to lift the "man/im" folder one level up. No need to manipulate the texi nor info files for that. Just keep the relative distance and install them one level up. Is that what you are planning to do? %% Mats From debbugs-submit-bounces@debbugs.gnu.org Fri Apr 18 18:58:02 2025 Received: (at 73425) by debbugs.gnu.org; 18 Apr 2025 22:58:03 +0000 Received: from localhost ([127.0.0.1]:53220 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u5uen-0003xD-2R for submit@debbugs.gnu.org; Fri, 18 Apr 2025 18:58:02 -0400 Received: from mailscanner.iro.umontreal.ca ([132.204.25.50]:59293) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u5uej-0003vS-K8 for 73425@debbugs.gnu.org; Fri, 18 Apr 2025 18:57:59 -0400 Received: from pmg3.iro.umontreal.ca (localhost [127.0.0.1]) by pmg3.iro.umontreal.ca (Proxmox) with ESMTP id 044184423B4; Fri, 18 Apr 2025 18:57:51 -0400 (EDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=iro.umontreal.ca; s=mail; t=1745017065; bh=jpytGxdyIUPcdQrzsazUsUcZAgj+uDdWlu+fNM9T2us=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=blMIGyVnte/9aVVIpV+jac1n0Veftxc2irhWBLcGI18ulL9Vl7ZUrHUWkA52PBGX+ Vnhgp4YwVcHpf9PPTqxkDAc0JZq69N88IOd071hvfYFzrnSZ9ssOem40V+mOqJLOh7 WzUM1OswOEDHAF4rDNgHHEmJ1w+VP4liJNFf7B1FSiPDXy2oJ3jlRxCkMXPoD24ts0 boThxefe7cKns7EG9tZxgkqRMmsU1CsOSkJ2gHMZB9vDrYJXu6ZLybQHHDTX+S94jc UyItnCm1RESCODomi0B+ykwYPxQnWmsAsDDZmWJRtU1Q4yo3Ns6cSwRj4ZaushDjRP 3QSzEwaSHlSsg== Received: from mail01.iro.umontreal.ca (unknown [172.31.2.1]) by pmg3.iro.umontreal.ca (Proxmox) with ESMTP id 4AD5144246D; Fri, 18 Apr 2025 18:57:45 -0400 (EDT) Received: from pastel (104-195-239-180.cpe.teksavvy.com [104.195.239.180]) by mail01.iro.umontreal.ca (Postfix) with ESMTPSA id 08E1E1201C3; Fri, 18 Apr 2025 18:57:45 -0400 (EDT) From: Stefan Monnier To: Mats Lidell Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: <8734e5taol.fsf@gnu.org> Message-ID: References: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> <87y13j7djp.fsf@posteo.net> <86ikunh5kg.fsf@gnu.org> <87ldzifxx2.fsf@posteo.net> <86zfnyfug8.fsf@gnu.org> <87ploutu5a.fsf@posteo.net> <8734e5taol.fsf@gnu.org> Date: Fri, 18 Apr 2025 18:57:44 -0400 User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-SPAM-INFO: Spam detection results: 0 ALL_TRUSTED -1 Passed through trusted hosts only via SMTP AWL -0.024 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 KAM_SHORT 0.001 Use of a URL Shortener for very short URL X-SPAM-LEVEL: X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 73425 Cc: Philip Kaludercic , Robert Weiner , me@eshelyaron.com, Eli Zaretskii , 73425@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > - We use another css which is stored on the same level as the texi-file,= in > the man-folder. The css is missed and a "standard" css is used instead= . So > the formatting is not the expected but it is not bad. We use our own CSS for all the Texinfo manuals, indeed. [ Well, it's not exactly "our own", it's stolen from www.gnu.org/software, IIRC. ] > I guess having different css for each package will add some extra > complexity, it has to be passed to the texinfo command line I think, b= ut > might be possible to support? WDYT? I think it heavily depends on the purpose. If your CSS has something specific to Hyperbole, then it would be nice to support that in some way, but otherwise it seems better to use the same CSS for all the (Non)GNU ELPA manuals. > - I got the impression that the images would be copied to a flat > structure. Looking in the generated html it looks like the file struct= ure > is kept. Was that the intention? > > Example: > > That src works so it is fine. Just want to check that there is no > unintended magic going on here. I wrote the code under the assumption that the HTML would use file names relative that "work in place", i.e. that are relative to the location of the source file. For that reason, the files are copied in a way that tries to preserve the directory structure. This hopefully also avoids name conflicts. >>> - Make sure the links to associated files work also for the Info >>> versions of the manuals, even when they're moved to the >>> root directory. >> Not there yet either. > For hyperbole it should work to lift the "man/im" folder one level up. No= need > to manipulate the texi nor info files for that. Just keep the relative > distance and install them one level up. Is that what you are planning to = do? I haven't looked closely, but it's one of the options I'd consider, yes. Currently for the HTML, I do a search&replace directly on the HTML (in a naive way, sadly), but it's not so easy to do on the Info file because it contains "inner pointers" which would need to be adjusted. Moving the image files like you propose would avoid that problem, but it comes with another downside: it would break the references to those same image files contained in the HTML and Texinfo manual bundled in the tarball. To get both to work correctly, we'd need to *copy* (rather than move) those files, which would bloat the tarball a bit more. Another option is to modify the Texinfo before we generate the Info. This seems more cumbersome to do with the current code but would avoid both of those problems. The overall cleaner option might be not to move the Info file. It's currently not supported by the ELPA protocol, so we'd have to "do it by hand". This means adding code in the `-autoloads.el` file to tweak `Info-directory-list`, but since we don't get to generate the `-autoloads.el` ourselves, we'd have instead to tweak some *other* file so as to cause the end-user's Emacs to generate a `-autoloads.el` with the appropriate tweak to `Info-directory-list`. =F0=9F=99=81 Stefan From debbugs-submit-bounces@debbugs.gnu.org Fri Apr 18 23:05:49 2025 Received: (at 73425) by debbugs.gnu.org; 19 Apr 2025 03:05:49 +0000 Received: from localhost ([127.0.0.1]:54468 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u5yWa-0006fh-Sl for submit@debbugs.gnu.org; Fri, 18 Apr 2025 23:05:49 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:48378) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u5yWX-0006fO-OT for 73425@debbugs.gnu.org; Fri, 18 Apr 2025 23:05:46 -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 ) id 1u5yWR-0008Jf-Sy for 73425@debbugs.gnu.org; Fri, 18 Apr 2025 23:05:40 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=To:Subject:Date:From:In-Reply-To:References: MIME-Version; bh=QxBDZIpyQvwigg7wYgqJr785BJoiyAhnD6y4ITN1mvQ=; b=qsM2xQ2lVdBb WBlPPkmGsWAvdDqOMgzpNOzLnqb+TLp/0Bt0z/P2DkR8Fgnt+bogr7iZFeWR0Ay8+FInPak5M6C+F YqQS0KsQ8B6ktXTEJN3qFZXenFqpCEjWj0GwuLPYt6eY+VaBPUMsmoTOveC1r0Rv2ngEoYyksnZZU pdtTzZFj932uT6wDsZlP3HbFSTspFnfsjoOCvc3Z/uukxmiasqb+JlahZMuSiJl2aKjDgRV4MOpAV aqNqeHfiVn8mOFsitPIWYMSHQYQgEAoWGq2d+5QOYysKY+MP9Grm02F2vgsFQFm5IA4cv28Trt2OR t3E+i+WawABvYnmzkTJhbA==; X-Forwarded-Encrypted: i=1; AJvYcCXVXBfNtP2++Ncsma3YLaMi2UKrfd3dUTC//cSTzOLuEAArRtT5QhNiWhLdYsG4vDl3oarvDg==@debbugs.gnu.org X-Gm-Message-State: AOJu0YzkK5jbI/2yOucgQfh2ljtX4vQnyYFZRnvjHd6UxSug9PR8ODep n39u4FJjfRjMUXd+/vOBfbD/fE3+3Ro7MHTBSU/pCVQ7nnEI55IA9vifYVIHlcRdyttcuSBLZh3 l+dsM+aCEyajZ+fDG8sTPf+Lu1lc= X-Google-Smtp-Source: AGHT+IFpne4Z7O97YU8RiRKgQutGv+aJTMCocGFfBqFw88arrdG4u5gNL3jTcPR07cXhrvZGRxmIiLUuRXppJFq7vC0= X-Received: by 2002:a05:6122:220a:b0:528:f40f:347f with SMTP id 71dfb90a1353d-529253b8d26mr4210622e0c.2.1745031938595; Fri, 18 Apr 2025 20:05:38 -0700 (PDT) MIME-Version: 1.0 References: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> <87y13j7djp.fsf@posteo.net> <86ikunh5kg.fsf@gnu.org> <87ldzifxx2.fsf@posteo.net> <86zfnyfug8.fsf@gnu.org> <87ploutu5a.fsf@posteo.net> <8734e5taol.fsf@gnu.org> In-Reply-To: From: Robert Weiner Date: Fri, 18 Apr 2025 23:05:12 -0400 X-Gmail-Original-Message-ID: X-Gm-Features: ATxdqUEL09zcCzBudsuHvBNabZ8gUACBx4IqvBa_9Vp6SG8W-1NfqqSkyltUo6g Message-ID: Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals To: Stefan Monnier Content-Type: multipart/alternative; boundary="000000000000d26a70063318e8bb" X-Spam-Score: 0.2 (/) X-Debbugs-Envelope-To: 73425 Cc: me@eshelyaron.com, Mats Lidell , Eli Zaretskii , Philip Kaludercic , 73425@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: rswgnu@gmail.com Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) --000000000000d26a70063318e8bb Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Hi Stefan: For Hyperbole with regard to use of our hyperbole.css file, if you prefer that all the Elpa manuals use the same css, then that is fine with us. The main reason for our new css file was to add a decent style for reading the manual on mobile phone-sized devices, but the Elpa css seems to work fine there now, so no issue there. Cheers, Bob On Fri, Apr 18, 2025 at 6:57=E2=80=AFPM Stefan Monnier wrote: > > - We use another css which is stored on the same level as the > texi-file, in > > the man-folder. The css is missed and a "standard" css is used > instead. So > > the formatting is not the expected but it is not bad. > > We use our own CSS for all the Texinfo manuals, indeed. > [ Well, it's not exactly "our own", it's stolen from > www.gnu.org/software, IIRC. ] > > > I guess having different css for each package will add some extra > > complexity, it has to be passed to the texinfo command line I think, > but > > might be possible to support? WDYT? > > I think it heavily depends on the purpose. If your CSS has something > specific to Hyperbole, then it would be nice to support that in some > way, but otherwise it seems better to use the same CSS for all the > (Non)GNU ELPA manuals. > > > - I got the impression that the images would be copied to a flat > > structure. Looking in the generated html it looks like the file > structure > > is kept. Was that the intention? > > > > Example: src=3D"hyperbole/man/im/hyperbole-cv.png"> > > > > That src works so it is fine. Just want to check that there is no > > unintended magic going on here. > > I wrote the code under the assumption that the HTML would use file names > relative that "work in place", i.e. that are relative to the location of > the source file. For that reason, the files are copied in a way that > tries to preserve the directory structure. This hopefully also avoids > name conflicts. > > >>> - Make sure the links to associated files work also for the Info > >>> versions of the manuals, even when they're moved to the > >>> root directory. > >> Not there yet either. > > For hyperbole it should work to lift the "man/im" folder one level up. > No need > > to manipulate the texi nor info files for that. Just keep the relative > > distance and install them one level up. Is that what you are planning t= o > do? > > I haven't looked closely, but it's one of the options I'd consider, yes. > Currently for the HTML, I do a search&replace directly on the HTML (in > a naive way, sadly), but it's not so easy to do on the Info file because > it contains "inner pointers" which would need to be adjusted. > > Moving the image files like you propose would avoid that problem, but it > comes with another downside: it would break the references to those same > image files contained in the HTML and Texinfo manual bundled in the > tarball. To get both to work correctly, we'd need to *copy* (rather > than move) those files, which would bloat the tarball a bit more. > > Another option is to modify the Texinfo before we generate the Info. > This seems more cumbersome to do with the current code but would avoid > both of those problems. > > The overall cleaner option might be not to move the Info file. > It's currently not supported by the ELPA protocol, so we'd have to "do > it by hand". This means adding code in the `-autoloads.el` file to > tweak `Info-directory-list`, but since we don't get to generate the > `-autoloads.el` ourselves, we'd have instead to tweak some *other* > file so as to cause the end-user's Emacs to generate a `-autoloads.e= l` > with the appropriate tweak to `Info-directory-list`. =F0=9F=99=81 > > > Stefan > > --000000000000d26a70063318e8bb Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
Hi Stefan:

For Hyperbole with regard to use of our hype= rbole.css file, if you prefer that all the Elpa manuals use the same css, t= hen that is fine with us.=C2=A0 The main reason for our new css file was to= add a decent style for reading the manual on mobile phone-sized devices, b= ut the Elpa css seems to work fine there now, so no issue there.

Che= ers,

Bob


On Fri, Apr 18, 2025 at 6:= 57=E2=80=AFPM Stefan Monnier <monnier@iro.umontreal.ca> wrote:
>=C2=A0 - We use another css which is stored o= n the same level as the texi-file, in
>=C2=A0 =C2=A0 the man-folder. The css is missed and a "standard&qu= ot; css is used instead. So
>=C2=A0 =C2=A0 the formatting is not the expected but it is not bad.

We use our own CSS for all the Texinfo manuals, indeed.
[ Well, it's not exactly "our own", it's stolen from
=C2=A0 www.gnu.org/software, IIRC.=C2=A0 ]

>=C2=A0 =C2=A0 I guess having different css for each package will add so= me extra
>=C2=A0 =C2=A0 complexity, it has to be passed to the texinfo command li= ne I think, but
>=C2=A0 =C2=A0 might be possible to support? WDYT?

I think it heavily depends on the purpose.=C2=A0 If your CSS has something<= br> specific to Hyperbole, then it would be nice to support that in some
way, but otherwise it seems better to use the same CSS for all the
(Non)GNU ELPA manuals.

>=C2=A0 - I got the impression that the images would be copied to a flat=
>=C2=A0 =C2=A0 structure. Looking in the generated html it looks like th= e file structure
>=C2=A0 =C2=A0 is kept. Was that the intention?
>
>=C2=A0 =C2=A0 Example: <img name=3D"Hyperbole Screenshot" = src=3D"hyperbole/man/im/hyperbole-cv.png">
>
>=C2=A0 =C2=A0 That src works so it is fine. Just want to check that the= re is no
>=C2=A0 =C2=A0 unintended magic going on here.

I wrote the code under the assumption that the HTML would use file names relative that "work in place", i.e. that are relative to the loca= tion of
the source file.=C2=A0 For that reason, the files are copied in a way that<= br> tries to preserve the directory structure.=C2=A0 This hopefully also avoids=
name conflicts.

>>> - Make sure the links to associated files work also for the In= fo
>>>=C2=A0 =C2=A0versions of the manuals, even when they're mov= ed to the
>>>=C2=A0 =C2=A0root directory.
>> Not there yet either.
> For hyperbole it should work to lift the "man/im" folder one= level up. No need
> to manipulate the texi nor info files for that. Just keep the relative=
> distance and install them one level up. Is that what you are planning = to do?

I haven't looked closely, but it's one of the options I'd consi= der, yes.
Currently for the HTML, I do a search&replace directly on the HTML (in<= br> a naive way, sadly), but it's not so easy to do on the Info file becaus= e
it contains "inner pointers" which would need to be adjusted.

Moving the image files like you propose would avoid that problem, but it comes with another downside: it would break the references to those same image files contained in the HTML and Texinfo manual bundled in the
tarball.=C2=A0 To get both to work correctly, we'd need to *copy* (rath= er
than move) those files, which would bloat the tarball a bit more.

Another option is to modify the Texinfo before we generate the Info.
This seems more cumbersome to do with the current code but would avoid
both of those problems.

The overall cleaner option might be not to move the Info file.
It's currently not supported by the ELPA protocol, so we'd have to = "do
it by hand".=C2=A0 This means adding code in the `<PKG>-autoload= s.el` file to
tweak `Info-directory-list`, but since we don't get to generate the
`<PKG>-autoloads.el` ourselves, we'd have instead to tweak some *= other*
file so as to cause the end-user's Emacs to generate a `<PKG>-aut= oloads.el`
with the appropriate tweak to `Info-directory-list`.=C2=A0 =F0=9F=99=81


=C2=A0 =C2=A0 =C2=A0 =C2=A0 Stefan

--000000000000d26a70063318e8bb-- From debbugs-submit-bounces@debbugs.gnu.org Sat Apr 19 02:40:27 2025 Received: (at 73425) by debbugs.gnu.org; 19 Apr 2025 06:40:28 +0000 Received: from localhost ([127.0.0.1]:56321 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u61sH-00008m-04 for submit@debbugs.gnu.org; Sat, 19 Apr 2025 02:40:27 -0400 Received: from mout01.posteo.de ([185.67.36.65]:39475) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u61sC-00007m-42 for 73425@debbugs.gnu.org; Sat, 19 Apr 2025 02:40:22 -0400 Received: from submission (posteo.de [185.67.36.169]) by mout01.posteo.de (Postfix) with ESMTPS id 83E7D240027 for <73425@debbugs.gnu.org>; Sat, 19 Apr 2025 08:40:12 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1745044813; bh=g/DGRtPKDiisZYLPrgZS4erJxo/EEptkBuEKW/gPv50=; h=From:To:Cc:Subject:Autocrypt:OpenPGP:Date:Message-ID:MIME-Version: Content-Type:From; b=PozVHsfh02IChJY+lmB3rPUSBvBDHnG0sOljbKqwYSZ9+Ne4Jb+auESWvwf7xDzd2 25liJzavphmR8Ss8mdsGVzSNo/wGgUYmVoJkBqrABoHjbkRwdrZmeGZS2OKRteeCiS QCmYdHRW4X7EmQGl7XakMrSecCZYhES4xR4LRItMMG2i2w+sFRWELZjhOUQhpO5U4v OdphClNTLY+AY8yqp5P1pB5ccIqQktypOv4JkSKcEkiWdom6CyKVEhPvPxPh7bs3pX QWqfv+squ50UXsHPpXz27yJw2UXvLKodX5v6Le180kTrFTkWGfpEd1mi7K73SSXvkd Su5a/FWHK9HHg== Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4Zfhp16d8rz6tsb; Sat, 19 Apr 2025 08:40:09 +0200 (CEST) From: Philip Kaludercic To: Stefan Monnier Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: References: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> <87y13j7djp.fsf@posteo.net> <86ikunh5kg.fsf@gnu.org> <87ldzifxx2.fsf@posteo.net> <86zfnyfug8.fsf@gnu.org> <87ploutu5a.fsf@posteo.net> Autocrypt: addr=philipk@posteo.net; 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: Sat, 19 Apr 2025 06:40:09 +0000 Message-ID: <8734e4psc6.fsf@posteo.net> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 73425 Cc: Eli Zaretskii , Robert Weiner , me@eshelyaron.com, 73425@debbugs.gnu.org, Mats Lidell X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Stefan Monnier writes: >> AFAICT, the plan is as follows: >> >> - Add support in package specs for "associated files" for each of the >> manuals (ideally also for the `:readme`, BTW). > > OK, I added a `:doc-files` thingy. > Currently it can be a list of file or dir names, and if it's a dir we > copy all the files in it (but not recursively). Just to be sure I didn't miss something, this only relates to the generation of HTML docs for elpa.{,non}gnu.org, right? So we don't need any special handling for package-vc? >> - Arrange to copy those "associated files" to the `doc//` >> subdirectory of the `archive(-devel)/` area. > > Done. > >> - Massage the HTML files so that `href="snapshot.png"` becomes >> `href="/snapshot.png"`. For the `:readme` case, we should >> instead redirect them to `doc//snapshot.png`. > > Done to some extent but I'm not completely sure what to do with the > Kubed manual (and I haven't looked at the `:readme` case at all). > > Eshel: could you explain to me the "/assets" thingy in the references > to images in the Texi (and resulting HTML)? > >> This should make the HTML links to images work in the web versions of >> the manuals. > > And indeed it seems to work for Hyerpbole. > Mats&Robert: please check http://elpa.gnu.org/devel/doc/hyperbole.html > >> - Offer a way to specify part of the package specs directly in the >> package itself (presumably within the pseudo-headers of the main >> file). Would be useful in general rather than just for "associated >> files". > > Not there yet. > >> - Maybe also offer some support to generate the list of associated files >> dynamically/automatically by scrubbing the generated HTML files? > > Even less there yet. > >> - Make sure the links to associated files work also for the Info >> versions of the manuals, even when they're moved to the >> root directory. > > Not there yet either. > > > Stefan From debbugs-submit-bounces@debbugs.gnu.org Sat Apr 19 03:11:08 2025 Received: (at 73425) by debbugs.gnu.org; 19 Apr 2025 07:11:08 +0000 Received: from localhost ([127.0.0.1]:56624 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u62Lz-0003z8-R4 for submit@debbugs.gnu.org; Sat, 19 Apr 2025 03:11:08 -0400 Received: from mail.eshelyaron.com ([107.175.124.16]:57504 helo=eshelyaron.com) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u62Lu-0003yb-1A for 73425@debbugs.gnu.org; Sat, 19 Apr 2025 03:11:05 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=eshelyaron.com; s=mail; t=1745046661; bh=zfYBk3xGpRBSF0a9MwENA7xfQ9o4B/JT02+5kta92cA=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=udgYUY0WkuB0pKHl6URFYdQXN3+3fCcE6SKXm+nQeyN3jaKj7p732BHFIKbp7awKb PFYP8/e5n+jzytTx1y14F4530rR/6a8Wwmj366F0SF2fAzMiIMpYlOC1CgKl0bKPRN a7lKyG0qGB4YqOhAmQTtzUMWzcG7oSIMcD5KEAy7+CJTHCpWuDIzkgO186+wpJ6Uxb G9HUpniu9gG77FR/v7C7BfKFeh0cpA1jHImF20cad4Fd5c6s3/2hTnwAmXOe38vDlT MLohNPvNVivR2oxyylsNxscAfygTw+E+rZnte1QJI+Ywc36wWVH+/Iatt77S48fcd0 la0j4VqRHRkOw== From: Eshel Yaron To: Stefan Monnier Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: References: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> <87y13j7djp.fsf@posteo.net> <86ikunh5kg.fsf@gnu.org> <87ldzifxx2.fsf@posteo.net> <86zfnyfug8.fsf@gnu.org> <87ploutu5a.fsf@posteo.net> Date: Sat, 19 Apr 2025 09:10:58 +0200 Message-ID: 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: Philip Kaludercic , Robert Weiner , Eli Zaretskii , Mats Lidell , 73425@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Hi Stefan, Stefan Monnier writes: >> AFAICT, the plan is as follows: >> >> - Add support in package specs for "associated files" for each of the >> manuals (ideally also for the `:readme`, BTW). > > OK, I added a `:doc-files` thingy. > Currently it can be a list of file or dir names, and if it's a dir we > copy all the files in it (but not recursively). > >> - Arrange to copy those "associated files" to the `doc//` >> subdirectory of the `archive(-devel)/` area. > > Done. > >> - Massage the HTML files so that `href="snapshot.png"` becomes >> `href="/snapshot.png"`. For the `:readme` case, we should >> instead redirect them to `doc//snapshot.png`. > > Done to some extent but I'm not completely sure what to do with the > Kubed manual (and I haven't looked at the `:readme` case at all). > > Eshel: could you explain to me the "/assets" thingy in the references > to images in the Texi (and resulting HTML)? So currently the way we include images in kubed.texi is as follows: --8<---------------cut here---------------start------------->8--- @ifhtml @float @image{/assets/kubed-overview,,,Image: Four different kinds of Kubed buffers in Emacs,.png} @caption{Pods, logs, shells, YAMLs, all in one integrated interface} @end float @end ifhtml --8<---------------cut here---------------end--------------->8--- This refers to https://eshelyaron.com/assets/kubed-overview.png I'd love to change these references to relative paths so they also work on the ELPA server, but I'm still not sure how to do that: we provide the manual at https://eshelyaron.com/kubed.html (all nodes in one page) and at https://eshelyaron.com/man/kubed/ (each node in a separate page). The image references need to work from these two different locations. That's easy to do with absolute references. With relative references, not so much... It would be nice if Texinfo allowed us to use different references depending on whether or not "--no-split" is in effect, but I couldn't find such an option. Any ideas/suggestions? >> This should make the HTML links to images work in the web versions of >> the manuals. > > And indeed it seems to work for Hyerpbole. > Mats&Robert: please check http://elpa.gnu.org/devel/doc/hyperbole.html Cool! Eshel From debbugs-submit-bounces@debbugs.gnu.org Sat Apr 19 03:16:12 2025 Received: (at 73425) by debbugs.gnu.org; 19 Apr 2025 07:16:12 +0000 Received: from localhost ([127.0.0.1]:56673 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u62Qu-0004ar-BJ for submit@debbugs.gnu.org; Sat, 19 Apr 2025 03:16:12 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:53632) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u62Qp-0004aP-J9 for 73425@debbugs.gnu.org; Sat, 19 Apr 2025 03:16: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 ) id 1u62Qj-0003EZ-IK; Sat, 19 Apr 2025 03:16:01 -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=TEt3WBmynbWQRTF0vA/OY0TclVWXXYNR4USCi3pK5Ig=; b=pqchK6hsGQ3j YoqcIa8Bs/MepyVS8KANEbP6RJmAjA5Iupnkm3Zv8ed0Ve69hUh9JqC9WYa0vDpVPRA2YfxkGmKrM Bc75luG/qY5HoP9T7PQipBjUQecJ+NaP9CDnJbK3q3ooc2EoRca9iiqBYtG7dkysMIYCo9RHdht4C lgvER9MAx63+mL7TuYilYgJrz1wD+d6ozOjx2qspBoY82zpZ+JEyQadEtgj2uK4vfVK8VtbKy8mBx x1IrpcBwRK79nL06zAjaMUF2VTjXkgDfx2L723gAJkM55pCfJTXXf/a3ZXsjduwPRe4qR55A0ix33 pMD+ItyldYiHCJrX+v14Xg==; Date: Sat, 19 Apr 2025 10:15:58 +0300 Message-Id: <86ldrwaafl.fsf@gnu.org> From: Eli Zaretskii To: Mats Lidell In-Reply-To: <8734e5taol.fsf@gnu.org> (message from Mats Lidell on Fri, 18 Apr 2025 23:35:38 +0200) Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals References: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> <87y13j7djp.fsf@posteo.net> <86ikunh5kg.fsf@gnu.org> <87ldzifxx2.fsf@posteo.net> <86zfnyfug8.fsf@gnu.org> <87ploutu5a.fsf@posteo.net> <8734e5taol.fsf@gnu.org> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 73425 Cc: philipk@posteo.net, rswgnu@gmail.com, me@eshelyaron.com, monnier@iro.umontreal.ca, 73425@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Mats Lidell > Cc: Philip Kaludercic , Eli Zaretskii , > 73425@debbugs.gnu.org, me@eshelyaron.com, Robert Weiner > > Date: Fri, 18 Apr 2025 23:35:38 +0200 > > - We use another css which is stored on the same level as the texi-file, in > the man-folder. The css is missed and a "standard" css is used instead. So > the formatting is not the expected but it is not bad. > > I guess having different css for each package will add some extra > complexity, it has to be passed to the texinfo command line I think, but > might be possible to support? WDYT? > > Not to mention that our css is for texinfo 7 so not sure how that would > look with texinfo 6.8 that is currently used on ELPA. Texinfo supports use of non-default CSS, see the node "HTML CSS" in the Texinfo manual. From debbugs-submit-bounces@debbugs.gnu.org Sat Apr 19 04:27:48 2025 Received: (at 73425) by debbugs.gnu.org; 19 Apr 2025 08:27:48 +0000 Received: from localhost ([127.0.0.1]:57399 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u63YC-0004R5-7N for submit@debbugs.gnu.org; Sat, 19 Apr 2025 04:27:48 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:53254) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u63Y6-0004QB-1R for 73425@debbugs.gnu.org; Sat, 19 Apr 2025 04:27:46 -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 ) id 1u63Xx-0003Ob-T0; Sat, 19 Apr 2025 04:27:33 -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=HBfudBR9AzUh7tLGe2WCvrjMMRi+fnq9qSqPhBJbjf4=; b=Oby13fYlbfyZ fiQsX2BsG0yhmUeKrlrF+Nu+N1HZlnhK0/PVmV4tU28mQDZhtBaCEAwuGB5jrH+KYthJ6eVXkF3Bh oFn4DXmmONLW+jK1Wu0tcVbVprj3mJ4yjbsCBIoH5ZhDsEJnaSi2Nm4nEHeGC8vexduPDkbNQR34D zCHTmAOW06evxglVEIhgwiBLa/gCfsgeyO8bh68hOLe5hG+UKBmju5Xcjq2w40DUoMtfUYK2zQH9h vQkxJc52epkuxRgc9pcIZHU+SQUTe8gBG+j16k8tKSh9tRpMBPdcGkzYkczsr9kV8aetHdCJ28WdX Z01Xa6Z8Zb8+ql85X8jecQ==; Date: Sat, 19 Apr 2025 11:27:30 +0300 Message-Id: <86a58ca74d.fsf@gnu.org> From: Eli Zaretskii To: Eshel Yaron In-Reply-To: (message from Eshel Yaron on Sat, 19 Apr 2025 09:10:58 +0200) Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals References: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> <87y13j7djp.fsf@posteo.net> <86ikunh5kg.fsf@gnu.org> <87ldzifxx2.fsf@posteo.net> <86zfnyfug8.fsf@gnu.org> <87ploutu5a.fsf@posteo.net> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 73425 Cc: philipk@posteo.net, rswgnu@gmail.com, monnier@iro.umontreal.ca, matsl@gnu.org, 73425@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Eshel Yaron > Cc: Philip Kaludercic , Eli Zaretskii , > 73425@debbugs.gnu.org, Mats Lidell , Robert Weiner > > Date: Sat, 19 Apr 2025 09:10:58 +0200 > > I'd love to change these references to relative paths so they also work > on the ELPA server, but I'm still not sure how to do that: we provide > the manual at https://eshelyaron.com/kubed.html (all nodes in one page) > and at https://eshelyaron.com/man/kubed/ (each node in a separate page). > The image references need to work from these two different locations. > That's easy to do with absolute references. With relative references, > not so much... It would be nice if Texinfo allowed us to use different > references depending on whether or not "--no-split" is in effect, but I > couldn't find such an option. > > Any ideas/suggestions? Use "@ifset foo" and "@ifclear foo", and build the docs with -Dfoo when you need it. From debbugs-submit-bounces@debbugs.gnu.org Sat Apr 19 10:06:38 2025 Received: (at 73425) by debbugs.gnu.org; 19 Apr 2025 14:06:40 +0000 Received: from localhost ([127.0.0.1]:34798 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u68q3-0007Go-Cb for submit@debbugs.gnu.org; Sat, 19 Apr 2025 10:06:36 -0400 Received: from mailscanner.iro.umontreal.ca ([132.204.25.50]:15401) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u68pz-0007GP-Gh for 73425@debbugs.gnu.org; Sat, 19 Apr 2025 10:06:32 -0400 Received: from pmg1.iro.umontreal.ca (localhost.localdomain [127.0.0.1]) by pmg1.iro.umontreal.ca (Proxmox) with ESMTP id 2D21310006B; Sat, 19 Apr 2025 10:06:25 -0400 (EDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=iro.umontreal.ca; s=mail; t=1745071584; bh=vYESDzg4TT/4jSgGo6SdS5GvLgLZEtf530qkUd0Zov0=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=MikPBn9xvxinagTUeELQoREijBaG/C2l6szNxj9FfKAGocLgaQO8Ey+K3W3lq5+cC pKFP7yOQ3knm9cPjbs9Yxq93cELHZy8CKZNZzu0yQbn9P2TWGHBYhMz6DD0L3pcovR yy8zt5Q+Di3qfg+ESxfkW1k9aEoTYQaR4MiohUtB4g+VxxWHt2hxKqmIR0bB/U5sYe XSOLCfEWVD/XNX9e2oOdZBbtvDoihm5fZqQ+eFgJkRZKR7pLWtwbY/gZtIywRcikLw MDb/XRKKPG7wqNNdQKKaE1ydSY5ahNKltoTLdQlkGEl7uElIX6cSRbc8XK03La49pY Ml0rOyDsMWzXQ== Received: from mail01.iro.umontreal.ca (unknown [172.31.2.1]) by pmg1.iro.umontreal.ca (Proxmox) with ESMTP id 8AE18100029; Sat, 19 Apr 2025 10:06:24 -0400 (EDT) Received: from pastel (104-195-239-180.cpe.teksavvy.com [104.195.239.180]) by mail01.iro.umontreal.ca (Postfix) with ESMTPSA id 54D3412009D; Sat, 19 Apr 2025 10:06:24 -0400 (EDT) From: Stefan Monnier To: Philip Kaludercic Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: <8734e4psc6.fsf@posteo.net> Message-ID: References: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> <87y13j7djp.fsf@posteo.net> <86ikunh5kg.fsf@gnu.org> <87ldzifxx2.fsf@posteo.net> <86zfnyfug8.fsf@gnu.org> <87ploutu5a.fsf@posteo.net> <8734e4psc6.fsf@posteo.net> Date: Sat, 19 Apr 2025 10:06:23 -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.118 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 , Robert Weiner , me@eshelyaron.com, 73425@debbugs.gnu.org, Mats Lidell X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) >>> AFAICT, the plan is as follows: >>> >>> - Add support in package specs for "associated files" for each of the >>> manuals (ideally also for the `:readme`, BTW). >> >> OK, I added a `:doc-files` thingy. >> Currently it can be a list of file or dir names, and if it's a dir we >> copy all the files in it (but not recursively). > > Just to be sure I didn't miss something, this only relates to the > generation of HTML docs for elpa.{,non}gnu.org, right? So we don't need > any special handling for package-vc? That's right (and this option is tentative: it may change or even disappear altogether). Stefan From debbugs-submit-bounces@debbugs.gnu.org Sat Apr 19 10:12:55 2025 Received: (at 73425) by debbugs.gnu.org; 19 Apr 2025 14:12:56 +0000 Received: from localhost ([127.0.0.1]:34877 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u68w8-0007qC-L4 for submit@debbugs.gnu.org; Sat, 19 Apr 2025 10:12:55 -0400 Received: from mailscanner.iro.umontreal.ca ([132.204.25.50]:53015) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u68w4-0007ow-TO for 73425@debbugs.gnu.org; Sat, 19 Apr 2025 10:12:49 -0400 Received: from pmg3.iro.umontreal.ca (localhost [127.0.0.1]) by pmg3.iro.umontreal.ca (Proxmox) with ESMTP id 40A68440BE2; Sat, 19 Apr 2025 10:12:43 -0400 (EDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=iro.umontreal.ca; s=mail; t=1745071962; bh=tVNR73rPLQAmWFC3Ry8+jvsqRgsYTVr1jEzb0Wg7N1Q=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=MiJM60sJIVd+SdJuXJjalZxFa5sk5q6SiEg3+2x62kZJAMctcXCFEcxrFUCt3mUVO x7FucXWGfevY17vKF90r+WzNeThmlb+8hT4U/jo+zwStT+o32KrcYN/y7/s4dzbAZT lzbLSqK0W/3up98HDi1CYN7jeFXSl6C9o5XYq+dSlOQ+touoASikna3Z6B4DyrIM55 ts6C4zltXWztiZGm8fpV9HB5hRkfML3F4z5IsVWdPblrqFGXJaCl/5zV2Q49BVaAy7 8ytPizzw1DOZt8gLMZfD7+KMwIVWT924MoHzb6z+Ghib5NoyyoB4POL6ESuyPE9e1u kzYSI7F3MZsXA== Received: from mail01.iro.umontreal.ca (unknown [172.31.2.1]) by pmg3.iro.umontreal.ca (Proxmox) with ESMTP id 0BE0C4409B3; Sat, 19 Apr 2025 10:12:42 -0400 (EDT) Received: from pastel (104-195-239-180.cpe.teksavvy.com [104.195.239.180]) by mail01.iro.umontreal.ca (Postfix) with ESMTPSA id C5650120656; Sat, 19 Apr 2025 10:12:41 -0400 (EDT) From: Stefan Monnier To: Eshel Yaron Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: Message-ID: References: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> <87y13j7djp.fsf@posteo.net> <86ikunh5kg.fsf@gnu.org> <87ldzifxx2.fsf@posteo.net> <86zfnyfug8.fsf@gnu.org> <87ploutu5a.fsf@posteo.net> Date: Sat, 19 Apr 2025 10:12:41 -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.023 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: Philip Kaludercic , Robert Weiner , Eli Zaretskii , Mats Lidell , 73425@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > So currently the way we include images in kubed.texi is as follows: > > --8<---------------cut here---------------start------------->8--- > @ifhtml > @float > @image{/assets/kubed-overview,,,Image: Four different kinds of Kubed buffers in Emacs,.png} > @caption{Pods, logs, shells, YAMLs, all in one integrated interface} > @end float > @end ifhtml > --8<---------------cut here---------------end--------------->8--- > > This refers to https://eshelyaron.com/assets/kubed-overview.png Ah, so it's something "personal", nice, thanks. I thought it could be some "standard convention" used on some system somewhere. > I'd love to change these references to relative paths so they also work > on the ELPA server, I guess our scripts could be told to strip away the "/assets/" part. I'll think about it. > but I'm still not sure how to do that: we provide > the manual at https://eshelyaron.com/kubed.html (all nodes in one page) > and at https://eshelyaron.com/man/kubed/ (each node in a separate page). > The image references need to work from these two different locations. If you change those to https://eshelyaron.com/man/kubed/ and https://eshelyaron.com/kubed/singlepage.html then relative file names should work fine, right? [ Obviously, it comes with its own problems. ] Stefan From debbugs-submit-bounces@debbugs.gnu.org Sun Apr 20 05:20:18 2025 Received: (at 73425) by debbugs.gnu.org; 20 Apr 2025 09:20:18 +0000 Received: from localhost ([127.0.0.1]:44988 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u6QqY-0000Qg-BO for submit@debbugs.gnu.org; Sun, 20 Apr 2025 05:20:18 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:41346) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u6QqV-0000KN-OP for 73425@debbugs.gnu.org; Sun, 20 Apr 2025 05:20:17 -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 ) id 1u6QqP-0003gw-KS; Sun, 20 Apr 2025 05:20:09 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:Date:References:In-Reply-To:Subject:To: From; bh=V2JaFwQ3Gd4o5+RCPRZ73T3Vgiu85vV701yOWyUWdNA=; b=igZgnS1mdx6PKQJ71YsO k1W//xM7PHHczpDagqc4caTFRx/JYsF5T7kDVXigBVqcsExL43U9eY6q8He5WwdkfiRuvAO2dZ2nt y3JOC1RWyH+fyKP0tcAGURI+krwrt30RYTeMsP+PWNetEFgKpagchqG/mBqsd+/Oc9dOW/dR56zyb RXV+eQWEz0wIhIp8OBBFVDZ/9ofHjgoXA6AyBZf2KyZ+hgjWyU64oDsMw0XMA3XRvV/Bco10h8fwe iLKiLkUh8rEL5EKXcsyIiqIGgVkVPSiYYbK5J2pJLXoTznHJDOfO4z2ZUG9d8JWQgbA0JkjaXHpoe fUZjogqvNU8c1w==; From: Mats Lidell To: Eli Zaretskii Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: <86ldrwaafl.fsf@gnu.org> References: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> <87y13j7djp.fsf@posteo.net> <86ikunh5kg.fsf@gnu.org> <87ldzifxx2.fsf@posteo.net> <86zfnyfug8.fsf@gnu.org> <87ploutu5a.fsf@posteo.net> <8734e5taol.fsf@gnu.org> <86ldrwaafl.fsf@gnu.org> Date: Sun, 20 Apr 2025 11:20:03 +0200 Message-ID: <878qnvtcjg.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 73425 Cc: philipk@posteo.net, rswgnu@gmail.com, me@eshelyaron.com, monnier@iro.umontreal.ca, 73425@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > Eli Zaretskii writes: > > From: Mats Lidell > > Cc: Philip Kaludercic , Eli Zaretskii , > > 73425@debbugs.gnu.org, me@eshelyaron.com, Robert Weiner > > > > Date: Fri, 18 Apr 2025 23:35:38 +0200 > > > > - We use another css which is stored on the same level as the texi-file, in > > the man-folder. The css is missed and a "standard" css is used instead. So > > the formatting is not the expected but it is not bad. > > > > I guess having different css for each package will add some extra > > complexity, it has to be passed to the texinfo command line I think, but > > might be possible to support? WDYT? > > > > Not to mention that our css is for texinfo 7 so not sure how that would > > look with texinfo 6.8 that is currently used on ELPA. > > Texinfo supports use of non-default CSS, see the node "HTML CSS" in > the Texinfo manual. Yes. We use that for the HTML we generate and bundle with Hyperbole. But that is "missed" when ELPA generates the HTML since it does not use the CSS we supply. However, I understand that having the same CSS for all manuals is a good idea and, as Bob pointed out in separate reply, the issues we had in the past seems to have been solved in that CSS. So we are good without my suggestion. %% Mats From debbugs-submit-bounces@debbugs.gnu.org Tue Apr 22 06:24:35 2025 Received: (at 73425) by debbugs.gnu.org; 22 Apr 2025 10:24:35 +0000 Received: from localhost ([127.0.0.1]:46029 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u7Anp-00062t-2W for submit@debbugs.gnu.org; Tue, 22 Apr 2025 06:24:34 -0400 Received: from mail.eshelyaron.com ([107.175.124.16]:55284 helo=eshelyaron.com) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u7Anj-00061g-QC for 73425@debbugs.gnu.org; Tue, 22 Apr 2025 06:24:30 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=eshelyaron.com; s=mail; t=1745317467; bh=Y4lhDigYoBnD1xMeFUY0Mnznc68dEWCd/xgauKu4LVs=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=fZfu7HW7viqj/WJ276fDKuHw2al+9LqTMYej3I9+MBXztMf9B171ksPEvHFX3Dp4m Auu8adsqFSQ283l8doGrhRMHUrS3Mvg6mXRBuTbpsOwWf+/OvZOBzzQfrxmmldwmkB jEq5xeRbyIhX9ph7h5nzUVQa3ekvltxG0+TsPt0lC2X7J0lVS5tXYmK5B87QWVKzDm +NuPAPnfDIoeLYIJVGkTLgiEiFje3sN/jZsdb1WWChcmucp/Orj+CMhpZYxlJUGDwv 4k9I88Sug3FqEmDFoaaPFH9hgIZLcjziQDs64cuNAXEBB/ADB9QefKL4ihHPsJS0lW kFlhMJzj9tyOg== From: Eshel Yaron To: Stefan Monnier Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: References: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> <87y13j7djp.fsf@posteo.net> <86ikunh5kg.fsf@gnu.org> <87ldzifxx2.fsf@posteo.net> <86zfnyfug8.fsf@gnu.org> <87ploutu5a.fsf@posteo.net> Date: Tue, 22 Apr 2025 12:24:24 +0200 Message-ID: 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: Philip Kaludercic , Robert Weiner , Eli Zaretskii , Mats Lidell , 73425@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Hi, Stefan Monnier writes: >> So currently the way we include images in kubed.texi is as follows: >> >> --8<---------------cut here---------------start------------->8--- >> @ifhtml >> @float >> @image{/assets/kubed-overview,,,Image: Four different kinds of Kubed buffers in Emacs,.png} >> @caption{Pods, logs, shells, YAMLs, all in one integrated interface} >> @end float >> @end ifhtml >> --8<---------------cut here---------------end--------------->8--- >> >> This refers to https://eshelyaron.com/assets/kubed-overview.png > > Ah, so it's something "personal", nice, thanks. I thought it could be > some "standard convention" used on some system somewhere. > >> I'd love to change these references to relative paths so they also work >> on the ELPA server, > > I guess our scripts could be told to strip away the "/assets/" part. > I'll think about it. Actually, Eli's suggestion to use @ifset and -Dfoo works pretty well :) So I don't think any special handling is required, as I can just change the image references to use relative paths and leverage @ifset to pick another relative path for the node-per-page case. After I'll make these changes in Kubed, we'll just need to update elpa-packages with something like: diff --git a/elpa-packages b/elpa-packages index e4ae18a4be..711d8ff986 100644 --- a/elpa-packages +++ b/elpa-packages @@ -477,7 +477,8 @@ ;; :readme "README") (kmb :url nil) (kubed :url "https://git.sr.ht/~eshel/kubed" - :doc "kubed.texi") + :doc "kubed.texi" + :doc-files ("assets/")) (landmark :url nil) (latex-table-wizard :url "https://github.com/enricoflor/latex-table-wizard" :doc "latex-table-wizard.texi") Thanks, Eshel From debbugs-submit-bounces@debbugs.gnu.org Tue Apr 22 09:19:48 2025 Received: (at 73425) by debbugs.gnu.org; 22 Apr 2025 13:19:48 +0000 Received: from localhost ([127.0.0.1]:46846 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u7DXP-0002U2-SH for submit@debbugs.gnu.org; Tue, 22 Apr 2025 09:19:48 -0400 Received: from mailscanner.iro.umontreal.ca ([132.204.25.50]:45611) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u7DXN-0002Tn-0J for 73425@debbugs.gnu.org; Tue, 22 Apr 2025 09:19:45 -0400 Received: from pmg1.iro.umontreal.ca (localhost.localdomain [127.0.0.1]) by pmg1.iro.umontreal.ca (Proxmox) with ESMTP id 1A8F8100034; Tue, 22 Apr 2025 09:19:39 -0400 (EDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=iro.umontreal.ca; s=mail; t=1745327978; bh=n9oVVA+nqpF7boZfPBIUqLknUsdKu1nIBhxG9UyivXE=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=C7eGqJ9AwVQDaROptVgDy490zqpyvZUK5u1D+N8kU0/OOaTLGvfQBT5Vs8zn10Djq AWQZhiAdnMPt/gaOEmI7iYi7bJ9ugFOCgHWtiJDq2vrK4U1HiMb8cI2YtKHlOVl0RE 1r7rDz7MigfDNBOu19QAGnxIwrgt+mSBCkmTW6exmcWnQC5RNcRkWKx3eudXjbbrLg 1gJmR9bmblE7/q0QnYK85cdoR8fYDheWJ/wnegsEuCi8NhK3wmaSr5eXguPt6sIX68 RxGnxpZRLY23MiSktN0zumncJVYJUOtcviQNJ2+SzCp7l5bRrV1SSyFwgptjT8+YTh fS7DQplrqsmNw== Received: from mail01.iro.umontreal.ca (unknown [172.31.2.1]) by pmg1.iro.umontreal.ca (Proxmox) with ESMTP id 0BE9D100027; Tue, 22 Apr 2025 09:19:38 -0400 (EDT) Received: from pastel (104-195-208-18.cpe.teksavvy.com [104.195.208.18]) by mail01.iro.umontreal.ca (Postfix) with ESMTPSA id C01191206CB; Tue, 22 Apr 2025 09:19:37 -0400 (EDT) From: Stefan Monnier To: Eshel Yaron Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: Message-ID: References: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> <87y13j7djp.fsf@posteo.net> <86ikunh5kg.fsf@gnu.org> <87ldzifxx2.fsf@posteo.net> <86zfnyfug8.fsf@gnu.org> <87ploutu5a.fsf@posteo.net> Date: Tue, 22 Apr 2025 09:19:37 -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.228 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 KAM_SHORT 0.001 Use of a URL Shortener for very short URL X-SPAM-LEVEL: X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 73425 Cc: Philip Kaludercic , Robert Weiner , Eli Zaretskii , Mats Lidell , 73425@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > (kubed :url "https://git.sr.ht/~eshel/kubed" > - :doc "kubed.texi") > + :doc "kubed.texi" > + :doc-files ("assets/")) Actually, `:doc-files` disappeared yesterday. Now it should "just work". That is: as long as the file names in the src="..." are relative to the place where the doc's source file is located. I can't see any `assets/` directory currently in the Kubed source code, so I can't judge whether that would work. Stefan From debbugs-submit-bounces@debbugs.gnu.org Tue Apr 22 09:58:14 2025 Received: (at submit) by debbugs.gnu.org; 22 Apr 2025 13:58:14 +0000 Received: from localhost ([127.0.0.1]:49062 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u7E8b-0004yx-Ed for submit@debbugs.gnu.org; Tue, 22 Apr 2025 09:58:14 -0400 Received: from lists.gnu.org ([2001:470:142::17]:34092) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u7E8R-0004yL-J0 for submit@debbugs.gnu.org; Tue, 22 Apr 2025 09:58:04 -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 ) id 1u7E8M-0004hK-14 for bug-gnu-emacs@gnu.org; Tue, 22 Apr 2025 09:57:58 -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 ) id 1u7E8J-0006Bq-Kp; Tue, 22 Apr 2025 09:57:57 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=eshelyaron.com; s=mail; t=1745330272; bh=AOfp4yF3eM/XOx/99DaSp4dVwIFrrI+z5f4RePdJTGA=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=C7jiao6OUCh95xX90CnF4bv/ERp4dILEXFT49lfHC1z/PJE/NPquoM/cwT+j8N7RA cfjHFmTUJJYLaF0bxxCv5db+Xohw8zMYjNo4AKD8fsz3J+BMyBjpMXWYw0auIQDpOx yaz9gKtQyVf5+CvavOyZ72sKnNSJKScUWQSocYE6pvxY8Ahw2TYepZ0CNEKQGQc1ma U+yARd2KhqNxaQIWqIbyJW3fKx9oUtYFcZ1IJm3Dygh2z8yZN/j34FtBxkx2+/hfYX d8F2nTyc/ZL8REKBWp6C+LzpFuBTJ6WhVcI0NO6ekaGxQ7OqvddmviOwmp9xBZ7Dln hDkfGZ2EM4v2w== From: Eshel Yaron To: Stefan Monnier via "Bug reports for GNU Emacs, the Swiss army knife of text editors" Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: References: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> <87y13j7djp.fsf@posteo.net> <86ikunh5kg.fsf@gnu.org> <87ldzifxx2.fsf@posteo.net> <86zfnyfug8.fsf@gnu.org> <87ploutu5a.fsf@posteo.net> Date: Tue, 22 Apr 2025 15:57:48 +0200 Message-ID: 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@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-Spam-Score: 0.9 (/) X-Debbugs-Envelope-To: submit Cc: Philip Kaludercic , 73425@debbugs.gnu.org, Stefan Monnier , Eli Zaretskii , Robert Weiner , Mats Lidell X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.1 (/) Stefan Monnier writes: >> (kubed :url "https://git.sr.ht/~eshel/kubed" >> - :doc "kubed.texi") >> + :doc "kubed.texi" >> + :doc-files ("assets/")) > > Actually, `:doc-files` disappeared yesterday. Now it should "just work". > > That is: as long as the file names in the src="..." are relative to the > place where the doc's source file is located. Nice! > I can't see any `assets/` directory currently in the Kubed source > code, so I can't judge whether that would work. Now there is :) Let's see how this works on elpa-devel. Eshel From debbugs-submit-bounces@debbugs.gnu.org Tue Apr 22 18:24:16 2025 Received: (at 73425) by debbugs.gnu.org; 22 Apr 2025 22:24:16 +0000 Received: from localhost ([127.0.0.1]:50413 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u7M2K-0004Um-Eh for submit@debbugs.gnu.org; Tue, 22 Apr 2025 18:24:16 -0400 Received: from mailscanner.iro.umontreal.ca ([132.204.25.50]:13520) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u7M2G-0004US-VO for 73425@debbugs.gnu.org; Tue, 22 Apr 2025 18:24:14 -0400 Received: from pmg3.iro.umontreal.ca (localhost [127.0.0.1]) by pmg3.iro.umontreal.ca (Proxmox) with ESMTP id 7FD63442621; Tue, 22 Apr 2025 18:24:06 -0400 (EDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=iro.umontreal.ca; s=mail; t=1745360645; bh=9yieUd/DVEs85fOH/gUqG9qwwTWEvLRQgeIFC9Ohlcs=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=KdVDTakeX4spqlANsEmmryJGURE3k8yu8QIGlAWCJ2+Z1wqDfx5Pl9M8HrZpVs3iJ /Oy8BwqW04yqeVrdx72dzS6BxYtq+5oJU3iP/ukuLjwzvytoa5eIqz3xuV1+tVupQN 74HxzJlC3qEZqYBgsiqS7gkPmKyQpLODx0gKM3+cMvQX5ro3JTTlBy5VLa1YiMITl6 h7KuIBr1dHKbwChB/cZ90cNPbBZ/8npdZXMHtFI3KMR/uGiv9YoKk/aAtUeauoB/SJ WtWMQv2solF4WuRoJFH3AX+Djg7wqF6RiWPNF+2X8cln1xF61Q4W7P5w8uL0ruOS6Z NMS+dqqTsTYwA== Received: from mail01.iro.umontreal.ca (unknown [172.31.2.1]) by pmg3.iro.umontreal.ca (Proxmox) with ESMTP id 8319544261E; Tue, 22 Apr 2025 18:24:05 -0400 (EDT) Received: from pastel (104-195-208-18.cpe.teksavvy.com [104.195.208.18]) by mail01.iro.umontreal.ca (Postfix) with ESMTPSA id 422D012067B; Tue, 22 Apr 2025 18:24:05 -0400 (EDT) From: Stefan Monnier To: Eshel Yaron Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: Message-ID: References: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> <87y13j7djp.fsf@posteo.net> <86ikunh5kg.fsf@gnu.org> <87ldzifxx2.fsf@posteo.net> <86zfnyfug8.fsf@gnu.org> <87ploutu5a.fsf@posteo.net> Date: Tue, 22 Apr 2025 18:24:03 -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.017 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: Philip Kaludercic , Robert Weiner , Eli Zaretskii , Mats Lidell , 73425@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > Now there is :) Let's see how this works on elpa-devel. So, how do you like the result? Stefan From debbugs-submit-bounces@debbugs.gnu.org Wed Apr 23 03:07:55 2025 Received: (at 73425) by debbugs.gnu.org; 23 Apr 2025 07:07:55 +0000 Received: from localhost ([127.0.0.1]:52190 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u7UD4-0000nE-VB for submit@debbugs.gnu.org; Wed, 23 Apr 2025 03:07:55 -0400 Received: from mail.eshelyaron.com ([107.175.124.16]:54356 helo=eshelyaron.com) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u7UD1-0000mt-NP for 73425@debbugs.gnu.org; Wed, 23 Apr 2025 03:07:52 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=eshelyaron.com; s=mail; t=1745392070; bh=OznoJ6X1UnRTVbt3+z0ixlrBHxuQrgXty5AkqA4TMNk=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=xHhR/zGocr6GVkGfJdVuM8g0jenQCwNvEIw/TtDFynx1V478WXWCRdkIOLsdukUEd Lv+YPKO35fa3oek0kNVNuSOr4ZGPUeGELkuLtJpJRdQMMB9hSHrdKAm3Bqz50aIHJ1 UgG6CnTQTJABZMBQOlEpe/y7N88TGuiqW0yTRDT2C5mDj+Qg2DZo1eq2B0iVOcyW4O HlkulZ54O1JKZgerK3wp7S/q01h48FcNzOepZD1B8y15GA2/hVd1dVxK66nPLxc7zh dfOjIo61K+4PQQKWFDQBq0CJVMlFMuBvX5QaFYkdtYO8uDEu0K3sNhzFV41Fib3+8I uX/WgIj/wCcvg== From: Eshel Yaron To: Stefan Monnier Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: References: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> <87y13j7djp.fsf@posteo.net> <86ikunh5kg.fsf@gnu.org> <87ldzifxx2.fsf@posteo.net> <86zfnyfug8.fsf@gnu.org> <87ploutu5a.fsf@posteo.net> Date: Wed, 23 Apr 2025 09:07:48 +0200 Message-ID: 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: Philip Kaludercic , Robert Weiner , Eli Zaretskii , Mats Lidell , 73425@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Stefan Monnier writes: >> Now there is :) Let's see how this works on elpa-devel. > > So, how do you like the result? Pretty neat! It's great that it Just Works like that. The images appear somewhat bigger than I'd like them to, but that's a secondary concern, and probably something I can tweak on my end. Thank you! Eshel From debbugs-submit-bounces@debbugs.gnu.org Wed Apr 23 10:29:21 2025 Received: (at 73425) by debbugs.gnu.org; 23 Apr 2025 14:29:21 +0000 Received: from localhost ([127.0.0.1]:58203 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u7b6F-0001rv-2l for submit@debbugs.gnu.org; Wed, 23 Apr 2025 10:29:20 -0400 Received: from mailscanner.iro.umontreal.ca ([132.204.25.50]:15198) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u7b62-0001ph-Bw for 73425@debbugs.gnu.org; Wed, 23 Apr 2025 10:29:10 -0400 Received: from pmg2.iro.umontreal.ca (localhost.localdomain [127.0.0.1]) by pmg2.iro.umontreal.ca (Proxmox) with ESMTP id 159DF80008; Wed, 23 Apr 2025 10:29:00 -0400 (EDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=iro.umontreal.ca; s=mail; t=1745418538; bh=Pq1lEuWnKYQKuvb8KnDB6qIbRSp+1Lzor/sWgBXt48A=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=OpMjWk5BUTmgBfR6X5MLEvJoicjR+2DhXDTp1IC0CIXfNAnFNu7xdSc1yLyu9VLqq axv5070Msvc3IZT6+p9g4iuDVF0RNhDhcFXmuNaSiXbULTzkrcaFlvAb3L1Y5BnW/M yZ8tpSkXFPoEVQopqbaKhK12Z3EgMm/itrrmqUdwoJ1pGQWUg0RZqzVCfWNVZWnOrl I3002s7fM/HdFLfAP6ujS1e0uCG/6se7vW7aG4R9tPM9vU2hV0Ifxlr8qVkZjMlMpt 1PnAsfFVcSNmKnMPaOES3lq9tkpX5CtTPis+b+q3Anck1lCtqcw6iPkGLJfWeQKaHU 8GonTOnVWSyqQ== Received: from mail01.iro.umontreal.ca (unknown [172.31.2.1]) by pmg2.iro.umontreal.ca (Proxmox) with ESMTP id 5C567802D2; Wed, 23 Apr 2025 10:28:58 -0400 (EDT) Received: from pastel (104-195-208-18.cpe.teksavvy.com [104.195.208.18]) by mail01.iro.umontreal.ca (Postfix) with ESMTPSA id F3B84120550; Wed, 23 Apr 2025 10:28:57 -0400 (EDT) From: Stefan Monnier To: Eshel Yaron Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: Message-ID: References: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> <87y13j7djp.fsf@posteo.net> <86ikunh5kg.fsf@gnu.org> <87ldzifxx2.fsf@posteo.net> <86zfnyfug8.fsf@gnu.org> <87ploutu5a.fsf@posteo.net> Date: Wed, 23 Apr 2025 10:28:57 -0400 User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-SPAM-INFO: Spam detection results: 0 ALL_TRUSTED -1 Passed through trusted hosts only via SMTP AWL -0.064 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: Philip Kaludercic , Robert Weiner , Eli Zaretskii , Mats Lidell , 73425@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) >> So, how do you like the result? > Pretty neat! It's great that it Just Works like that. > The images appear somewhat bigger than I'd like them to, but that's a > secondary concern, and probably something I can tweak on my end. Sizing images is definitely above my pay grade, =F0=9F=99=82 Stefan From debbugs-submit-bounces@debbugs.gnu.org Wed Apr 23 11:40:47 2025 Received: (at 73425) by debbugs.gnu.org; 23 Apr 2025 15:40:47 +0000 Received: from localhost ([127.0.0.1]:58394 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u7cDN-0006Dg-Vk for submit@debbugs.gnu.org; Wed, 23 Apr 2025 11:40:47 -0400 Received: from mout01.posteo.de ([185.67.36.65]:59035) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u7cDJ-0006C9-SD for 73425@debbugs.gnu.org; Wed, 23 Apr 2025 11:40:43 -0400 Received: from submission (posteo.de [185.67.36.169]) by mout01.posteo.de (Postfix) with ESMTPS id C8529240027 for <73425@debbugs.gnu.org>; Wed, 23 Apr 2025 17:40:34 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1745422835; bh=NFPWgT8/aXEXsz1188RnLGAaGQvXYCEUx0cpvrGjwbY=; h=From:To:Cc:Subject:Autocrypt:OpenPGP:Date:Message-ID:MIME-Version: Content-Type:From; b=hdiGYX1Z1YGUoQ5Z50FmCoUwO8l3BGMKG0zMfbhLTpN+cIas/v0ygbCaHdkbpuIp3 rV9JLeVM1KuK15av2tnyfMvgWWailAq47oNPKinVeLe9HlzPUzyqNSy9A29YUY0sjF NMybHtVYSmjYLpgLPPSqnBg3ZjK56IvVXGM/EAUfZoyke1fY2TxTPafSD++o7I7Vqb XX6xHQLntzSQgEfBlrPK26E9gwy6XeNgmk8VVGw5yV6BMBnICVHfr8FUNAIOV7vjf0 SVyZ6ovM+PnBsBLa2lo7dx1pukQl3CEdYr3dpJStX0kFS3kvmD/xaH4jPkTokz7U5q sFSsUqWyiXD5A== Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4ZjNbg4fzhz6twf; Wed, 23 Apr 2025 17:40:31 +0200 (CEST) From: Philip Kaludercic To: Stefan Monnier Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: References: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> <87y13j7djp.fsf@posteo.net> <86ikunh5kg.fsf@gnu.org> <87ldzifxx2.fsf@posteo.net> <86zfnyfug8.fsf@gnu.org> <87ploutu5a.fsf@posteo.net> Autocrypt: addr=philipk@posteo.net; 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: Wed, 23 Apr 2025 15:40:30 +0000 Message-ID: <87jz7a51jl.fsf@posteo.net> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 73425 Cc: Eli Zaretskii , Robert Weiner , Eshel Yaron , Mats Lidell , 73425@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Stefan Monnier writes: >>> So, how do you like the result? >> Pretty neat! It's great that it Just Works like that. >> The images appear somewhat bigger than I'd like them to, but that's a >> secondary concern, and probably something I can tweak on my end. What images are you referring to? From debbugs-submit-bounces@debbugs.gnu.org Wed Apr 23 13:06:21 2025 Received: (at 73425) by debbugs.gnu.org; 23 Apr 2025 17:06:21 +0000 Received: from localhost ([127.0.0.1]:58647 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u7dYC-0004yx-Li for submit@debbugs.gnu.org; Wed, 23 Apr 2025 13:06:21 -0400 Received: from mail.eshelyaron.com ([107.175.124.16]:45148 helo=eshelyaron.com) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u7dY9-0004yH-Ld for 73425@debbugs.gnu.org; Wed, 23 Apr 2025 13:06:19 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=eshelyaron.com; s=mail; t=1745427977; bh=aTuNVxWKfhsEpjHyU1aSukDbY7otWEAtfXCV+VUt5/M=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=IDbst+DAzF9Fkcbt07/XpzQ13EnJ89LC6T3ZUgkpQHkTBGXV1bJVKR0Cqu66XjESI mWTKOdZEAEfH7dfewzw9iGfHrUSxq0K8cOr7qaCnNXBMon9O7JqX7OxcghQf3bXc+d znZavKsZYnZiwPGpYqjXNURFeFaptDG1+gM9DA5pisWJnYS+U/f1FCiKYiv1PqfNb2 QPpu7iM2k2CZsYmhBYamIHONvL3BRK3Y3+2vAjB+oux8hgpIjrsNubwv94iTGpse9F koMARvVzTnTveJF/o05zKbKhoMTOq/ZX9kAuUdnXt6w8WYnvatEtdKrsChZ0lkaUEH MdQnLeDbTxj+g== From: Eshel Yaron To: Philip Kaludercic Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: <87jz7a51jl.fsf@posteo.net> References: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> <87y13j7djp.fsf@posteo.net> <86ikunh5kg.fsf@gnu.org> <87ldzifxx2.fsf@posteo.net> <86zfnyfug8.fsf@gnu.org> <87ploutu5a.fsf@posteo.net> <87jz7a51jl.fsf@posteo.net> Date: Wed, 23 Apr 2025 19:06:14 +0200 Message-ID: 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 , Robert Weiner , Stefan Monnier , Mats Lidell , 73425@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Hi Philip, Philip Kaludercic writes: > Stefan Monnier writes: > >>>> So, how do you like the result? >>> Pretty neat! It's great that it Just Works like that. >>> The images appear somewhat bigger than I'd like them to, but that's a >>> secondary concern, and probably something I can tweak on my end. > > What images are you referring to? Those that now appear in the HTML Kubed manual that ELPA generates. See https://elpa.gnu.org/devel/doc/kubed.html#Overview for example. Eshel From debbugs-submit-bounces@debbugs.gnu.org Wed Apr 23 13:11:11 2025 Received: (at 73425) by debbugs.gnu.org; 23 Apr 2025 17:11:12 +0000 Received: from localhost ([127.0.0.1]:58656 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u7dcq-0005uH-Su for submit@debbugs.gnu.org; Wed, 23 Apr 2025 13:11:11 -0400 Received: from mout02.posteo.de ([185.67.36.66]:45351) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u7dcl-0005s5-VN for 73425@debbugs.gnu.org; Wed, 23 Apr 2025 13:11:05 -0400 Received: from submission (posteo.de [185.67.36.169]) by mout02.posteo.de (Postfix) with ESMTPS id EBD8A240101 for <73425@debbugs.gnu.org>; Wed, 23 Apr 2025 19:10:57 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1745428257; bh=HHCAIe7Cv3dt5zQt9sBaL5vmLFlnYWnyzCSoAOdBK4U=; h=From:To:Cc:Subject:Autocrypt:OpenPGP:Date:Message-ID:MIME-Version: Content-Type:From; b=JKx9ZC915BeeXUgEQKOlgxBcpMw0TVidAvBdBuctzRPWvYDt/+gSBqmkoOS2BEKJc qMDST+/m+9cje5JHP315ZKtSmuJjwnoUBs4+jX/V6ily8h1Z06YD8jGLhBuBVvdB0x 2PceeHv4e7ghY5qdYY1lgRs8c1HYkP92+Lp9dR0Qjz93Ju1pY3e3rxvYL31ahXx/Vb UWVK1k0NKYDrGhJQ7QghpGhTFCLJCMp2iA3M2HBG6v9oIzvB7gEK/Fp4iqnLsQaBXC XEcOotaQ1DRwNQlp0ykX2cPPYNzmrhr/eCIJeb9Z7vchtocf+Ua//ySnjFZlv8pF2n TiC4RtvNHwMLw== Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4ZjQc02bQdz9rxD; Wed, 23 Apr 2025 19:10:55 +0200 (CEST) From: Philip Kaludercic To: Eshel Yaron Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: References: <86v7ynh9au.fsf@gnu.org> <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> <87y13j7djp.fsf@posteo.net> <86ikunh5kg.fsf@gnu.org> <87ldzifxx2.fsf@posteo.net> <86zfnyfug8.fsf@gnu.org> <87ploutu5a.fsf@posteo.net> <87jz7a51jl.fsf@posteo.net> Autocrypt: addr=philipk@posteo.net; 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: Wed, 23 Apr 2025 17:10:53 +0000 Message-ID: <877c3a4xcy.fsf@posteo.net> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 73425 Cc: Eli Zaretskii , Robert Weiner , Stefan Monnier , Mats Lidell , 73425@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Eshel Yaron writes: > Hi Philip, > > Philip Kaludercic writes: > >> Stefan Monnier writes: >> >>>>> So, how do you like the result? >>>> Pretty neat! It's great that it Just Works like that. >>>> The images appear somewhat bigger than I'd like them to, but that's a >>>> secondary concern, and probably something I can tweak on my end. >> >> What images are you referring to? > > Those that now appear in the HTML Kubed manual that ELPA generates. > See https://elpa.gnu.org/devel/doc/kubed.html#Overview for example. On my end it appears as "max-width: 100%;", which appears fine to me. Were you expecting wider margins? Something like max-width: 90%; margin: auto; display: block; ? > > > Eshel From debbugs-submit-bounces@debbugs.gnu.org Wed Apr 23 14:53:25 2025 Received: (at 73425) by debbugs.gnu.org; 23 Apr 2025 18:53:25 +0000 Received: from localhost ([127.0.0.1]:58875 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1u7fDm-0007HW-HB for submit@debbugs.gnu.org; Wed, 23 Apr 2025 14:53:24 -0400 Received: from mail.eshelyaron.com ([107.175.124.16]:56618 helo=eshelyaron.com) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1u7fDh-0007GE-0Y for 73425@debbugs.gnu.org; Wed, 23 Apr 2025 14:53:20 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=eshelyaron.com; s=mail; t=1745434396; bh=an4LoSOw+TpjhtdUmp9vrCujoJ/c449CPiPnB+YbPtk=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=UktXM3urGHxPcAei1YZxLf3Z+fB4DwRksUu/fIrm+zh+upGEm7pnMGcK7XXd274Cy HC9xbQiX4aRW16za40uMO6E3sdusxqWvkpDueNL88mS/wWw8i6QxaoCPf+dM9ocu6k Fz+8wFF2jT5VJBdaTEM09jbcNSmGFBCUQHBr0LNJcCcETZfqEp/Mo+gtfQKDaFfsiC tiLPuSBhCJ9RuyGZ2CwAkol7ZoMNIFCNNKS4/WV75OahdEmKDq3NRsyzHv0p4EKcTN g0vSFAYrXiWXXJTWVOJ6BK7RGQzZv9SPtOrpcDbioOLD4abJXP/geFclYigbFd6WfN LM1NM/DHjlsYA== From: Eshel Yaron To: Philip Kaludercic Subject: Re: bug#73425: 31.0.50; Support images in HTML versions of ELPA package manuals In-Reply-To: <877c3a4xcy.fsf@posteo.net> References: <87h6a78t1t.fsf@posteo.net> <86ldzjh7vu.fsf@gnu.org> <87y13j7djp.fsf@posteo.net> <86ikunh5kg.fsf@gnu.org> <87ldzifxx2.fsf@posteo.net> <86zfnyfug8.fsf@gnu.org> <87ploutu5a.fsf@posteo.net> <87jz7a51jl.fsf@posteo.net> <877c3a4xcy.fsf@posteo.net> Date: Wed, 23 Apr 2025 20:53:13 +0200 Message-ID: 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 , Robert Weiner , Stefan Monnier , Mats Lidell , 73425@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Philip Kaludercic writes: > Eshel Yaron writes: > >> Hi Philip, >> >> Philip Kaludercic writes: >> >>> Stefan Monnier writes: >>> >>>>>> So, how do you like the result? >>>>> Pretty neat! It's great that it Just Works like that. >>>>> The images appear somewhat bigger than I'd like them to, but that's a >>>>> secondary concern, and probably something I can tweak on my end. >>> >>> What images are you referring to? >> >> Those that now appear in the HTML Kubed manual that ELPA generates. >> See https://elpa.gnu.org/devel/doc/kubed.html#Overview for example. > > On my end it appears as "max-width: 100%;", which appears fine to me. > Were you expecting wider margins? Something like > > max-width: 90%; > margin: auto; > display: block; > > ? Yes, with those it's looks a little better IMO. Even max-width: 75% seems wide enough to me. On mobile it looks great as it is, BTW. Eshel