[{"id":2939,"web_url":"https://patchwork.libcamera.org/comment/2939/","msgid":"<494f3a4a-0d78-a57d-fce9-d02bfc16b420@ideasonboard.com>","date":"2019-10-21T11:03:41","subject":"Re: [libcamera-devel] [PATCH 4/8] Documentation: Generate local TOC\n\ton demand","submitter":{"id":4,"url":"https://patchwork.libcamera.org/api/people/4/","name":"Kieran Bingham","email":"kieran.bingham@ideasonboard.com"},"content":"Hi Laurent,\n\nOn 21/10/2019 11:24, Laurent Pinchart wrote:\n> All pages are generated with a local TOC, which is pointless on simple\n> pages such as the front page, or other pages containing little content.\n> Use the .. contents:: :local: directive instead to generate the local\n> TOC on demand, and remove the automatic local TOC generation. Only the\n> Docs page uses a local TOC.\n> \n\nAgreed, the superfluous TOCs are overkill.\n\nReviewed-by: Kieran Bingham <kieran.bingham@ideasonboard.com>\n\n> Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>\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(-)\n> \n> diff --git a/Documentation/docs.rst b/Documentation/docs.rst\n> index 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>  *************\n> diff --git a/Documentation/theme/layout.html b/Documentation/theme/layout.html\n> index a5cc2776adf5..139c39c7cc38 100644\n> --- a/Documentation/theme/layout.html\n> +++ b/Documentation/theme/layout.html\n> @@ -100,11 +100,6 @@\n>    </header>\n>  \n>    <div id=\"content\">\n> -    <div class=\"local-toc\">\n> -      <div class=\"toc-title\">Contents</div>\n> -      {{ toc }}\n> -    </div>\n> -\n>      {# PAGE CONTENT #}\n>      <div class=\"block\">\n>        {% block body %}{% endblock %}\n> diff --git a/Documentation/theme/static/css/theme.css b/Documentation/theme/static/css/theme.css\n> index 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>","headers":{"Return-Path":"<kieran.bingham@ideasonboard.com>","Received":["from perceval.ideasonboard.com (perceval.ideasonboard.com\n\t[213.167.242.64])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 1C1F760BE0\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tMon, 21 Oct 2019 13:03:45 +0200 (CEST)","from [192.168.0.20]\n\t(cpc89242-aztw30-2-0-cust488.18-1.cable.virginm.net [86.31.129.233])\n\tby perceval.ideasonboard.com (Postfix) with ESMTPSA id A85F0595;\n\tMon, 21 Oct 2019 13:03:44 +0200 (CEST)"],"DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1571655824;\n\tbh=VztYyYnwqVw0kKeZ7vKMu7k+8ZRTvfqEGV4wHlNwOTs=;\n\th=Reply-To:Subject:To:References:From:Date:In-Reply-To:From;\n\tb=bng9hhwATnfZBib4so1i3Xcx1OskgwH+rPd2TEWy3qLKWdJn+9YQdpLG4F2U8AgeE\n\tEopdtO0Tyrow+WnZOnMUpSW7hNke5vCEiZ4xTpSFYlJyMUG05srfIIJhKmRYbTcogX\n\tMzLdeFdh+XbIuc5xia8RnnwhOcXmhl9cuD4J/NuA=","Reply-To":"kieran.bingham@ideasonboard.com","To":"Laurent Pinchart <laurent.pinchart@ideasonboard.com>,\n\tlibcamera-devel@lists.libcamera.org","References":"<20191021102453.26471-1-laurent.pinchart@ideasonboard.com>\n\t<20191021102453.26471-4-laurent.pinchart@ideasonboard.com>","From":"Kieran Bingham <kieran.bingham@ideasonboard.com>","Openpgp":"preference=signencrypt","Autocrypt":"addr=kieran.bingham@ideasonboard.com; keydata=\n\tmQINBFYE/WYBEACs1PwjMD9rgCu1hlIiUA1AXR4rv2v+BCLUq//vrX5S5bjzxKAryRf0uHat\n\tV/zwz6hiDrZuHUACDB7X8OaQcwhLaVlq6byfoBr25+hbZG7G3+5EUl9cQ7dQEdvNj6V6y/SC\n\trRanWfelwQThCHckbobWiQJfK9n7rYNcPMq9B8e9F020LFH7Kj6YmO95ewJGgLm+idg1Kb3C\n\tpotzWkXc1xmPzcQ1fvQMOfMwdS+4SNw4rY9f07Xb2K99rjMwZVDgESKIzhsDB5GY465sCsiQ\n\tcSAZRxqE49RTBq2+EQsbrQpIc8XiffAB8qexh5/QPzCmR4kJgCGeHIXBtgRj+nIkCJPZvZtf\n\tKr2EAbc6tgg6DkAEHJb+1okosV09+0+TXywYvtEop/WUOWQ+zo+Y/OBd+8Ptgt1pDRyOBzL8\n\tRXa8ZqRf0Mwg75D+dKntZeJHzPRJyrlfQokngAAs4PaFt6UfS+ypMAF37T6CeDArQC41V3ko\n\tlPn1yMsVD0p+6i3DPvA/GPIksDC4owjnzVX9kM8Zc5Cx+XoAN0w5Eqo4t6qEVbuettxx55gq\n\t8K8FieAjgjMSxngo/HST8TpFeqI5nVeq0/lqtBRQKumuIqDg+Bkr4L1V/PSB6XgQcOdhtd36\n\tOe9X9dXB8YSNt7VjOcO7BTmFn/Z8r92mSAfHXpb07YJWJosQOQARAQABtDBLaWVyYW4gQmlu\n\tZ2hhbSA8a2llcmFuLmJpbmdoYW1AaWRlYXNvbmJvYXJkLmNvbT6JAlcEEwEKAEECGwMFCwkI\n\tBwIGFQgJCgsCBBYCAwECHgECF4ACGQEWIQSQLdeYP70o/eNy1HqhHkZyEKRh/QUCXWTtygUJ\n\tCyJXZAAKCRChHkZyEKRh/f8dEACTDsbLN2nioNZMwyLuQRUAFcXNolDX48xcUXsWS2QjxaPm\n\tVsJx8Uy8aYkS85mdPBh0C83OovQR/OVbr8AxhGvYqBs3nQvbWuTl/+4od7DfK2VZOoKBAu5S\n\tQK2FYuUcikDqYcFWJ8DQnubxfE8dvzojHEkXw0sA4igINHDDFX3HJGZtLio+WpEFQtCbfTAG\n\tYZslasz1YZRbwEdSsmO3/kqy5eMnczlm8a21A3fKUo3g8oAZEFM+f4DUNzqIltg31OAB/kZS\n\tenKZQ/SWC8PmLg/ZXBrReYakxXtkP6w3FwMlzOlhGxqhIRNiAJfXJBaRhuUWzPOpEDE9q5YJ\n\tBmqQL2WJm1VSNNVxbXJHpaWMH1sA2R00vmvRrPXGwyIO0IPYeUYQa3gsy6k+En/aMQJd27dp\n\taScf9am9PFICPY5T4ppneeJLif2lyLojo0mcHOV+uyrds9XkLpp14GfTkeKPdPMrLLTsHRfH\n\tfA4I4OBpRrEPiGIZB/0im98MkGY/Mu6qxeZmYLCcgD6qz4idOvfgVOrNh+aA8HzIVR+RMW8H\n\tQGBN9f0E3kfwxuhl3omo6V7lDw8XOdmuWZNC9zPq1UfryVHANYbLGz9KJ4Aw6M+OgBC2JpkD\n\thXMdHUkC+d20dwXrwHTlrJi1YNp6rBc+xald3wsUPOZ5z8moTHUX/uPA/qhGsbkCDQRWBP1m\n\tARAAzijkb+Sau4hAncr1JjOY+KyFEdUNxRy+hqTJdJfaYihxyaj0Ee0P0zEi35CbE6lgU0Uz\n\ttih9fiUbSV3wfsWqg1Ut3/5rTKu7kLFp15kF7eqvV4uezXRD3Qu4yjv/rMmEJbbD4cTvGCYI\n\td6MDC417f7vK3hCbCVIZSp3GXxyC1LU+UQr3fFcOyCwmP9vDUR9JV0BSqHHxRDdpUXE26Dk6\n\tmhf0V1YkspE5St814ETXpEus2urZE5yJIUROlWPIL+hm3NEWfAP06vsQUyLvr/GtbOT79vXl\n\tEn1aulcYyu20dRRxhkQ6iILaURcxIAVJJKPi8dsoMnS8pB0QW12AHWuirPF0g6DiuUfPmrA5\n\tPKe56IGlpkjc8cO51lIxHkWTpCMWigRdPDexKX+Sb+W9QWK/0JjIc4t3KBaiG8O4yRX8ml2R\n\t+rxfAVKM6V769P/hWoRGdgUMgYHFpHGSgEt80OKK5HeUPy2cngDUXzwrqiM5Sz6Od0qw5pCk\n\tNlXqI0W/who0iSVM+8+RmyY0OEkxEcci7rRLsGnM15B5PjLJjh1f2ULYkv8s4SnDwMZ/kE04\n\t/UqCMK/KnX8pwXEMCjz0h6qWNpGwJ0/tYIgQJZh6bqkvBrDogAvuhf60Sogw+mH8b+PBlx1L\n\toeTK396wc+4c3BfiC6pNtUS5GpsPMMjYMk7kVvEAEQEAAYkCPAQYAQoAJgIbDBYhBJAt15g/\n\tvSj943LUeqEeRnIQpGH9BQJdizzIBQkLSKZiAAoJEKEeRnIQpGH9eYgQAJpjaWNgqNOnMTmD\n\tMJggbwjIotypzIXfhHNCeTkG7+qCDlSaBPclcPGYrTwCt0YWPU2TgGgJrVhYT20ierN8LUvj\n\t6qOPTd+Uk7NFzL65qkh80ZKNBFddx1AabQpSVQKbdcLb8OFs85kuSvFdgqZwgxA1vl4TFhNz\n\tPZ79NAmXLackAx3sOVFhk4WQaKRshCB7cSl+RIng5S/ThOBlwNlcKG7j7W2MC06BlTbdEkUp\n\tECzuuRBv8wX4OQl+hbWbB/VKIx5HKlLu1eypen/5lNVzSqMMIYkkZcjV2SWQyUGxSwq0O/sx\n\tS0A8/atCHUXOboUsn54qdxrVDaK+6jIAuo8JiRWctP16KjzUM7MO0/+4zllM8EY57rXrj48j\n\tsbEYX0YQnzaj+jO6kJtoZsIaYR7rMMq9aUAjyiaEZpmP1qF/2sYenDx0Fg2BSlLvLvXM0vU8\n\tpQk3kgDu7kb/7PRYrZvBsr21EIQoIjXbZxDz/o7z95frkP71EaICttZ6k9q5oxxA5WC6sTXc\n\tMW8zs8avFNuA9VpXt0YupJd2ijtZy2mpZNG02fFVXhIn4G807G7+9mhuC4XG5rKlBBUXTvPU\n\tAfYnB4JBDLmLzBFavQfvonSfbitgXwCG3vS+9HEwAjU30Bar1PEOmIbiAoMzuKeRm2LVpmq4\n\tWZw01QYHU/GUV/zHJSFk","Organization":"Ideas on Board","Message-ID":"<494f3a4a-0d78-a57d-fce9-d02bfc16b420@ideasonboard.com>","Date":"Mon, 21 Oct 2019 12:03:41 +0100","User-Agent":"Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101\n\tThunderbird/60.8.0","MIME-Version":"1.0","In-Reply-To":"<20191021102453.26471-4-laurent.pinchart@ideasonboard.com>","Content-Type":"text/plain; charset=utf-8","Content-Language":"en-GB","Content-Transfer-Encoding":"7bit","Subject":"Re: [libcamera-devel] [PATCH 4/8] Documentation: Generate local TOC\n\ton demand","X-BeenThere":"libcamera-devel@lists.libcamera.org","X-Mailman-Version":"2.1.29","Precedence":"list","List-Id":"<libcamera-devel.lists.libcamera.org>","List-Unsubscribe":"<https://lists.libcamera.org/options/libcamera-devel>,\n\t<mailto:libcamera-devel-request@lists.libcamera.org?subject=unsubscribe>","List-Archive":"<https://lists.libcamera.org/pipermail/libcamera-devel/>","List-Post":"<mailto:libcamera-devel@lists.libcamera.org>","List-Help":"<mailto:libcamera-devel-request@lists.libcamera.org?subject=help>","List-Subscribe":"<https://lists.libcamera.org/listinfo/libcamera-devel>,\n\t<mailto:libcamera-devel-request@lists.libcamera.org?subject=subscribe>","X-List-Received-Date":"Mon, 21 Oct 2019 11:03:45 -0000"}}]