{"id":2202,"url":"https://patchwork.libcamera.org/api/1.1/patches/2202/?format=json","web_url":"https://patchwork.libcamera.org/patch/2202/","project":{"id":1,"url":"https://patchwork.libcamera.org/api/1.1/projects/1/?format=json","name":"libcamera","link_name":"libcamera","list_id":"libcamera_core","list_email":"libcamera-devel@lists.libcamera.org","web_url":"","scm_url":"","webscm_url":""},"msgid":"<20191021102453.26471-4-laurent.pinchart@ideasonboard.com>","date":"2019-10-21T10:24:49","name":"[libcamera-devel,4/8] Documentation: Generate local TOC on demand","commit_ref":"33ae55c3cdfe78de2e5c9e53c95eb35cc6f3e068","pull_url":null,"state":"accepted","archived":false,"hash":"7474b07b2c329042af2854476b6c5d2bb0425999","submitter":{"id":2,"url":"https://patchwork.libcamera.org/api/1.1/people/2/?format=json","name":"Laurent Pinchart","email":"laurent.pinchart@ideasonboard.com"},"delegate":null,"mbox":"https://patchwork.libcamera.org/patch/2202/mbox/","series":[{"id":539,"url":"https://patchwork.libcamera.org/api/1.1/series/539/?format=json","web_url":"https://patchwork.libcamera.org/project/libcamera/list/?series=539","date":"2019-10-21T10:24:46","name":"[libcamera-devel,1/8] Documentation: Move coding style under contributing","version":1,"mbox":"https://patchwork.libcamera.org/series/539/mbox/"}],"comments":"https://patchwork.libcamera.org/api/patches/2202/comments/","check":"pending","checks":"https://patchwork.libcamera.org/api/patches/2202/checks/","tags":{},"headers":{"Return-Path":"","Received":["from perceval.ideasonboard.com (perceval.ideasonboard.com\n\t[213.167.242.64])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id BA38960BE0\n\tfor ;\n\tMon, 21 Oct 2019 12:25:06 +0200 (CEST)","from pendragon.ideasonboard.com (143.121.2.93.rev.sfr.net\n\t[93.2.121.143])\n\tby perceval.ideasonboard.com (Postfix) with ESMTPSA id E3EF1540\n\tfor ;\n\tMon, 21 Oct 2019 12:25:05 +0200 (CEST)"],"DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1571653506;\n\tbh=HS4rQo9qmj0jsYhh40wRPtrqUgVpU5CQ8RI8V5//jNM=;\n\th=From:To:Subject:Date:In-Reply-To:References:From;\n\tb=wms6CMJhI2AmqhJzQnnQpEYjujkxC5CBYrmwfaGvuzrRjNOqCv60uSZPsrt8Ta1l+\n\tA9H02j0OaD1j4g2dAkn9L2RzI3wBAh91GPKBWfmKnz8rG6dje8wKKn1TJOXKQbEuyQ\n\tPls6M9RyUCxasvoOQazVNiNndHoXiQ8XPWI5l61Q=","From":"Laurent Pinchart ","To":"libcamera-devel@lists.libcamera.org","Date":"Mon, 21 Oct 2019 13:24:49 +0300","Message-Id":"<20191021102453.26471-4-laurent.pinchart@ideasonboard.com>","X-Mailer":"git-send-email 2.23.0","In-Reply-To":"<20191021102453.26471-1-laurent.pinchart@ideasonboard.com>","References":"<20191021102453.26471-1-laurent.pinchart@ideasonboard.com>","MIME-Version":"1.0","Content-Transfer-Encoding":"8bit","Subject":"[libcamera-devel] [PATCH 4/8] Documentation: Generate local TOC on\n\tdemand","X-BeenThere":"libcamera-devel@lists.libcamera.org","X-Mailman-Version":"2.1.29","Precedence":"list","List-Id":"","List-Unsubscribe":",\n\t","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n\t","X-List-Received-Date":"Mon, 21 Oct 2019 10:25:06 -0000"},"content":"All pages are generated with a local TOC, which is pointless on simple\npages such as the front page, or other pages containing little content.\nUse the .. contents:: :local: directive instead to generate the local\nTOC on demand, and remove the automatic local TOC generation. Only the\nDocs page uses a local TOC.\n\nSigned-off-by: Laurent Pinchart \n---\n Documentation/docs.rst | 3 ++\n Documentation/theme/layout.html | 5 ----\n Documentation/theme/static/css/theme.css | 38 ++++++++++++++++--------\n 3 files changed, 29 insertions(+), 17 deletions(-)","diff":"diff --git a/Documentation/docs.rst b/Documentation/docs.rst\nindex 7a3977c13110..7cb6059616fd 100644\n--- a/Documentation/docs.rst\n+++ b/Documentation/docs.rst\n@@ -1,3 +1,6 @@\n+.. contents::\n+ :local:\n+\n *************\n Documentation\n *************\ndiff --git a/Documentation/theme/layout.html b/Documentation/theme/layout.html\nindex a5cc2776adf5..139c39c7cc38 100644\n--- a/Documentation/theme/layout.html\n+++ b/Documentation/theme/layout.html\n@@ -100,11 +100,6 @@\n \n \n
\n-
\n-
Contents
\n- {{ toc }}\n-
\n-\n {# PAGE CONTENT #}\n
\n {% block body %}{% endblock %}\ndiff --git a/Documentation/theme/static/css/theme.css b/Documentation/theme/static/css/theme.css\nindex 047aff07dddb..4901bbf564f7 100644\n--- a/Documentation/theme/static/css/theme.css\n+++ b/Documentation/theme/static/css/theme.css\n@@ -24,6 +24,10 @@ a.headerlink {\n \tvisibility: hidden;\n }\n \n+a.toc-backref {\n+\ttext-decoration: none;\n+}\n+\n h1:hover a.headerlink,\n h2:hover a.headerlink,\n h3:hover a.headerlink,\n@@ -206,37 +210,47 @@ div#content {\n div#content > div.block {\n \tfont-size: 16px;\n \tmargin-right: 0px;\n-\tmargin-left: 20px;\n-\tmax-width: 800px;\n-\tpadding: 20px 60px 0px 60px;\n+\tmargin-left: 0px;\n+\tmax-width: 1280px;\n+\tpadding: 0px 60px 0px 60px;\n \ttext-align: justify;\n-\twidth: 70%;\n }\n \n div#content > div.block h1 {\n \tcolor: black;\n \tfont-size: 40px;\n+\tmargin-top: 0px;\n \ttext-align: left;\n }\n \n-div.local-toc {\n+div#content > div.block > div.section {\n+\tmax-width: 800px;\n+}\n+\n+div.local.topic {\n \tfloat: right;\n \tbackground-color: #fcfcff;\n \tborder: 1px dotted #4896e0;\n-\tmargin-right: 100px;\n+\tmargin-left: 20px;\n+\tmargin-right: 0px;\n+\tmax-width: 15em;\n \tpadding: 10px 20px 10px 10px;\n+\ttext-align: left;\n }\n \n-div.toc-title {\n-\tfont-weight: bold;\n-}\n-\n-div.local-toc ul {\n+div.local.topic ul {\n \tpadding-left: 20px;\n \tmargin-bottom: 5px;\n }\n \n-div.local-toc a {\n+div.local.topic > ul:before {\n+\tcontent: \"Contents\";\n+\tdisplay: block;\n+\tfont-weight: bold;\n+\tmargin-bottom: 10px;\n+}\n+\n+div.local.topic a {\n \tfont-weight: normal;\n \tpadding-left: 10px;\n \ttext-decoration: none;\n","prefixes":["libcamera-devel","4/8"]}