improve reference section headings

zauberzeug · Dec 1, 2023 · 1080948 · 1080948
1 parent 449b9c7
commit 1080948
Show file tree

Hide file tree

Showing 2 changed files with 7 additions and 5 deletions.
diff --git a/website/documentation/rendering.py b/website/documentation/rendering.py
@@ -40,7 +40,7 @@ def render_page(documentation: DocumentationPage, *, with_menu: bool = True) ->
             if part.title:
                 if part.link_target:
                     ui.link_target(part.link_target)
-                subheading(part.title, link=part.link)
+                subheading(part.title, link=part.link, major=part.reference is not None)
             if part.description:
                 if part.description_format == 'rst':
                     description = part.description.replace('param ', '')

diff --git a/website/style.py b/website/style.py
@@ -62,15 +62,16 @@ def side_menu() -> ui.left_drawer:
         .style('height: calc(100% + 20px) !important')
 
 
-def subheading(text: str, *, link: Optional[str] = None) -> None:
+def subheading(text: str, *, link: Optional[str] = None, major: bool = False) -> None:
     """Render a subheading with an anchor that can be linked to with a hash."""
     name = create_anchor_name(text)
     ui.html(f'<div id="{name}"></div>').style('position: relative; top: -90px')
     with ui.row().classes('gap-2 items-center relative'):
+        classes = 'text-3xl' if major else 'text-2xl'
         if link:
-            ui.link(text, link).classes('text-2xl')
+            ui.link(text, link).classes(classes)
         else:
-            ui.label(text).classes('text-2xl')
+            ui.label(text).classes(classes)
         with ui.link(target=f'#{name}').classes('absolute').style('transform: translateX(-150%)'):
             ui.icon('link', size='sm').classes('opacity-10 hover:opacity-80')
     drawers = [element for element in context.get_client().elements.values() if isinstance(element, ui.left_drawer)]
@@ -81,7 +82,8 @@ async def click():
                 if await ui.run_javascript('!!document.querySelector("div.q-drawer__backdrop")', timeout=5.0):
                     menu.hide()
                     ui.open(f'#{name}')
-            ui.link(text, target=f'#{name}').props('data-close-overlay').on('click', click, [])
+            ui.link(text, target=f'#{name}').props('data-close-overlay').on('click', click, []) \
+                .classes('font-bold mt-4' if major else '')
 
 
 def create_anchor_name(text: str) -> str: