From patchwork Mon Oct 21 10:24:46 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Laurent Pinchart X-Patchwork-Id: 2199 Return-Path: Received: from perceval.ideasonboard.com (perceval.ideasonboard.com [213.167.242.64]) by lancelot.ideasonboard.com (Postfix) with ESMTPS id CF77960BE0 for ; Mon, 21 Oct 2019 12:25:04 +0200 (CEST) Received: from pendragon.ideasonboard.com (143.121.2.93.rev.sfr.net [93.2.121.143]) by perceval.ideasonboard.com (Postfix) with ESMTPSA id 0F9A54F7 for ; Mon, 21 Oct 2019 12:25:03 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com; s=mail; t=1571653504; bh=YWEw98PTwKmtE+bOnolSNFbNkJwJLCNvOOm+e7sGQpg=; h=From:To:Subject:Date:From; b=FEgSXpdM3TNYrzwyD915y/lNKTBUt3HrLx9oVfYTjBOLXZ+dFHdNs1F5K6NN5TXx8 /L6SXN+1AWl8hE14E3RM+vaET/ISwjO0C1G/swjYp64Yxn9wCnPMHbVkiMUDsH/Bsn DRY9FRNwLkpSlDNG8Z1eBZ3kmJ/nsQS0URM9NB70= From: Laurent Pinchart To: libcamera-devel@lists.libcamera.org Date: Mon, 21 Oct 2019 13:24:46 +0300 Message-Id: <20191021102453.26471-1-laurent.pinchart@ideasonboard.com> X-Mailer: git-send-email 2.23.0 MIME-Version: 1.0 Subject: [libcamera-devel] [PATCH 1/8] Documentation: Move coding style under contributing X-BeenThere: libcamera-devel@lists.libcamera.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 21 Oct 2019 10:25:05 -0000 The coding style isn't so important that it has to be displayed on the top contents bar. Move it to the contributing section. Signed-off-by: Laurent Pinchart Reviewed-by: Kieran Bingham --- Documentation/coding-style.rst | 6 ++---- Documentation/contributing.rst | 11 +++++++++++ Documentation/index.rst | 1 - 3 files changed, 13 insertions(+), 5 deletions(-) diff --git a/Documentation/coding-style.rst b/Documentation/coding-style.rst index 8dd1afce1a2c..9940ec10f330 100644 --- a/Documentation/coding-style.rst +++ b/Documentation/coding-style.rst @@ -1,10 +1,8 @@ +.. _coding-style-guidelines: + Coding Style Guidelines ======================= -The libcamera project has high standards of stability, efficiency and -reliability. To achieve those, the project goes to great length to produce -code that is as easy to read, understand and maintain as possible. - These coding guidelines are meant to ensure code quality. As a contributor you are expected to follow them in all code submitted to the project. While strict compliance is desired, exceptions are tolerated when justified with diff --git a/Documentation/contributing.rst b/Documentation/contributing.rst index 087f188e5d51..390b96a55699 100644 --- a/Documentation/contributing.rst +++ b/Documentation/contributing.rst @@ -53,6 +53,12 @@ Sphinx integration with Doxygen is planned, likely using `Breathe`_ and Submitting Patches ------------------ +The libcamera project has high standards of stability, efficiency and +reliability. To achieve those, the project goes to great length to produce +code that is as easy to read, understand and maintain as possible. This is +made possible by a set of :ref:`coding-style-guidelines` that all submissions +are expected to follow. + Patches submitted to the libcamera project must be certified as suitable for integration into an open source project. As such libcamera follows the same model as utilised by the Linux kernel, and requires the use of 'Signed-off-by:' @@ -62,3 +68,8 @@ By signing your contributions you are certifying your work in accordance with the `Developer's Certificate of Origin`_ .. _Developer's Certificate of Origin: https://developercertificate.org/ + +.. toctree:: + :hidden: + + Coding Style diff --git a/Documentation/index.rst b/Documentation/index.rst index ec2222108e8a..84d5f6a88caf 100644 --- a/Documentation/index.rst +++ b/Documentation/index.rst @@ -7,6 +7,5 @@ Home Docs - Coding Style Contribute API From patchwork Mon Oct 21 10:24:47 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Laurent Pinchart X-Patchwork-Id: 2200 Return-Path: Received: from perceval.ideasonboard.com (perceval.ideasonboard.com [213.167.242.64]) by lancelot.ideasonboard.com (Postfix) with ESMTPS id 475F16137A for ; Mon, 21 Oct 2019 12:25:05 +0200 (CEST) Received: from pendragon.ideasonboard.com (143.121.2.93.rev.sfr.net [93.2.121.143]) by perceval.ideasonboard.com (Postfix) with ESMTPSA id AB06A540 for ; Mon, 21 Oct 2019 12:25:04 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com; s=mail; t=1571653505; bh=jhNjOsjffyFwRjm3u6DZylhMLFOUhDwJIebVUp7Ouyg=; h=From:To:Subject:Date:In-Reply-To:References:From; b=KFCn1shQgNitc3FMYyPg7fvlVAk1i0IM1gvVYVOx0hTfpdhnnytKoI0cp9hc2k1O3 JNmPOOo/QT3utB8i9eUXdsPC0LIkh/qZNGx+TIuwHHla3raz/uT6RNS8XR3qRjCmOv 8IJc/E81EIWFLoYtJpmyE6fGfxfw2EWqF5ZsAWJA= From: Laurent Pinchart To: libcamera-devel@lists.libcamera.org Date: Mon, 21 Oct 2019 13:24:47 +0300 Message-Id: <20191021102453.26471-2-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 Subject: [libcamera-devel] [PATCH 2/8] Documentation: contributing: Remove Sphinx + Doxygen integration X-BeenThere: libcamera-devel@lists.libcamera.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 21 Oct 2019 10:25:05 -0000 Sphinx integration with Doxygen didn't produce the expected results, we will not go that way. Don't mention it on the contributing page. Signed-off-by: Laurent Pinchart Reviewed-by: Kieran Bingham --- Documentation/contributing.rst | 5 ----- 1 file changed, 5 deletions(-) diff --git a/Documentation/contributing.rst b/Documentation/contributing.rst index 390b96a55699..1cfbd0ec6b25 100644 --- a/Documentation/contributing.rst +++ b/Documentation/contributing.rst @@ -42,13 +42,8 @@ Documentation Project documentation is created using `Sphinx`_. Source level documentation uses `Doxygen`_. Please make sure to document all code during development. -Sphinx integration with Doxygen is planned, likely using `Breathe`_ and -`Exhale`_. - .. _Sphinx: http://www.sphinx-doc.org .. _Doxygen: http://www.doxygen.nl -.. _Breathe: https://breathe.readthedocs.io/en/latest/ -.. _Exhale: https://exhale.readthedocs.io/en/latest/ Submitting Patches ------------------ From patchwork Mon Oct 21 10:24:48 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Laurent Pinchart X-Patchwork-Id: 2201 Return-Path: Received: from perceval.ideasonboard.com (perceval.ideasonboard.com [IPv6:2001:4b98:dc2:55:216:3eff:fef7:d647]) by lancelot.ideasonboard.com (Postfix) with ESMTPS id E182E6137A for ; Mon, 21 Oct 2019 12:25:05 +0200 (CEST) Received: from pendragon.ideasonboard.com (143.121.2.93.rev.sfr.net [93.2.121.143]) by perceval.ideasonboard.com (Postfix) with ESMTPSA id 4D5A64F7 for ; Mon, 21 Oct 2019 12:25:05 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com; s=mail; t=1571653505; bh=XkffmpYxTwv0f8xQb2jxWK9GLzMF+UkKR9znRV5JjI4=; h=From:To:Subject:Date:In-Reply-To:References:From; b=XsbbN6WM6M+egLJRr2d2o1iimNZD47TUMTON4jhnqbKfu5Ba8i7pvd13pA5AZl6aM RSX5N9SP51zzfHmRA/dkvRYeEBI20jO7/M4doOBqKaJHqOB2OYtPgx/0pfgmgKpA1O lEsm5TONJ8TJm9cynq1Bm0sjkoUKfsEA0rPIFAtY= From: Laurent Pinchart To: libcamera-devel@lists.libcamera.org Date: Mon, 21 Oct 2019 13:24:48 +0300 Message-Id: <20191021102453.26471-3-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 Subject: [libcamera-devel] [PATCH 3/8] Documentation: Link to API section in Docs X-BeenThere: libcamera-devel@lists.libcamera.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 21 Oct 2019 10:25:06 -0000 The API belongs to the docs section. Link to it from docs.rst, and remove the shortcut in the navigation bar as links to a placeholder only. Signed-off-by: Laurent Pinchart Reviewed-by: Kieran Bingham --- Documentation/api-html/index.rst | 2 ++ Documentation/docs.rst | 12 ++++++++++++ Documentation/index.rst | 1 - 3 files changed, 14 insertions(+), 1 deletion(-) diff --git a/Documentation/api-html/index.rst b/Documentation/api-html/index.rst index dbaaad1552b6..cf2ef0bb38af 100644 --- a/Documentation/api-html/index.rst +++ b/Documentation/api-html/index.rst @@ -1,3 +1,5 @@ +.. _api: + API === diff --git a/Documentation/docs.rst b/Documentation/docs.rst index cc621a49f412..7a3977c13110 100644 --- a/Documentation/docs.rst +++ b/Documentation/docs.rst @@ -2,6 +2,18 @@ Documentation ************* +.. toctree:: + :hidden: + + API + +API +=== + +The libcamera API is extensively documented using Doxygen. The :ref:`API +nightly build ` contains the most up-to-date API documentation, built from +the latest master branch. + Feature Requirements ==================== diff --git a/Documentation/index.rst b/Documentation/index.rst index 84d5f6a88caf..bbce717edd0e 100644 --- a/Documentation/index.rst +++ b/Documentation/index.rst @@ -8,4 +8,3 @@ Home Docs Contribute - API From patchwork Mon Oct 21 10:24:49 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Laurent Pinchart X-Patchwork-Id: 2202 Return-Path: Received: from perceval.ideasonboard.com (perceval.ideasonboard.com [213.167.242.64]) by lancelot.ideasonboard.com (Postfix) with ESMTPS id BA38960BE0 for ; Mon, 21 Oct 2019 12:25:06 +0200 (CEST) Received: from pendragon.ideasonboard.com (143.121.2.93.rev.sfr.net [93.2.121.143]) by perceval.ideasonboard.com (Postfix) with ESMTPSA id E3EF1540 for ; Mon, 21 Oct 2019 12:25:05 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com; s=mail; t=1571653506; bh=HS4rQo9qmj0jsYhh40wRPtrqUgVpU5CQ8RI8V5//jNM=; h=From:To:Subject:Date:In-Reply-To:References:From; b=wms6CMJhI2AmqhJzQnnQpEYjujkxC5CBYrmwfaGvuzrRjNOqCv60uSZPsrt8Ta1l+ A9H02j0OaD1j4g2dAkn9L2RzI3wBAh91GPKBWfmKnz8rG6dje8wKKn1TJOXKQbEuyQ Pls6M9RyUCxasvoOQazVNiNndHoXiQ8XPWI5l61Q= 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 Subject: [libcamera-devel] [PATCH 4/8] Documentation: Generate local TOC on demand X-BeenThere: libcamera-devel@lists.libcamera.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 21 Oct 2019 10:25:06 -0000 All pages are generated with a local TOC, which is pointless on simple pages such as the front page, or other pages containing little content. Use the .. contents:: :local: directive instead to generate the local TOC on demand, and remove the automatic local TOC generation. Only the Docs page uses a local TOC. Signed-off-by: Laurent Pinchart Reviewed-by: Kieran Bingham --- Documentation/docs.rst | 3 ++ Documentation/theme/layout.html | 5 ---- Documentation/theme/static/css/theme.css | 38 ++++++++++++++++-------- 3 files changed, 29 insertions(+), 17 deletions(-) diff --git a/Documentation/docs.rst b/Documentation/docs.rst index 7a3977c13110..7cb6059616fd 100644 --- a/Documentation/docs.rst +++ b/Documentation/docs.rst @@ -1,3 +1,6 @@ +.. contents:: + :local: + ************* Documentation ************* diff --git a/Documentation/theme/layout.html b/Documentation/theme/layout.html index a5cc2776adf5..139c39c7cc38 100644 --- a/Documentation/theme/layout.html +++ b/Documentation/theme/layout.html @@ -100,11 +100,6 @@
-
-
Contents
- {{ toc }} -
- {# PAGE CONTENT #}
{% block body %}{% endblock %} diff --git a/Documentation/theme/static/css/theme.css b/Documentation/theme/static/css/theme.css index 047aff07dddb..4901bbf564f7 100644 --- a/Documentation/theme/static/css/theme.css +++ b/Documentation/theme/static/css/theme.css @@ -24,6 +24,10 @@ a.headerlink { visibility: hidden; } +a.toc-backref { + text-decoration: none; +} + h1:hover a.headerlink, h2:hover a.headerlink, h3:hover a.headerlink, @@ -206,37 +210,47 @@ div#content { div#content > div.block { font-size: 16px; margin-right: 0px; - margin-left: 20px; - max-width: 800px; - padding: 20px 60px 0px 60px; + margin-left: 0px; + max-width: 1280px; + padding: 0px 60px 0px 60px; text-align: justify; - width: 70%; } div#content > div.block h1 { color: black; font-size: 40px; + margin-top: 0px; text-align: left; } -div.local-toc { +div#content > div.block > div.section { + max-width: 800px; +} + +div.local.topic { float: right; background-color: #fcfcff; border: 1px dotted #4896e0; - margin-right: 100px; + margin-left: 20px; + margin-right: 0px; + max-width: 15em; padding: 10px 20px 10px 10px; + text-align: left; } -div.toc-title { - font-weight: bold; -} - -div.local-toc ul { +div.local.topic ul { padding-left: 20px; margin-bottom: 5px; } -div.local-toc a { +div.local.topic > ul:before { + content: "Contents"; + display: block; + font-weight: bold; + margin-bottom: 10px; +} + +div.local.topic a { font-weight: normal; padding-left: 10px; text-decoration: none; From patchwork Mon Oct 21 10:24:50 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Laurent Pinchart X-Patchwork-Id: 2203 Return-Path: Received: from perceval.ideasonboard.com (perceval.ideasonboard.com [213.167.242.64]) by lancelot.ideasonboard.com (Postfix) with ESMTPS id 88B826138F for ; Mon, 21 Oct 2019 12:25:07 +0200 (CEST) Received: from pendragon.ideasonboard.com (143.121.2.93.rev.sfr.net [93.2.121.143]) by perceval.ideasonboard.com (Postfix) with ESMTPSA id B8FB44F7 for ; Mon, 21 Oct 2019 12:25:06 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com; s=mail; t=1571653507; bh=6afvO9MvAYVxZOI8fQGRqm1NNky24RFCf6UatWlRYLw=; h=From:To:Subject:Date:In-Reply-To:References:From; b=m4Irnzrc+jcf6+rkIpuUIKokhBw1L/3l+K+tf/vqa7t+GOr/PnXS3jhowqJCN2jxb VhhBhaZZwzggfam/2pDdTlm2wrqFx414LKBS68jXMjB1MIeswRStYdI1+3aL2JFgb6 F7UJqe+tIWcQH6EJnOLJ2GRH+jGfHmatzelE8lBg= From: Laurent Pinchart To: libcamera-devel@lists.libcamera.org Date: Mon, 21 Oct 2019 13:24:50 +0300 Message-Id: <20191021102453.26471-5-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 Subject: [libcamera-devel] [PATCH 5/8] Documentation: Set the index TOC max depth to 1 X-BeenThere: libcamera-devel@lists.libcamera.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 21 Oct 2019 10:25:08 -0000 We don't need more than one level in the main TOC tree, set the max depth to 1. Signed-off-by: Laurent Pinchart Reviewed-by: Kieran Bingham --- Documentation/index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/index.rst b/Documentation/index.rst index bbce717edd0e..28267cec36b7 100644 --- a/Documentation/index.rst +++ b/Documentation/index.rst @@ -2,7 +2,7 @@ .. include:: ../README.rst .. toctree:: - :maxdepth: 2 + :maxdepth: 1 :caption: Contents: Home From patchwork Mon Oct 21 10:24:51 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Laurent Pinchart X-Patchwork-Id: 2204 Return-Path: Received: from perceval.ideasonboard.com (perceval.ideasonboard.com [IPv6:2001:4b98:dc2:55:216:3eff:fef7:d647]) by lancelot.ideasonboard.com (Postfix) with ESMTPS id 13B6060BE0 for ; Mon, 21 Oct 2019 12:25:08 +0200 (CEST) Received: from pendragon.ideasonboard.com (143.121.2.93.rev.sfr.net [93.2.121.143]) by perceval.ideasonboard.com (Postfix) with ESMTPSA id 5A2E3B60 for ; Mon, 21 Oct 2019 12:25:07 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com; s=mail; t=1571653507; bh=qswvO/I44xdZq45UTopwEsOZ07PmoHAKyOF1zjDo/08=; h=From:To:Subject:Date:In-Reply-To:References:From; b=WLfPdiZQlBJ7YZmPEtYA6cdpcuof4tV2C9UwRiupltpzVYs9Y2ejIuip6G0q/tHqE T/d4bgITnhV1QlatCyAlin14IlwKj22gWFtG/OHgbMNMP8aj8kFSm7a74XLL0XBMsn YjQ4cvDWtJo+fy+lKqH/6bSh2SctWyIz8CgOxef0= From: Laurent Pinchart To: libcamera-devel@lists.libcamera.org Date: Mon, 21 Oct 2019 13:24:51 +0300 Message-Id: <20191021102453.26471-6-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 Subject: [libcamera-devel] [PATCH 6/8] Documentation: Hide the Getting Started information X-BeenThere: libcamera-devel@lists.libcamera.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 21 Oct 2019 10:25:09 -0000 The Getting Started information makes little sense on the generated documentation, as a developer with documentation compiled from a local libcamera source tree has already got started. We however want to keep the information in the top-level README.rst as it is useful there. In order to hide the Getting Started information from the front page while keeping it in README.rst, add comments to delimitate sections of README.rst, and include only a subset of the file in the front page. Signed-off-by: Laurent Pinchart Reviewed-by: Kieran Bingham --- Documentation/index.rst | 2 ++ README.rst | 9 ++++++++- 2 files changed, 10 insertions(+), 1 deletion(-) diff --git a/Documentation/index.rst b/Documentation/index.rst index 28267cec36b7..2c84a5401506 100644 --- a/Documentation/index.rst +++ b/Documentation/index.rst @@ -1,5 +1,7 @@ .. Front page matter is defined in the project README file. .. include:: ../README.rst + :start-after: .. section-begin-libcamera + :end-before: .. section-end-libcamera .. toctree:: :maxdepth: 1 diff --git a/README.rst b/README.rst index 2ccf7cbec40a..220ebdb17a42 100644 --- a/README.rst +++ b/README.rst @@ -1,3 +1,5 @@ +.. section-begin-libcamera + =========== libcamera =========== @@ -18,6 +20,9 @@ open-source-friendly while still protecting vendor core IP. libcamera was born out of that collaboration and will offer modern camera support to Linux-based systems, including traditional Linux distributions, ChromeOS and Android. +.. section-end-libcamera +.. section-begin-getting-started + Getting Started --------------- @@ -31,7 +36,7 @@ To build and install: ninja install Dependencies ------------- +~~~~~~~~~~~~ The following Debian/Ubuntu packages are required for building libcamera. Other distributions may have differing package names: @@ -50,3 +55,5 @@ for qcam: [optional] for documentation: [optional] python3-sphinx doxygen + +.. section-end-getting-started From patchwork Mon Oct 21 10:24:52 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Laurent Pinchart X-Patchwork-Id: 2205 Return-Path: Received: from perceval.ideasonboard.com (perceval.ideasonboard.com [IPv6:2001:4b98:dc2:55:216:3eff:fef7:d647]) by lancelot.ideasonboard.com (Postfix) with ESMTPS id 64D926139C for ; Mon, 21 Oct 2019 12:25:08 +0200 (CEST) Received: from pendragon.ideasonboard.com (143.121.2.93.rev.sfr.net [93.2.121.143]) by perceval.ideasonboard.com (Postfix) with ESMTPSA id DCB2DF94 for ; Mon, 21 Oct 2019 12:25:07 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com; s=mail; t=1571653508; bh=fPNrDv1imK1jLgXPDVmfE+6ZHf0Krd3uVr0BRAVAJ/U=; h=From:To:Subject:Date:In-Reply-To:References:From; b=sSnp6g1KjhI6a2XuBJh5WgDHnccVJVuzoftpmXedbWmJh8B8w0kvhsS0sZEHvc73I KQ4sdlZNDz2QDkH1O6HS9s5gGCzGBz4SHbfj3EOLG+EBxhjEvO1ZvY0RIZDOSzCyUR 1Kq6oukmk+/5PuAekFOKyaZvl8+xeqt3FpGsW2rY= From: Laurent Pinchart To: libcamera-devel@lists.libcamera.org Date: Mon, 21 Oct 2019 13:24:52 +0300 Message-Id: <20191021102453.26471-7-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 Subject: [libcamera-devel] [PATCH 7/8] Documentation: theme: css: Make text darker X-BeenThere: libcamera-devel@lists.libcamera.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 21 Oct 2019 10:25:09 -0000 The text is currently rendered as a 50% gray, which is a bit painful to read in low light conditions. Make it darker. Signed-off-by: Laurent Pinchart Reviewed-by: Kieran Bingham --- Documentation/theme/static/css/theme.css | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/Documentation/theme/static/css/theme.css b/Documentation/theme/static/css/theme.css index 4901bbf564f7..60f3510d88fa 100644 --- a/Documentation/theme/static/css/theme.css +++ b/Documentation/theme/static/css/theme.css @@ -6,7 +6,7 @@ html { } body { - color: rgb(0, 0, 0, 0.5); + color: rgb(0, 0, 0, 0.65); font-family: Arial, sans-serif; margin: 0px; } @@ -217,7 +217,6 @@ div#content > div.block { } div#content > div.block h1 { - color: black; font-size: 40px; margin-top: 0px; text-align: left; From patchwork Mon Oct 21 10:24:53 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Laurent Pinchart X-Patchwork-Id: 2206 Return-Path: Received: from perceval.ideasonboard.com (perceval.ideasonboard.com [IPv6:2001:4b98:dc2:55:216:3eff:fef7:d647]) by lancelot.ideasonboard.com (Postfix) with ESMTPS id 6E155613A0 for ; Mon, 21 Oct 2019 12:25:08 +0200 (CEST) Received: from pendragon.ideasonboard.com (143.121.2.93.rev.sfr.net [93.2.121.143]) by perceval.ideasonboard.com (Postfix) with ESMTPSA id 1E22B540 for ; Mon, 21 Oct 2019 12:25:08 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com; s=mail; t=1571653508; bh=ubpOSqDG9b05ErxaWKApFMVTMboV3WEXlFjLCqGR9YE=; h=From:To:Subject:Date:In-Reply-To:References:From; b=bFROm2S5phaGW9huhId/LW6Z8gtQb5qpXj4EyHEiNrc8/M5oRKk/QHZx37S6pcOQe O2vLhbSxTSKxcSTUEtHByJ0Lc8XVEAM+XOAM3bpQZo2UJvgrz03WuGjmGx9/55VQSg ua3NKrMSzbTVRMY6tnInDP4E4Z5K4j/7pww/CnxQ= From: Laurent Pinchart To: libcamera-devel@lists.libcamera.org Date: Mon, 21 Oct 2019 13:24:53 +0300 Message-Id: <20191021102453.26471-8-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 Subject: [libcamera-devel] [PATCH 8/8] Documentation: theme: css: Really hide toc trees X-BeenThere: libcamera-devel@lists.libcamera.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 21 Oct 2019 10:25:09 -0000 The toc trees are rendered as hidden but still take space due to their margin and padding. Really hide them. While at it, don't handle overflow with scrollbars in the content area, the whole page should be scrollable. Signed-off-by: Laurent Pinchart Reviewed-by: Kieran Bingham --- Documentation/theme/static/css/theme.css | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/Documentation/theme/static/css/theme.css b/Documentation/theme/static/css/theme.css index 60f3510d88fa..a4934edeeb8f 100644 --- a/Documentation/theme/static/css/theme.css +++ b/Documentation/theme/static/css/theme.css @@ -204,7 +204,6 @@ div#content { padding-bottom: 50px; margin-left: 0px; margin-right: 0px; - overflow: auto; } div#content > div.block { @@ -283,5 +282,8 @@ div#signature { } #libcamera div.toctree-wrapper { + height: 0px; + margin: 0px; + padding: 0px; visibility: hidden; }