From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Daniel Radetsky Newsgroups: gmane.emacs.devel Subject: Re: Proposal: Include css for docs in emacs repo Date: Tue, 3 Dec 2024 16:25:28 -0800 Message-ID: References: <86a5dc3ont.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="5910"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Wed Dec 04 01:26:25 2024 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 1tIdDk-0001N1-VA for ged-emacs-devel@m.gmane-mx.org; Wed, 04 Dec 2024 01:26:24 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1tIdCz-0007u9-Dy; Tue, 03 Dec 2024 19:25:37 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1tIdCx-0007u1-RM for emacs-devel@gnu.org; Tue, 03 Dec 2024 19:25:35 -0500 Original-Received: from mail-pg1-x532.google.com ([2607:f8b0:4864:20::532]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1tIdCv-0004c8-4o; Tue, 03 Dec 2024 19:25:35 -0500 Original-Received: by mail-pg1-x532.google.com with SMTP id 41be03b00d2f7-7fc340eb006so4527667a12.0; Tue, 03 Dec 2024 16:25:32 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1733271931; x=1733876731; darn=gnu.org; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:from:to:cc:subject:date:message-id:reply-to; bh=umKiHqYEu0TiMC2Hn+CZEBHA1z1xE2NqZnpOMKdjmVU=; b=QXJu/dhaf+ETCar8eKajSdZqOM6/0BlwfInGWwmUTfJvPzbajYmDBJt/1W0a1qnsTd Nj8xgdGd4a/PalTTDS8ezejcSFyu+Y8Vd0dCDz5ahgESSjYsxH7suEYg6d6cIKypFgi7 YYMd6o+M34AHwt+SAL2q94CbOeac06gTfaetuv6EWzlncxvPW8pNof+zjQVjEgbNVPto UtbEyAoKpMmYEvHOTFF7HPL/e+SRalgNMVc4KsofenR0a8p/YjrnJZ/27+kbtnxoUkkH +ajE/CVw95UcYWkY4/ALEh19NbP+kuLOrNhwibVyaXMT5464KLO7SIsBcrBzNgsO4u1N 9ecg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1733271931; x=1733876731; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=umKiHqYEu0TiMC2Hn+CZEBHA1z1xE2NqZnpOMKdjmVU=; b=h4migcfi7+S27t4YEmSkgaA1zSRu3eyyYU/GflNKu1Y+sB8EbHx0Aq1aQeeu5Rec51 6vnVBOSkjZZWxys/TTd3E6mDsqZqMcNgCsQ2fEE00dv2T2SwmdTo/hxTKnZeFhAfpMPJ dlWFIpmtTMfDD94o1bob8CBmsEvIyepahPsGPX+BjShGnn1gEPkkaFPU1yB6uxJnNP3U SoBS5zE8fQ5rse77Z04wwB6RlQvamNM405AMMWuQzzRb7UYa35VyBq7vq22X/FtAA7z3 EkNUJUaM2yzOh6Y1bxOxCsgZ7raXxIQMY+/5VVc0o1Cau77l5hdtMXO3KeJErpSHpLJd TkgA== X-Gm-Message-State: AOJu0Ywt5IEvSzejWGsVpjcAbyLA1ptFOTISkkMihu50NPRjr28ju0Zf 5upOarmGxZlJUlDW9vtYzhkEa6Kbqu7Y89mMzGhVHIkNI2+1SQsUWs/ZWQ== X-Gm-Gg: ASbGncttFYKTeUdagL2gNa5kU6Dog2W9ujXe/0XG4uWGd8gA/DwaYRFsT5hZfYzPUpo cgn8nI2dpZgo+bfq/w8acagIZYytN22ilZ5E9Y1QzopXP6/E7YcQPTJS4iw561UkEOrjsIP2WxR +qp2YOJKI4CGdOXZfytCofT7S5fI6MLVnLe7kGDixcD3D2U7imORCJHOXMcoUglQUWsgFslivq1 sbafYyGNNLnQDlgpdfeUAKZspQ3uN0WsdLtt8Y= X-Google-Smtp-Source: AGHT+IFciaWkTsqfOpyP0AFzxJXYkarp/SbeSZiZANs3on95yPNcUZVfcLKGdUg+naDsPitfYOiJsQ== X-Received: by 2002:a05:6a20:72a4:b0:1e0:d9e5:c3d7 with SMTP id adf61e73a8af0-1e1653c5dd9mr6402701637.26.1733271931096; Tue, 03 Dec 2024 16:25:31 -0800 (PST) Original-Received: from flap ([2601:645:8a81:69c0:e:7869:a0e3:a997]) by smtp.gmail.com with ESMTPSA id 41be03b00d2f7-7fc9c304fe2sm10281671a12.33.2024.12.03.16.25.30 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 03 Dec 2024 16:25:30 -0800 (PST) Content-Disposition: inline In-Reply-To: <86a5dc3ont.fsf@gnu.org> Received-SPF: pass client-ip=2607:f8b0:4864:20::532; envelope-from=dradetsky@gmail.com; helo=mail-pg1-x532.google.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, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 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-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:326010 Archived-At: On Tue, Dec 03, 2024 at 03:02:30PM +0200, Eli Zaretskii wrote: > How do you get this? Is that by running the scripts in the admin/ > directory, like make-manuals? Yes, that's what I did. > For the latter purpose, you are supposed to say > > $ cd doc/emacs && make emacs.html HTML_OPTS='--html --split=node' Thanks, although I didn't realize that. I spent some time looking around for how to do it, but didn't figure it out. Does that mean I'm not very smart, or that the process is not very intuitive, or some combination of both? Hard to say. > I don't see a need to include this in the Emacs Git repository. The > stuff related to the Web documentation is maintained in a separate > repository for a reason. I'm not sure I'd call it a "need" but the reason is that so that as a user, I can build the html docs for personal use without having to do weird stuff like manually downloading the css from gnu.org. Also, as somebody who is working on the docs, it's desirable to be able to build the docs exactly as they would appear to a user on gnu.org. Otherwise, I'll end up doing some kind of works-on-my-machine hack to get the css into my local build, and then the docs go up for regular users and look incorrect. > The way these scripts are used is described in admin/make-tarball.txt. > You will see there that the produced HTML manuals are moved to the > separate webpages repository and sent upstream from there; the file > manual.css is part of that repository. So there's no need to mix this > with the Emacs sources, because Emacs users are not supposed to > produce manuals in the format used for the GNU Documentation web site. Sure, but some emacs users don't play by your rules, maaaaan [takes a hit of joint]. I suppose it would work to just download style.css from the repo when I wanted to make a user-type (as opposed to admin-type) html docs build. We could also include a custom version of manual.css (but not style.css) for this use intended to just point to a relative path. rather than an absolute path. Would some version of this be acceptable? --dmr