From patchwork Thu Oct 13 17:29:14 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Corbet X-Patchwork-Id: 2105 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:4ac7:0:0:0:0:0 with SMTP id y7csp396158wrs; Thu, 13 Oct 2022 10:34:24 -0700 (PDT) X-Google-Smtp-Source: AMsMyM7pvqdomovViQy9Kq4Eo7MnGPaUAyy38Htc3ktkwIbU3jUUkPjhK/w+La4fx9F8YHFuMPTC X-Received: by 2002:a17:902:ceca:b0:177:fa1f:4abc with SMTP id d10-20020a170902ceca00b00177fa1f4abcmr940434plg.99.1665682463911; Thu, 13 Oct 2022 10:34:23 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1665682463; cv=none; d=google.com; s=arc-20160816; b=xyzWvjwFrSZ8rhM4xym1Yomj8kn4F2gNBakZ+ky+8t8kycwN5CDVnkB1Xgsobw2T1j VqqjLCsmzAloFQDwJP17d8ewrhcrsR5QTav6wdf0y8U7GJO9yuRxjOTgfzbDyQlHeX33 11RgadKOx54VdaBJtNoHtwtOmDYqwEUqKCPtZeXqmHkguj1YJsrZx5UtrRAva1FA1AN5 NINRjmtoOQsKw68ZGTO8wPDsdwd0s0C/wnvZdfrDdRfpVbRDPyP01AHUJTUr5rpUNVV9 VwcoGzoTgTOV+DHgzmK6dVKcw/QiGt+pRU4nSmtLMxIdmz+Ec4ZPFFYSW6j3Ks+2i+Bl ++kQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature:dkim-filter; bh=sf2YcBaC8BulfV1gLC66FnN/Vr7mvopLL1hXvmP/Wiw=; b=UOcN20a2Ozpba8ToW7Z63NhM9i6++tzgAITXyprwfqAmwtYojC1mkrj5jU39EXviIK QxEK+QQ/XVwUhcm40pZUHipLm0W6qgfVg6ar4U1y/hrftGPWWYSRbxm++jk7imoeeKvA AMo9e9YoFvdl1REjdNo/rhWw4zQcypMCunUoHe4S4/fq4FUOS0MJtYOreE33N9SU5mkD egaStY/h5rxwtZjqAvH6TmuUEqyy4LrkV6b3xLutjfQI1K+pHGqW0GXQhm+SnCPs8D2S eJ6BYFkFC6/yImD0jTzN5SluYsmfHX1nP+HqwPlXnXkbxYcV36iq/12SOJRvvJAJdlch r/+w== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@lwn.net header.s=20201203 header.b=FqTyH8aS; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id eb25-20020a056a004c9900b00544e163575bsi20207963pfb.176.2022.10.13.10.34.08; Thu, 13 Oct 2022 10:34:23 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@lwn.net header.s=20201203 header.b=FqTyH8aS; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229880AbiJMR3f (ORCPT + 99 others); Thu, 13 Oct 2022 13:29:35 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:48180 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229618AbiJMR31 (ORCPT ); Thu, 13 Oct 2022 13:29:27 -0400 Received: from ms.lwn.net (ms.lwn.net [45.79.88.28]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 3E805C3541; Thu, 13 Oct 2022 10:29:27 -0700 (PDT) Received: from meer.lwn.net (unknown [IPv6:2601:281:8300:73:8b7:7001:c8aa:b65f]) by ms.lwn.net (Postfix) with ESMTPA id CAB5A7DE; Thu, 13 Oct 2022 17:29:26 +0000 (UTC) DKIM-Filter: OpenDKIM Filter v2.11.0 ms.lwn.net CAB5A7DE DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lwn.net; s=20201203; t=1665682167; bh=sf2YcBaC8BulfV1gLC66FnN/Vr7mvopLL1hXvmP/Wiw=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=FqTyH8aSX2v/yn/lGIScRydi6QzAMazqsuDtDXFp4Tlpbs9GQggtulozm8WAnRhpR XVHtJwd1uAP6kBb1CGSe91z/O8NRNhy/4jbeyKTK2+8oF6v8WVmwIxqxnC2+CZdVQR E+UZcJyCDPWbj+VcnjnFlS0bWVWNY7wyafOXuA9B3CBpkTdehkbbvC8td7lSRf6Dgi doW6lPY/TXPwq57q9mw3ll4k8eP/wz+4Z7T0jPEeq9IVD8PJBF86aAQ6ToGozzlB24 3OiTsbGTpMH4KRAGzD8lI0zYBpy0vlbGFBp7sAGOGqBegzAhdgyktKAoPNQEwfwa3q /YvJYPTHWkNdA== From: Jonathan Corbet To: linux-doc@vger.kernel.org Cc: linux-kernel@vger.kernel.org Subject: [PATCH v3 2/6] docs: tweak some Alabaster style parameters Date: Thu, 13 Oct 2022 11:29:14 -0600 Message-Id: <20221013172918.846856-3-corbet@lwn.net> X-Mailer: git-send-email 2.37.2 In-Reply-To: <20221013172918.846856-1-corbet@lwn.net> References: <20221013172918.846856-1-corbet@lwn.net> MIME-Version: 1.0 X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_NONE, SPF_HELO_NONE,SPF_PASS autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1746594655165041405?= X-GMAIL-MSGID: =?utf-8?q?1746594655165041405?= This is just the beginning: tighten up the layout a bit to improve the information density in the browser. Also reconfigure the page width in terms of character units (em) rather than pixels, making it more display-independent. To that end, add a custom.css file to tweak Alabaster CSS settings. Acked-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet --- Documentation/conf.py | 3 +++ Documentation/sphinx-static/custom.css | 14 ++++++++++++++ 2 files changed, 17 insertions(+) create mode 100644 Documentation/sphinx-static/custom.css diff --git a/Documentation/conf.py b/Documentation/conf.py index 629f4afeb0eb..1dbf3d6a55de 100644 --- a/Documentation/conf.py +++ b/Documentation/conf.py @@ -345,6 +345,9 @@ if html_theme == 'classic': else: html_theme_options = { 'description': get_cline_version(), + 'font_size': '10pt', + 'page_width': '65em', + 'sidebar_width': '15em', } sys.stderr.write("Using %s theme\n" % html_theme) diff --git a/Documentation/sphinx-static/custom.css b/Documentation/sphinx-static/custom.css new file mode 100644 index 000000000000..6b0e554cea0a --- /dev/null +++ b/Documentation/sphinx-static/custom.css @@ -0,0 +1,14 @@ +/* SPDX-License-Identifier: GPL-2.0 */ +/* + * CSS tweaks for the Alabaster theme + */ + +/* Shrink the headers a bit */ +div.body h1 { font-size: 180%; } +div.body h2 { font-size: 150%; } +div.body h3 { font-size: 130%; } + +/* Tighten up the layout slightly */ +div.body { padding: 0 15px 0 10px; } +div.document { margin: 20px 10px 0 10px; } +div.sphinxsidebarwrapper { padding: 1em 0.4em; }