From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from firstgate.proxmox.com (firstgate.proxmox.com [212.224.123.68]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by lists.proxmox.com (Postfix) with ESMTPS id 24A69BCD37 for ; Fri, 29 Mar 2024 16:07:56 +0100 (CET) Received: from firstgate.proxmox.com (localhost [127.0.0.1]) by firstgate.proxmox.com (Proxmox) with ESMTP id 0AF841DA9B for ; Fri, 29 Mar 2024 16:07:56 +0100 (CET) Received: from proxmox-new.maurer-it.com (proxmox-new.maurer-it.com [94.136.29.106]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by firstgate.proxmox.com (Proxmox) with ESMTPS for ; Fri, 29 Mar 2024 16:07:52 +0100 (CET) Received: from proxmox-new.maurer-it.com (localhost.localdomain [127.0.0.1]) by proxmox-new.maurer-it.com (Proxmox) with ESMTP id 27A3142B9E for ; Fri, 29 Mar 2024 16:07:52 +0100 (CET) From: Hannes Duerr To: pbs-devel@lists.proxmox.com Date: Fri, 29 Mar 2024 16:07:36 +0100 Message-Id: <20240329150737.243408-1-h.duerr@proxmox.com> X-Mailer: git-send-email 2.39.2 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-SPAM-LEVEL: Spam detection results: 0 AWL 0.024 Adjusted score from AWL reputation of From: address BAYES_00 -1.9 Bayes spam probability is 0 to 1% DMARC_MISSING 0.1 Missing DMARC policy KAM_DMARC_STATUS 0.01 Test Rule for DKIM or SPF Failure with Strict Alignment SPF_HELO_NONE 0.001 SPF: HELO does not publish an SPF Record SPF_PASS -0.001 SPF: sender matches SPF record URIBL_BLOCKED 0.001 ADMINISTRATOR NOTICE: The query to URIBL was blocked. See http://wiki.apache.org/spamassassin/DnsBlocklists#dnsbl-block for more information. [sphinx-doc.org, conf.py] Subject: [pbs-devel] [PATCH proxmox-backup 1/2] docs: move custom.js and custom.css into _static folder X-BeenThere: pbs-devel@lists.proxmox.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Proxmox Backup Server development discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 29 Mar 2024 15:07:56 -0000 The sphinx documentation [0] describes the _static folder as the location for the custom.js and custom.css so we move the files there, as we do not need those files outside the directory. This also removes the error message when building: WARNING: html_static_path entry '_static' does not exist [0] https://www.sphinx-doc.org/en/master/development/theming.html#add-your-own-static-files-to-the-build-assets Signed-off-by: Hannes Duerr --- if there is a still a reason why we keep them outside which i could not come up with, please let me know docs/Makefile | 4 ++-- docs/{ => _static}/custom.css | 0 docs/{ => _static}/custom.js | 0 3 files changed, 2 insertions(+), 2 deletions(-) rename docs/{ => _static}/custom.css (100%) rename docs/{ => _static}/custom.js (100%) diff --git a/docs/Makefile b/docs/Makefile index 0d0963f3..b2d863cd 100644 --- a/docs/Makefile +++ b/docs/Makefile @@ -138,9 +138,9 @@ lto-barcode/lto-barcode-generator.js: ${LTO_BARCODE_JS_SOURCE} mv $@.tmp $@ .PHONY: html -html: ${GENERATED_SYNOPSIS} images/proxmox-logo.svg custom.css conf.py ${PRUNE_SIMULATOR_FILES} ${LTO_BARCODE_FILES} ${API_VIEWER_SOURCES} +html: ${GENERATED_SYNOPSIS} images/proxmox-logo.svg _static/custom.css conf.py ${PRUNE_SIMULATOR_FILES} ${LTO_BARCODE_FILES} ${API_VIEWER_SOURCES} $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html - install -m 0644 custom.js custom.css images/proxmox-logo.svg $(BUILDDIR)/html/_static/ + install -m 0644 _static/custom.js _static/custom.css images/proxmox-logo.svg $(BUILDDIR)/html/_static/ install -dm 0755 $(BUILDDIR)/html/prune-simulator install -m 0644 ${PRUNE_SIMULATOR_FILES} $(BUILDDIR)/html/prune-simulator install -dm 0755 $(BUILDDIR)/html/lto-barcode diff --git a/docs/custom.css b/docs/_static/custom.css similarity index 100% rename from docs/custom.css rename to docs/_static/custom.css diff --git a/docs/custom.js b/docs/_static/custom.js similarity index 100% rename from docs/custom.js rename to docs/_static/custom.js -- 2.39.2