From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from out1-smtp.messagingengine.com (out1-smtp.messagingengine.com [66.111.4.25]) by dpdk.org (Postfix) with ESMTP id E59001B363 for ; Mon, 12 Feb 2018 18:45:10 +0100 (CET) Received: from compute1.internal (compute1.nyi.internal [10.202.2.41]) by mailout.nyi.internal (Postfix) with ESMTP id 706B520D26; Mon, 12 Feb 2018 12:45:10 -0500 (EST) Received: from frontend2 ([10.202.2.161]) by compute1.internal (MEProxy); Mon, 12 Feb 2018 12:45:10 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=monjalon.net; h= cc:date:from:message-id:subject:to:x-me-sender:x-me-sender :x-sasl-enc; s=mesmtp; bh=PAQswA+6UvYhg/ya0E34cr/0GGaUtfQWS7Tpls PIp8Q=; b=rtBF62JIyBSRMcKxhOkLS1w4bUGwKy7ggJZtJke2QNusK9LX+3pkgZ n+UiaAj4dbSs9cYOm3LNr0HH+1VjOo1ijpSsVyFtUbdUC4cOStTksVigZVnXmnpw 3SyYpbBMMTzSaOU+zl3R70cKBFAgZnar81DYQrg696WFi+zjByhKI= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:date:from:message-id:subject:to :x-me-sender:x-me-sender:x-sasl-enc; s=fm2; bh=PAQswA+6UvYhg/ya0 E34cr/0GGaUtfQWS7TplsPIp8Q=; b=GrBTA5BzVQHD22ZdBQSpUgDMggkdq33Y8 9vvqf4/aWWl+tjN6rDcifUfvcZkb1REJTw66E1tS88H/hvnrAEN2g5UbU3R7O/Fs NxfjCISuo/xAaRsy5uYVamhH09m+ti5oDd1XUmmJdf9K9g+jWvpPEaBSmBB0C6Wp 4ou2X50NraAxDV3uy7MdoMzFG4mHAxkAsFJ7lWEBVNDftnBqU7kAnZnnxNuZcWRo x98mh7Fj9JoSD/7VvUujTZTmWyANX7srxnxdwzaEtvXM/8m83z/348rJp5WJMKR0 9IYWHmQEvAyVVhiIjhtzuM/fYLmZgDymB3dmsGmsL2OdJyem2q3qg== X-ME-Sender: Received: from xps.monjalon.net (184.203.134.77.rev.sfr.net [77.134.203.184]) by mail.messagingengine.com (Postfix) with ESMTPA id D5E31240DB; Mon, 12 Feb 2018 12:45:09 -0500 (EST) From: Thomas Monjalon To: john.mcnamara@intel.com Cc: dev@dpdk.org Date: Mon, 12 Feb 2018 18:44:48 +0100 Message-Id: <20180212174448.32125-1-thomas@monjalon.net> X-Mailer: git-send-email 2.15.1 Subject: [dpdk-dev] [PATCH] doc: improve HTML spacing in release notes X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 12 Feb 2018 17:45:11 -0000 Vertical spacing is lower before an item title than after. So the items with paragraphs are not well separated. A custom CSS is added to override the rtd theme. Signed-off-by: Thomas Monjalon --- doc/guides/conf.py | 2 ++ doc/guides/custom.css | 7 +++++++ mk/rte.sdkdoc.mk | 8 +++++++- 3 files changed, 16 insertions(+), 1 deletion(-) create mode 100644 doc/guides/custom.css diff --git a/doc/guides/conf.py b/doc/guides/conf.py index 77d93acf1..cf06f2572 100644 --- a/doc/guides/conf.py +++ b/doc/guides/conf.py @@ -391,3 +391,5 @@ def setup(app): app.add_role('numref', numref_role) # Process the numref references once the doctree has been created. app.connect('doctree-resolved', process_numref) + + app.add_stylesheet('css/custom.css') diff --git a/doc/guides/custom.css b/doc/guides/custom.css new file mode 100644 index 000000000..fe9fee3ca --- /dev/null +++ b/doc/guides/custom.css @@ -0,0 +1,7 @@ +/* These custom CSS rules override readthedocs theme */ + +/* Spacing before a list item must be bigger than spacing inside the item. + * Complex list items start with a p.first element. */ +.section li > .first { + margin-top: 18px; +} diff --git a/mk/rte.sdkdoc.mk b/mk/rte.sdkdoc.mk index de31b78cf..bce57c5da 100644 --- a/mk/rte.sdkdoc.mk +++ b/mk/rte.sdkdoc.mk @@ -117,7 +117,13 @@ guides-pdf-%: $(Q)mv $(RTE_OUTPUT)/doc/pdf/guides/$*/doc.pdf \ $(RTE_OUTPUT)/doc/pdf/guides/$*.pdf -guides-%: +guides-html-prepare: + $(Q)install -D -m0644 $(RTE_SDK)/doc/guides/custom.css \ + $(RTE_OUTPUT)/doc/html/guides/_static/css/custom.css + +guides-%-prepare: ; + +guides-%: guides-%-prepare @echo 'sphinx processing $@...' $(Q)$(RTE_SPHINX_BUILD) -b $* $(RTE_SPHINX_VERBOSE) \ -c $(RTE_SDK)/doc/guides $(RTE_SDK)/doc/guides \ -- 2.15.1