From ba4433ceac19bcb48f1fc052b5f14a45942e4355 Mon Sep 17 00:00:00 2001 From: Fabian Hartung Date: Wed, 6 May 2026 11:57:27 +0200 Subject: [PATCH 1/9] fix: prevent stretched words in documentation tables - Overrides justified paragraph alignment inside table headers and cells. - Fixes stretched words in multi-line table headers, such as German Eichrecht Supported, where German and Eichrecht were spaced too far apart. Signed-off-by: Fabian Hartung --- docs/source/_static/css/cb_theme.css | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/source/_static/css/cb_theme.css b/docs/source/_static/css/cb_theme.css index 9266f45..7a8e707 100644 --- a/docs/source/_static/css/cb_theme.css +++ b/docs/source/_static/css/cb_theme.css @@ -202,6 +202,11 @@ dl.field-list>dt { background-color: #1c354f !important; } +.document .bodywrapper table.docutils th p, +.document .bodywrapper table.docutils td p { + text-align: left !important; +} + .document .bodywrapper .note { background-color: #1c354f !important; } From abf7b6b6c86246f7ebaf50b8f97da68ab0a7ed1c Mon Sep 17 00:00:00 2001 From: Fabian Hartung Date: Thu, 7 May 2026 07:57:36 +0200 Subject: [PATCH 2/9] style: improve footnote styling in docs theme Signed-off-by: Fabian Hartung --- docs/source/_static/css/cb_theme.css | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/docs/source/_static/css/cb_theme.css b/docs/source/_static/css/cb_theme.css index 7a8e707..1701726 100644 --- a/docs/source/_static/css/cb_theme.css +++ b/docs/source/_static/css/cb_theme.css @@ -207,6 +207,31 @@ dl.field-list>dt { text-align: left !important; } +.document .bodywrapper .footnote:target { + background-color: transparent !important; +} + +.document .bodywrapper .footnote-reference, +.document .bodywrapper .footnote .label, +.document .bodywrapper .footnote .label a, +.document .bodywrapper .footnote .fn-bracket { + color: #ff8200 !important; +} + +.document .bodywrapper .footnote, +.document .bodywrapper .footnote p { + line-height: 1.2 !important; +} + +.document .bodywrapper .footnote { + margin: 0.2em 0 !important; +} + +.document .bodywrapper .footnote p { + margin-top: 0 !important; + margin-bottom: 0 !important; +} + .document .bodywrapper .note { background-color: #1c354f !important; } From 86ff15526e456d3983bea5589f9439b7b335aae5 Mon Sep 17 00:00:00 2001 From: Fabian Hartung Date: Thu, 7 May 2026 08:07:37 +0200 Subject: [PATCH 3/9] style: normalize and center docs captions Signed-off-by: Fabian Hartung --- docs/source/_static/css/cb_theme.css | 21 +++++++++++++++++---- 1 file changed, 17 insertions(+), 4 deletions(-) diff --git a/docs/source/_static/css/cb_theme.css b/docs/source/_static/css/cb_theme.css index 1701726..c689df1 100644 --- a/docs/source/_static/css/cb_theme.css +++ b/docs/source/_static/css/cb_theme.css @@ -30,8 +30,18 @@ body { line-height: 1.5 !important; } -.document .bodywrapper .body p span.caption-text { - font-size: 30px !important; +.document .bodywrapper .body p.caption, +.document .bodywrapper .body caption, +.document .bodywrapper .body span.caption-number, +.document .bodywrapper .body span.caption-text { + font-size: 18px !important; + line-height: 1.5 !important; +} + +.document .bodywrapper .body figure figcaption, +.document .bodywrapper .body figure figcaption p, +.document .bodywrapper .body div.figure p.caption { + text-align: center !important; } .document .bodywrapper .body p strong, @@ -284,8 +294,11 @@ dl.field-list>dt { font-size: 17px !important; } - .document .bodywrapper .body p span.caption-text { - font-size: 22px !important; + .document .bodywrapper .body p.caption, + .document .bodywrapper .body caption, + .document .bodywrapper .body span.caption-number, + .document .bodywrapper .body span.caption-text { + font-size: 14px !important; } .document .bodywrapper .body .toctree-wrapper.compound ul li.toctree-l1 a { From 32884ac05a4b79d55284bb9b60a47024e22a301f Mon Sep 17 00:00:00 2001 From: Fabian Hartung Date: Thu, 7 May 2026 08:28:17 +0200 Subject: [PATCH 4/9] style: improve docs heading spacing Signed-off-by: Fabian Hartung --- docs/source/_static/css/cb_theme.css | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/docs/source/_static/css/cb_theme.css b/docs/source/_static/css/cb_theme.css index c689df1..4b906a2 100644 --- a/docs/source/_static/css/cb_theme.css +++ b/docs/source/_static/css/cb_theme.css @@ -112,7 +112,7 @@ body { font-size: 36px !important; font-family: "Open Sans", sans-serif !important; font-weight: 600 !important; - margin: 0 !important; + margin: 1.5em 0 0.5em !important; padding: 0 !important; border-bottom: none !important; background-color: #111827 !important; @@ -123,7 +123,7 @@ body { font-size: 30px !important; font-family: "Open Sans", sans-serif !important; font-weight: 600 !important; - margin: 0 !important; + margin: 1.25em 0 0.45em !important; padding: 0 !important; background-color: #111827 !important; color: #fff !important; @@ -134,13 +134,21 @@ body { font-size: 26px !important; font-family: "Open Sans", sans-serif !important; font-weight: 600 !important; - margin: 0 !important; + margin: 1em 0 0.4em !important; padding: 0 !important; background-color: #ff8200 !important; border-bottom: none !important; color: #fff !important; } +.document .bodywrapper section>h2+section>h3 { + margin-top: 0.2em !important; +} + +.document .bodywrapper section>h3+section>h4 { + margin-top: 0.2em !important; +} + .document .bodywrapper .highlight { background: #153659 !important; } From 820bbf6acf28f5c990c494e703d9e296cac2b5a2 Mon Sep 17 00:00:00 2001 From: Fabian Hartung Date: Thu, 7 May 2026 08:36:23 +0200 Subject: [PATCH 5/9] style: tighten figure caption spacing Signed-off-by: Fabian Hartung --- docs/source/_static/css/cb_theme.css | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/source/_static/css/cb_theme.css b/docs/source/_static/css/cb_theme.css index 4b906a2..b6b91c0 100644 --- a/docs/source/_static/css/cb_theme.css +++ b/docs/source/_static/css/cb_theme.css @@ -44,6 +44,16 @@ body { text-align: center !important; } +.document .bodywrapper .body figure figcaption, +.document .bodywrapper .body div.figure p.caption { + padding-top: 0.1em !important; +} + +.document .bodywrapper .body figure figcaption p, +.document .bodywrapper .body div.figure p.caption { + margin-top: 0.1em !important; +} + .document .bodywrapper .body p strong, .document .bodywrapper .body p a span { color: #ff8200 !important; From 4ad89f2bcc7a66183762a5b5c0888687ff945deb Mon Sep 17 00:00:00 2001 From: Fabian Hartung Date: Thu, 7 May 2026 08:50:06 +0200 Subject: [PATCH 6/9] style: add colons to numbered docs captions Signed-off-by: Fabian Hartung --- docs/source/conf.py | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/source/conf.py b/docs/source/conf.py index a564366..a70ee21 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -19,6 +19,12 @@ exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store'] numfig = True +numfig_format = { + 'figure': 'Fig. %s:', + 'table': 'Table %s:', + 'code-block': 'Listing %s', + 'section': 'Section %s', +} jinja2_contexts = { 'target-info': { From 4a32e21e099e8c0c6e19f044e999d009a9638c05 Mon Sep 17 00:00:00 2001 From: Fabian Hartung Date: Thu, 7 May 2026 08:52:06 +0200 Subject: [PATCH 7/9] docs: replace raw HTML captions with Sphinx captions Signed-off-by: Fabian Hartung --- docs/source/firmware.rst | 9 ++---- docs/source/getting_started.rst | 50 +++++++++++++++------------------ docs/source/introduction.rst | 26 ++++++++--------- 3 files changed, 36 insertions(+), 49 deletions(-) diff --git a/docs/source/firmware.rst b/docs/source/firmware.rst index a952fb4..9ddd44f 100644 --- a/docs/source/firmware.rst +++ b/docs/source/firmware.rst @@ -39,16 +39,11 @@ versa, leaving the other as the rollback system. - 128 MB - Logging file system B (/var/log) -.. image:: ../../includes/_static/images/mountpoints.svg +.. figure:: ../../includes/_static/images/mountpoints.svg :alt: Filesystem-Mountpoints :align: center -.. adding a center-aligned caption for the image -.. raw:: html - -
- Filesystem Mountpoints -
+ Filesystem Mountpoints .. _update_from_chargebyte_to_everest: diff --git a/docs/source/getting_started.rst b/docs/source/getting_started.rst index 3cdf00f..91c369b 100644 --- a/docs/source/getting_started.rst +++ b/docs/source/getting_started.rst @@ -76,33 +76,29 @@ Now you can plug in the Charge Control C to the power supply. The LED status ind Charge Control C provide information about the current status of the boot process. The following table shows the meaning of the LED status indicators: -.. raw:: html - -
- Table: Charge Control C LED Status Indicators -
- -+--------------------------+---------------------------------+------------------------------------+ -| State | LED indication | Behavior | -+==========================+=================================+====================================+ -| Bootloader active | LED1 (green) | off | -| +---------------------------------+------------------------------------+ -| | LED2 (yellow) | off | -| +---------------------------------+------------------------------------+ -| | LED3 (red) | permanently on for approx. 3 sec. | -+--------------------------+---------------------------------+------------------------------------+ -| Boot process running | LED1 (green) | blinking for approx. 15 sec. | -| +---------------------------------+------------------------------------+ -| | LED2 (yellow) | off | -| +---------------------------------+------------------------------------+ -| | LED3 (red) | blinking | -+--------------------------+---------------------------------+------------------------------------+ -| Operating system running | LED1 (green) | permanently on | -| +---------------------------------+------------------------------------+ -| | LED2 (yellow) | off | -| +---------------------------------+------------------------------------+ -| | LED3 (red) | blinking | -+--------------------------+---------------------------------+------------------------------------+ +.. table:: Charge Control C LED Status Indicators + + +--------------------------+---------------------------------+------------------------------------+ + | State | LED indication | Behavior | + +==========================+=================================+====================================+ + | Bootloader active | LED1 (green) | off | + | +---------------------------------+------------------------------------+ + | | LED2 (yellow) | off | + | +---------------------------------+------------------------------------+ + | | LED3 (red) | permanently on for approx. 3 sec. | + +--------------------------+---------------------------------+------------------------------------+ + | Boot process running | LED1 (green) | blinking for approx. 15 sec. | + | +---------------------------------+------------------------------------+ + | | LED2 (yellow) | off | + | +---------------------------------+------------------------------------+ + | | LED3 (red) | blinking | + +--------------------------+---------------------------------+------------------------------------+ + | Operating system running | LED1 (green) | permanently on | + | +---------------------------------+------------------------------------+ + | | LED2 (yellow) | off | + | +---------------------------------+------------------------------------+ + | | LED3 (red) | blinking | + +--------------------------+---------------------------------+------------------------------------+ .. include:: ../../includes/connecting.inc diff --git a/docs/source/introduction.rst b/docs/source/introduction.rst index 93ad765..ba37918 100644 --- a/docs/source/introduction.rst +++ b/docs/source/introduction.rst @@ -92,21 +92,17 @@ Order Information Here are the currently available order codes for Charge Control C with EVerest: -.. raw:: html - -
- Table: Currently available order codes for Charge Control C with EVerest -
- -+----------------------+----------------------------------+------------+----------------------+ -| Available Order Code | SW Variant | Housing | HW Variant | -+======================+==================================+============+======================+ -| I2CCSC-E00-204 | chargebyte software stack v0.8.0 | no housing | Charge Control 200 | -| | based on EVerest 2024.3.0 | | (1x EIA-485, no CAN) | -+----------------------+----------------------------------+------------+----------------------+ -| I2CCSC-E00-303 | chargebyte software stack v0.8.0 | no housing | Charge Control 300 | -| | based on EVerest 2024.3.0 | | (2x EIA-485, no CAN) | -+----------------------+----------------------------------+------------+----------------------+ +.. table:: Currently available order codes for Charge Control C with EVerest + + +----------------------+----------------------------------+------------+----------------------+ + | Available Order Code | SW Variant | Housing | HW Variant | + +======================+==================================+============+======================+ + | I2CCSC-E00-204 | chargebyte software stack v0.8.0 | no housing | Charge Control 200 | + | | based on EVerest 2024.3.0 | | (1x EIA-485, no CAN) | + +----------------------+----------------------------------+------------+----------------------+ + | I2CCSC-E00-303 | chargebyte software stack v0.8.0 | no housing | Charge Control 300 | + | | based on EVerest 2024.3.0 | | (2x EIA-485, no CAN) | + +----------------------+----------------------------------+------------+----------------------+ The following figure shows the structure of the "I2CCSC-E00-204" order code: From 94a0a3f7430d486c4b3a6eb81e5d419ffe718a48 Mon Sep 17 00:00:00 2001 From: Fabian Hartung Date: Thu, 7 May 2026 09:21:56 +0200 Subject: [PATCH 8/9] style: prevent nav button hover layout shift Signed-off-by: Fabian Hartung --- docs/source/_static/css/cb_theme.css | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/source/_static/css/cb_theme.css b/docs/source/_static/css/cb_theme.css index b6b91c0..8e4e7ec 100644 --- a/docs/source/_static/css/cb_theme.css +++ b/docs/source/_static/css/cb_theme.css @@ -205,14 +205,17 @@ body { } .related ul li.right a { + display: inline-block; text-transform: capitalize; padding: 10px 15px; background-color: #ff8200; border-radius: 5px; + transition: background-color 0.15s ease, transform 0.15s ease; } .related ul li.right a:hover { - padding: 11px 17px; + background-color: #ff9a26; + transform: scale(1.05); text-decoration: none; } From bc2b97909f32cbf18bee414d13b0d9e4dcadd142 Mon Sep 17 00:00:00 2001 From: Fabian Hartung Date: Thu, 7 May 2026 10:24:42 +0200 Subject: [PATCH 9/9] style: refine Sphinx sidebar navigation styling Signed-off-by: Fabian Hartung --- docs/source/_static/css/cb_theme.css | 20 +++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/docs/source/_static/css/cb_theme.css b/docs/source/_static/css/cb_theme.css index 8e4e7ec..9d5e7a5 100644 --- a/docs/source/_static/css/cb_theme.css +++ b/docs/source/_static/css/cb_theme.css @@ -83,14 +83,32 @@ body { } .document .sphinxsidebar .sphinxsidebarwrapper h4 { - font-size: 18px !important; + color: #fff !important; + font-size: 16px !important; font-family: "Open Sans", sans-serif !important; + font-weight: 700 !important; + margin: 16px 0 2px !important; + text-transform: capitalize !important; +} + +.document .sphinxsidebar .sphinxsidebarwrapper h4::after { + content: ":" !important; } .document .sphinxsidebar .sphinxsidebarwrapper .topless a { + display: inline !important; font-size: 18px !important; font-family: "Open Sans", sans-serif !important; color: #fff !important; + line-height: 1.25 !important; + padding: 0 !important; + background-color: transparent !important; + text-decoration: none !important; + transition: color 0.15s ease !important; +} + +.document .sphinxsidebar .sphinxsidebarwrapper .topless a:hover { + color: #ff8200 !important; } .document .sphinxsidebar .sphinxsidebarwrapper p {