From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stephen Leake Newsgroups: gmane.emacs.devel Subject: Re: link info/html files from the GNU ELPA package page Date: Sat, 21 Aug 2021 18:13:13 -0700 Message-ID: <861r6mb7ti.fsf@stephe-leake.org> References: <86eeaqbo4e.fsf@stephe-leake.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="26937"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (windows-nt) Cc: emacs-devel To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Aug 22 03:14:41 2021 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1mHc4P-0006p9-1f for ged-emacs-devel@m.gmane-mx.org; Sun, 22 Aug 2021 03:14:41 +0200 Original-Received: from localhost ([::1]:35396 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mHc4N-00054P-S6 for ged-emacs-devel@m.gmane-mx.org; Sat, 21 Aug 2021 21:14:39 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:55646) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mHc3K-00044U-Ju for emacs-devel@gnu.org; Sat, 21 Aug 2021 21:13:34 -0400 Original-Received: from gateway31.websitewelcome.com ([192.185.143.36]:36173) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mHc3I-0005Le-Ks for emacs-devel@gnu.org; Sat, 21 Aug 2021 21:13:34 -0400 Original-Received: from cm16.websitewelcome.com (cm16.websitewelcome.com [100.42.49.19]) by gateway31.websitewelcome.com (Postfix) with ESMTP id D001BED3A for ; Sat, 21 Aug 2021 20:13:15 -0500 (CDT) Original-Received: from host2007.hostmonster.com ([67.20.76.71]) by cmsmtp with SMTP id Hc31mcyfYjSwzHc31myxBw; Sat, 21 Aug 2021 20:13:15 -0500 X-Authority-Reason: nr=8 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=stephe-leake.org; s=default; h=Content-Type:MIME-Version:Message-ID: In-Reply-To:Date:References:Subject:Cc:To:From:Sender:Reply-To: Content-Transfer-Encoding:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Id: List-Help:List-Unsubscribe:List-Subscribe:List-Post:List-Owner:List-Archive; bh=8CwyzM38SjhbNZbf0TyW3/oumwLXz4F1AQqo8eLXV9M=; b=jGUZv7m3uCAQdmLjCm41TnSsCZ yoHZTyIfX8E5CVyHGn4t5Hnada2ZAtRckOsLeXWwyXLJkxHzHp+TRdohFdtW8nDCi6x+vYP2lzZmG UJV+0BStKOGBmkla3xcm8lrKrQc2yBd6YNZ3PgxbLT+GIO/kbEqC/Q24NmapKx4Lpq8owclzyPrlN c6I4tagKOEP0wviNO0Za4A4GxRqSbhUu/ouo7wvuL3xPnSfMCgKfFEnwzV4pi2Zry2hfRec4a2SRY IB7wZEQ8l8V0/mFCnIEPYk6IZeAVGYX6Zc+63KFG1yDewfYMy5BdAoiQDzGnwKYMTfzzXJo8Dh42W GrFPOs3Q==; Original-Received: from [76.77.182.20] (port=49373 helo=Takver4) by host2007.hostmonster.com with esmtpsa (TLS1.2) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1mHc31-000iCr-4Y; Sat, 21 Aug 2021 19:13:15 -0600 In-Reply-To: (Stefan Monnier's message of "Wed, 18 Aug 2021 21:28:08 -0400") X-AntiAbuse: This header was added to track abuse, please include it with any abuse report X-AntiAbuse: Primary Hostname - host2007.hostmonster.com X-AntiAbuse: Original Domain - gnu.org X-AntiAbuse: Originator/Caller UID/GID - [47 12] / [47 12] X-AntiAbuse: Sender Address Domain - stephe-leake.org X-BWhitelist: no X-Source-IP: 76.77.182.20 X-Source-L: No X-Exim-ID: 1mHc31-000iCr-4Y X-Source-Sender: (Takver4) [76.77.182.20]:49373 X-Source-Auth: stephen_leake@stephe-leake.org X-Email-Count: 2 X-Source-Cap: c3RlcGhlbGU7c3RlcGhlbGU7aG9zdDIwMDcuaG9zdG1vbnN0ZXIuY29t X-Local-Domain: yes Received-SPF: permerror client-ip=192.185.143.36; envelope-from=stephen_leake@stephe-leake.org; helo=gateway31.websitewelcome.com X-Spam_score_int: -8 X-Spam_score: -0.9 X-Spam_bar: / X-Spam_report: (-0.9 / 5.0 requ) BAYES_00=-1.9, DKIM_INVALID=0.1, DKIM_SIGNED=0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_PASS=-0.001, SPF_NEUTRAL=0.779 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:272812 Archived-At: Stefan Monnier writes: >> How would I go about adding html files from the :doc entry for wisi in >> elpa/elpa-packages to https://elpa.gnu.org/packages/wisi.html> ? I links to them, so users can read the user manuals from the ELPA page. That also means the ELPA server needs to store the actual doc files somewhere accessible, not just in the package tarball. > I'm not completely sure what you mean by that, but currently the doc > shown in `wisi.html` taken from the wisi package can only be plaintext > (so it would show the HTML code itself rather than its rendering). I could put the docs on the savannah home page for ada-mode and wisi (I should do that anyway), and put links in that text to savannah. > If at all possible, it's probably better to have a source format > different from HTML, which we can then convert to the kind of HTML > fragment we need. The docs listed in ada-mode and wisi :doc have texinfo source. >> I assume there's some script/elisp in elpa/admin that generates >> that page? > > It's in `elpa-admin.el`, e.g. around `elpaa--html-make-pkg`. Ok. So that could add a line for ada-mode: docs: ada-mode, gpr-mode and for wisi: docs: wisi, wisitoken-user_guide Instead of just the file name, maybe we could pull the doc title from the texinfo file somehow? And somewhere in elpaa--make-one-package it would have to save the doc files somewhere, instead of deleting them after building the tarball. -- -- Stephe