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: Proposal: Include css for docs in emacs repo Date: Mon, 2 Dec 2024 19:32:39 -0800 Message-ID: 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="30594"; mail-complaints-to="usenet@ciao.gmane.io" To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Tue Dec 03 04:33:05 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 1tIJep-0007nG-IW for ged-emacs-devel@m.gmane-mx.org; Tue, 03 Dec 2024 04:33:03 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1tIJec-0006FE-Mj; Mon, 02 Dec 2024 22:32:52 -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 1tIJeY-0006F5-AN for emacs-devel@gnu.org; Mon, 02 Dec 2024 22:32:47 -0500 Original-Received: from mail-pf1-x431.google.com ([2607:f8b0:4864:20::431]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1tIJeW-0004gs-Oq for emacs-devel@gnu.org; Mon, 02 Dec 2024 22:32:46 -0500 Original-Received: by mail-pf1-x431.google.com with SMTP id d2e1a72fcca58-724d23df764so4342381b3a.1 for ; Mon, 02 Dec 2024 19:32:44 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1733196762; x=1733801562; darn=gnu.org; h=content-disposition:mime-version:message-id:subject:to:from:date :from:to:cc:subject:date:message-id:reply-to; bh=7KNYis71eE+5HAiysXXVF44PfQQiSUkbkR3/PLL/M3E=; b=TlqHl2LcG0o3svdAjFO8wFxlhFNAZi8jt5oNqyJoAH+7/ZmbXbgqGhZYvNaT1iLKiG 54QZTlGbyIySZ3yThjs9O8yE/EpThNGRCUbgpXUmFneZtWOXRr6Ccb0Hl6L8fv0fG6Fn pN00JHaBuxMOtT3o8IcXi/n1OLNc8EZ6UAzBklVnCpmltPI5LGJCiSHQEQ5rAFzxrK3k ynsbJ87sa5rhgZ2Tn1bup4nHo4hoguZCfMp3hj1MUbrgwhz7iKaBrp/4dN9ANgaYLpZH qQ9Vog5SgWIRZIo4m8srLSdeyVaw+7fwFF/xc2zAvE+S+7HEt5nJffIg1iQUbdQH1pVz DOsA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1733196762; x=1733801562; h=content-disposition:mime-version:message-id:subject:to:from:date :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=7KNYis71eE+5HAiysXXVF44PfQQiSUkbkR3/PLL/M3E=; b=YEnaqfRHowjWmXRC/bE1lR01eWazkmrKoxp0nUF29MHPz8uR5WY5cM06FjGuiYZI2G GCXYHxkvrz49nkKoOSDs+m21AxS1BO579RFvf1vdt4OdG8w/Bu6B1fRCvp5p44c0Xt58 KcPR1YIhYeixJ5fc69Izj7HcWbi34N3+xvdL52zQsvwxh1tcRbpOVjBmS8Lu2UPOcE8H Q8eZUOq2FPytW+aU6t2wJbSOZcAnF6++BcGcpiRsupJ2QPSj5flYFIUElJqkdSKrxyej 9BRAnSzT0mq+EyAXqBEftHrwXh96IE7dTUD5JtNAJKdm58/kh4XADNVflVZNtvexUwNa AEdQ== X-Gm-Message-State: AOJu0YzKXKzoVqoCDWm/KWvtvubAhXtHbGh3NoPSvuQtHgZt+ZJ8K/sX RkZTbTmDasJSNIB5qS72IeShW//Qqu/AVX5babRir4F+OF4rYwU1pA3oJQ== X-Gm-Gg: ASbGncvWvk2IeQ21i/bGCzjI+M1fV0b3n9ubRcwxkbVS2Nnr7x8h048ZtOFEHJHAEQe nq/7aTcIQhYipiObNZJ+/+H4WsR+3lSXVQPMzy/+fTxgNFOUoNXnwIvY6joNgZ+tEs6fVpp6xX3 aQV1qNVIQTyxcfHoqIoTLDtAsJIsdSfxuQ3Nc0evo42m7zbG5udNvxJy/miR6zJLQxoOZcihFnJ WirS4Ig9eKcuXKjFvEYhhyT1nRjw+fQXDsA9A/m2zU= X-Google-Smtp-Source: AGHT+IGasXmBkXARdeN6sZ4rQhMwR4c4ufER2cc8GcjBsMA0FHJhctK3NZLY8rkhxdNhvaHxiiY87w== X-Received: by 2002:a05:6a00:1910:b0:725:4076:b52a with SMTP id d2e1a72fcca58-7257fcc9d76mr1258939b3a.25.1733196762494; Mon, 02 Dec 2024 19:32:42 -0800 (PST) Original-Received: from flap ([2601:645:8a81:69c0:c6fd:8a28:1df9:ee2d]) by smtp.gmail.com with ESMTPSA id d2e1a72fcca58-7254181479dsm9317134b3a.159.2024.12.02.19.32.41 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 02 Dec 2024 19:32:42 -0800 (PST) Content-Disposition: inline Received-SPF: pass client-ip=2607:f8b0:4864:20::431; envelope-from=dradetsky@gmail.com; helo=mail-pf1-x431.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:325965 Archived-At: I would like to build the emacs manuals for local use. This means the one-page-per-node manuals. Ideally, I'd like to build them with one command, and generate a self-contained directory I could chuck somewhere (e.g. under my designated serve-docs-from-local dir) and be able to browse them just like I can on the gnu site. Even if the docs build itself didn't currently leave something to be desired, the built docs will contain the following Which refers to css not included in the repo itself. I'm not sure if it's included in any repo. Personally, I just downloaded the file (and the style.css file it referenced) off of gnu.org. It would be nice if instead, these 2 files were placed in a manual-assets/ dir alongside emacs/ elisp/ and friends, and if the manuals were to reference the manual.css file contained in this dir with a relative path, rather than the one at /software/emacs/manual.css. There's no reason why gnu.org couldn't override this file somehow, such that e.g. all manuals served from gnu.org would continue to use /software/emacs/style.css instead of the relative one, although I can't see why you'd want to. But you could. Anyway, I could concievably hack on the manual-generating scripts myself (especially if the release-process docs were a little clearer), but it won't actually accomplish my purpose if we haven't moved the css to the emacs repo.