solara 1.30.0__py2.py3-none-any.whl → 1.30.1__py2.py3-none-any.whl

solara/__init__.py

@@ -1,5 +1,5 @@
 """Build webapps using IPywidgets"""
-__version__ = "1.30.0"
+__version__ = "1.30.1"
 github_url = "https://github.com/widgetti/solara"
 git_branch = "master"
 

solara/autorouting.py

@@ -24,6 +24,7 @@ DEBUG = False
 solara_root = Path(solara.__file__).parent
 
 DefaultLayout = solara.AppLayout
+_redirects: Dict[str, str] = {}
 
 
 def source_to_module(path: Path, initial_namespace={}) -> ModuleType:
@@ -89,12 +90,17 @@ def arg_cast(args: List[str], f: Callable):
 def RoutingProvider(children: List[reacton.core.Element] = [], routes: List[solara.Route] = [], pathname: str = ""):
     """Wraps the app, adds extra context, like navigation/routing."""
     path, set_path = solara.use_state(pathname, key="solara-context-path")
+
+    def set_path_with_redirect(path):
+        path = _redirects.get(path, path)
+        set_path(path)
+
     # TODO: since we provide a cross filter context here, I don't think name `RoutingProvider` is a good name
     # we might want to change/refactor this.
     solara.provide_cross_filter()
-    nav = solara.Navigator(location=path, on_location=set_path)
-    solara.routing._location_context.provide(solara.routing._Location(path, set_path))
-    solara.routing.router_context.provide(solara.routing.Router(path, routes=routes, set_path=set_path))
+    nav = solara.Navigator(location=path, on_location=set_path_with_redirect)
+    solara.routing._location_context.provide(solara.routing._Location(path, set_path_with_redirect))
+    solara.routing.router_context.provide(solara.routing.Router(path, routes=routes, set_path=set_path_with_redirect))
 
     def get_nav_widget():
         # not sure why get_widget(nav) does not work
@@ -145,7 +151,7 @@ def RenderPage(main_name: str = "Page"):
 
     layouts = []  # nested layouts
     level_max = len(router.path_routes) - 1
-    for level in range(level_max + 1):
+    for level in range(len(router.path_routes)):
         # we always level_start the 'package'/'root' layout
         roots = [k for k in router.path_routes_siblings[level] if k.path == "/"]
         if len(roots) == 1:
@@ -156,20 +162,21 @@ def RenderPage(main_name: str = "Page"):
         # and, if not the root layout, include the layout for the current route
         if route.path != "/" and route.layout:
             layouts.append(route.layout)
-        # used in for example the docs for use_route, only the route path are specified,
-        # nothing else, which means we will not follow that route path, but limit it to rendering
-        # router.path_routes[level_max] instead. It's assumed that component (Page) will continue
-        # handling the rest of the routing
-        if route.data is None and route.module is None and route.component is None:
-            level_max = level - 1
+        # We found the leaf (or node) that defines a component or markdown file
+        if (route.file and route.file.suffix == ".md") or route.component:
+            level_max = level
+            break
+
     route_current = router.path_routes[level_max]
     routes_siblings = router.path_routes_siblings[level_max]
     routes_siblings_index = routes_siblings.index(route_current)
+
     # if no layouts are found, we use the default layout
     if layouts == []:
         layouts = [DefaultLayout]
-    if route_current.data is None and route_current.module is None and route_current.component is None:
-        return solara.Error(f"Page not found: {router.path}, route does not link to a path or module or component")
+
+    if route_current.component is None and route_current.module is None and (route_current.file is None or route_current.file.suffix != ".md"):
+        return solara.Error(f"Page not found: {router.path}, route does not link to a (markdown) path or module or component")
 
     def wrap_in_layouts(element: reacton.core.Element, layouts):
         for Layout in reversed(layouts):
@@ -184,9 +191,10 @@ def RenderPage(main_name: str = "Page"):
         else:
             return []
 
-    if isinstance(route_current.data, Path):
+    if str(route_current.file).endswith(".md") or isinstance(route_current.data, Path):
         path = cast(Path, route_current.data)
         if path.suffix == ".md":
+            component = route_current.component or solara.Markdown
             with solara.HBox() as navigation:
                 if routes_siblings_index > 0:
                     prev = routes_siblings[routes_siblings_index - 1]
@@ -206,9 +214,11 @@ def RenderPage(main_name: str = "Page"):
                         solara.Button(
                             icon_name="mdi-pencil", icon=True, href=url, target="_blank", style={"position": "absolute", "top": "0px", "right": "0px"}
                         )
-                    solara.Markdown(path.read_text(), unsafe_solara_execute=True)
+                    # solara.Markdown(path.read_text(), unsafe_solara_execute=True)
+                    component(path.read_text(), unsafe_solara_execute=True)
             else:
-                content = solara.Markdown(path.read_text(), unsafe_solara_execute=True)
+                # content = solara.Markdown(path.read_text(), unsafe_solara_execute=True)
+                content = component(path.read_text(), unsafe_solara_execute=True)
 
             main = solara.Div(
                 classes=["solara-autorouter-content"],
@@ -401,7 +411,6 @@ def generate_routes(module: ModuleType) -> List[solara.Route]:
         reload.reloader.watcher.add_file(module.__file__)
         for info in pkgutil.iter_modules([str(Path(module.__file__).parent)]):
             submod = importlib.import_module(module.__name__ + f".{info.name}")
-            subfile = Path(submod.__file__) if submod.__file__ is not None else None
             title = get_title(submod)
 
             name = info.name
@@ -409,9 +418,11 @@ def generate_routes(module: ModuleType) -> List[solara.Route]:
             # however, this may break things.
             # name = name.replace("_", "-")
             if info.ispkg:
-                route = solara.Route(
-                    name, component=get_page(submod, required=False), children=generate_routes(submod), module=submod, layout=None, label=title
-                )
+                # we are in a package, like 'portal/solara_portal/pages', not the module itself
+                # (e.g. portal/solara_portal/pages/__init__.py)
+                # so here name='pages', and the children will come from the submodules
+                children = generate_routes(submod)
+                route = solara.Route(name, component=None, children=children, module=submod, layout=None, label=title)
                 # skip empty subpackages
                 if len(route.children) == 0:
                     continue
@@ -419,13 +430,7 @@ def generate_routes(module: ModuleType) -> List[solara.Route]:
                 # skip empty modules
                 if get_renderable(submod) is None and not hasattr(submod, "routes"):
                     continue
-                children = getattr(submod, "routes", [])
-                if subfile:
-                    children = fix_routes(children, subfile)
-                module_layout = getattr(submod, "Layout", None)
-                route = solara.Route(
-                    name, component=get_page(submod, required=False), module=submod, layout=module_layout, children=children, label=title, file=subfile
-                )
+                route = _generate_route(name, submod)
             routes.append(route)
         if route_order:
             lookup = {k.path: k for k in routes}
@@ -437,32 +442,12 @@ def generate_routes(module: ModuleType) -> List[solara.Route]:
                 warnings.warn(f"Some routes are not in route_order: {set(lookup) - set(route_order)}")
 
     else:
-        layout = getattr(module, "Layout", None)
-        children = []
-        if hasattr(module, "routes"):
-            children = getattr(module, "routes", [])
-            root = get_root(children)
-            if layout is not None and root is not None and root.layout is None:
-                warnings.warn(f'You defined routes in {file}, in this case, layout should be set on the root route (with path="/"), not on the module level')
-                layout = None
-        children = fix_routes(children, file, layout)
-        return [
-            solara.Route(
-                path="/",
-                component=get_page(module, required=False),
-                data=None,
-                module=module,
-                label=get_title(module),
-                layout=layout,
-                children=children,
-                file=file,
-            )
-        ]
+        return [_generate_route("/", module)]
 
     return routes
 
 
-def generate_routes_directory(path: Path) -> List[solara.Route]:
+def generate_routes_directory(path: Path, markdown_component=None) -> List[solara.Route]:
     """Generate routes for a directory.
 
     This is a recursive function that will generate routes for all
@@ -495,13 +480,13 @@ def generate_routes_directory(path: Path) -> List[solara.Route]:
             continue
         if subpath.stem.startswith("_") or subpath.stem.startswith("."):
             continue
-        route = _generate_route_path(subpath, layout=layout, first=first, has_index=has_index)
+        route = _generate_route_path(subpath, layout=layout, first=first, has_index=has_index, markdown_component=markdown_component)
         first = False
         routes.append(route)
     return routes
 
 
-def _generate_route_path(subpath: Path, layout=None, first=False, has_index=False, initial_namespace={}) -> solara.Route:
+def _generate_route_path(subpath: Path, layout=None, first=False, has_index=False, initial_namespace={}, markdown_component=None) -> solara.Route:
     from .server import reload
 
     name = subpath.stem
@@ -521,32 +506,38 @@ def _generate_route_path(subpath: Path, layout=None, first=False, has_index=Fals
     module_layout = layout if first else None
     if subpath.suffix == ".md":
         data = subpath
+        component = markdown_component
         reload.reloader.watcher.add_file(subpath)
     elif subpath.is_dir():
-        children = generate_routes_directory(subpath)
+        children = generate_routes_directory(subpath, markdown_component=markdown_component)
     else:
         reload.reloader.watcher.add_file(subpath)
         module = source_to_module(subpath, initial_namespace=initial_namespace)
-        title = get_title(module)
-        layout = getattr(module, "Layout", module_layout)
-        root = get_root(children)
-        if hasattr(module, "routes"):
-            children = getattr(module, "routes", [])
-            root = get_root(children)
-            if layout is not None and root is not None and root.layout is None:
-                warnings.warn(f'You defined routes in {subpath}, in this case, layout should be set on the root route (with path="/"), not on the module level')
-                layout = None
-        children = fix_routes(children, subpath, layout)
-        component = get_page(module, required=False)
-        if root and component and root.component and component is not root.component:
-            warnings.warn(
-                f"In {subpath}, you defined a Page component, but also a component on the root route (with path='/') "
-                "which is not equal to the Page component at the module level. This is not recommended."
-            )
+        return _generate_route(route_path, module, default_layout=module_layout)
     route = solara.Route(route_path, component=component, module=module, label=title, children=children, data=data, layout=layout, file=subpath)
     return route
 
 
+def _generate_route(route_path: str, module: ModuleType, default_layout=None, data=None) -> solara.Route:
+    path = Path(module.__file__) if module.__file__ is not None else None
+    title = get_title(module)
+    layout = getattr(module, "Layout", default_layout)
+    if inspect.isclass(layout) and issubclass(layout, ipywidgets.Layout):
+        layout = None
+    component = None
+    children = getattr(module, "routes", [])
+    root_route = get_root(children)
+    # if we have no children or the children have no explicit root component (at '/')
+    if not children or (root_route and root_route.component is None):
+        component = get_page(module, required=False)
+    if root_route and component and root_route.component and component is not root_route.component:
+        warnings.warn(
+            f"In {path}, you defined a Page component, but also a component on the root route (with path='/') "
+            "which is not equal to the Page component at the module level. This is not recommended."
+        )
+    return solara.Route(route_path, component=component, module=module, label=title, children=children, data=data, layout=layout, file=path)
+
+
 def get_root(routes: List[solara.Route]) -> Optional[solara.Route]:
     for route in routes:
         if route.path == "/":

solara/components/component_vue.py

@@ -20,8 +20,8 @@ def _widget_from_signature(classname, base_class: Type[widgets.Widget], func: Ca
         if name.startswith("event_"):
             event_name = name[6:]
 
-            def event_handler(self, data, buffers=None, event_name=event_name):
-                callback = self._event_callbacks.get(event_name)
+            def event_handler(self, data, buffers=None, event_name=event_name, param=param):
+                callback = self._event_callbacks.get(event_name, param.default)
                 if callback:
                     if buffers:
                         callback(data, buffers)
@@ -29,14 +29,15 @@ def _widget_from_signature(classname, base_class: Type[widgets.Widget], func: Ca
                         callback(data)
 
             classprops[f"vue_{event_name}"] = event_handler
-        if name.startswith("on_") and name[3:] in parameters:
+        elif name.startswith("on_") and name[3:] in parameters:
             # callback, will be handled by reacton
             continue
-        if param.default == inspect.Parameter.empty:
-            trait = traitlets.Any()
         else:
-            trait = traitlets.Any(default_value=param.default)
-        classprops[name] = trait.tag(sync=True, **widgets.widget_serialization)
+            if param.default == inspect.Parameter.empty:
+                trait = traitlets.Any()
+            else:
+                trait = traitlets.Any(default_value=param.default)
+            classprops[name] = trait.tag(sync=True, **widgets.widget_serialization)
     # maps event_foo to a callable
     classprops["_event_callbacks"] = traitlets.Dict(default_value={})
 

solara/components/image.py

@@ -163,7 +163,7 @@ def Image(
             layout=layout,
         )
     elif solara.util.isinstanceof(image, "numpy:ndarray"):
-        value = solara.util.numpy_to_image(image, format="png")
+        value = solara.util.numpy_to_image(image, format="png")  # type: ignore
         return rw.Image(
             value=value,
             format="png",

solara/scope/__init__.py

@@ -50,7 +50,7 @@ def get_kernel_id(ipython_fallback=True) -> str:
     See [Understanding solara server](/docs/understanding/solara-server) for understanding the concept of virtual kernels
     and their lifetime.
 
-    This unique ID can be useful to to implement storing state, scoped to a kernel. See [the scope example](/examples/general/scopes) for an example.
+    This unique ID can be useful to to implement storing state, scoped to a kernel. See [the scope example](/examples/general/custom_storage) for an example.
 
     If `ipython_fallback` is `True` (default), this function will also work in IPython notebooks, where it will return the IPython kernel id.
 
@@ -79,7 +79,8 @@ def get_session_id() -> str:
 
     See [Understanding solara server](/docs/understanding/solara-server#session) for more information about the Solara sessions.
 
-    This unique ID can be useful to to implement storing state, scoped to a browser session. See [the scope example](/examples/general/scopes) for an example.
+    This unique ID can be useful to to implement storing state, scoped to a browser session. See [the scope example](/examples/general/custom_storage)
+    for an example.
     """
     import solara.server.kernel_context
 

solara/server/kernel_context.py

@@ -150,6 +150,9 @@ class VirtualKernelContext:
         current_context[key] = local.kernel_context_stack.pop()
 
     def close(self):
+        if self.closed_event.is_set():
+            logger.error("Tried to close a kernel context that is already closed: %s", self.id)
+            return
         logger.info("Shut down virtual kernel: %s", self.id)
         with self:
             for f in reversed(self._on_close_callbacks):

solara/server/static/solara_bootstrap.py

@@ -119,7 +119,7 @@ async def main():
     ]
     for dep in requirements:
         await micropip.install(dep, keep_going=True)
-    await micropip.install("/wheels/solara-1.30.0-py2.py3-none-any.whl", keep_going=True)
+    await micropip.install("/wheels/solara-1.30.1-py2.py3-none-any.whl", keep_going=True)
     import solara
 
     el = solara.Warning("lala")

solara/website/components/markdown.py

@@ -0,0 +1,30 @@
+from typing import Dict, List, Union
+
+import yaml
+
+import solara
+
+
+# We want to separate metadata from the markdown files before rendering them, which solara.Markdown doesn't support
+@solara.component
+def MarkdownWithMetadata(content: str, unsafe_solara_execute=True):
+    if "---" in content:
+        pre_content, raw_metadata, post_content = content.split("---")
+        metadata: Dict[str, Union[str, List[str]]] = yaml.safe_load(raw_metadata)
+
+        if len(pre_content) == 0:
+            content = post_content
+        else:
+            content = pre_content + post_content
+
+        if "title" not in metadata.keys():
+            metadata["title"] = content.split("#")[1].split("\n")[0]
+
+        for key, value in metadata.items():
+            if key == "title":
+                solara.Title(value)
+            elif ":" in key:
+                solara.Meta(property=key, content=value)
+            else:
+                solara.Meta(name=key, content=value)
+    solara.Markdown(content, unsafe_solara_execute=unsafe_solara_execute)

solara/website/pages/__init__.py

@@ -1,6 +1,7 @@
 import contextlib
 
 import solara
+from solara import autorouting
 from solara.alias import rv
 from solara.components.title import Title
 from solara.server import server
@@ -13,7 +14,7 @@ title = "Home"
 route_order = ["/", "showcase", "documentation", "apps", "contact", "changelog"]
 
 
-server._redirects = {
+_redirects = {
     "/docs": "/documentation/getting_started/introduction",
     "/docs/installing": "/documentation/getting_started/installing",
     "/docs/quickstart": "/documentation/getting_started",
@@ -111,12 +112,18 @@ server._redirects = {
     "/api/use_thread": "/documentation/api/hooks/use_thread",
     "/api/use_trait_observe": "/documentation/api/hooks/use_trait_observe",
     "/examples/fullscreen": "/documentation/examples/fullscreen",
-    "/examples/fullscreen/authorization": "/documentation/examples/fullscreen/authorization",
-    "/examples/fullscreen/layout_demo": "/documentation/examples/fullscreen/layout_demo",
-    "/examples/fullscreen/multipage": "/documentation/examples/fullscreen/multipage",
-    "/examples/fullscreen/scatter": "/documentation/examples/fullscreen/scatter",
-    "/examples/fullscreen/scrolling": "/documentation/examples/fullscreen/scrolling",
-    "/examples/fullscreen/tutorial_streamlit": "/documentation/examples/fullscreen/tutorial_streamlit",
+    "/examples/fullscreen/authorization": "/apps/authorization",
+    "documentation/examples/fullscreen/authorization": "/apps/authorization",
+    "/examples/fullscreen/layout-demo": "/apps/layout-demo",
+    "/documentation/examples/fullscreen/layout-demo": "/apps/layout-demo",
+    "/examples/fullscreen/multipage": "/apps/multipage",
+    "/documentation/examples/fullscreen/multipage": "/apps/multipage",
+    "/examples/fullscreen/scatter": "apps/scatter",
+    "/documentation/examples/fullscreen/scatter": "/apps/scatter",
+    "/examples/fullscreen/scrolling": "/apps/scrolling",
+    "/documentation/examples/fullscreen/scrolling": "/apps/scrolling",
+    "/examples/fullscreen/tutorial-streamlit": "/apps/tutorial-streamlit",
+    "/documentation/examples/fullscreen/tutorial-streamlit": "/apps/tutorial-streamlit",
     "/api/route": "/documentation/api/routing/route",
     "/api/route/kiwi": "/documentation/api/routing/route/kiwi",
     "/api/route/banana": "/documentation/api/routing/route/banana",
@@ -207,6 +214,10 @@ server._redirects = {
 }
 
 
+server._redirects = _redirects
+autorouting._redirects = _redirects
+
+
 @solara.component
 def Page():
     solara.Markdown("should not see me")

solara/website/pages/changelog/changelog.md

@@ -1,5 +1,20 @@
 # Solara Changelog
 
+## Version 1.30.0
+
+### Details
+
+   * Feature: Multiple file support for `FileDrop`. [#562](https://github.com/widgetti/solara/pull/562)
+   * Feature: Solara server is now compatible with Pyodide (threads are combined if they cannot be used). [#569](https://github.com/widgetti/solara/pull/569)
+   * Bug Fix: Nested Vuetify apps were not displayed correctly. [#570](https://github.com/widgetti/solara/pull/570)
+   * Bug Fix: `on_kernel_start` callbacks were accumulating on hot reload. [#556](https://github.com/widgetti/solara/pull/556)
+   * Bug Fix: ES Modules were being loaded multiple times on hot reload. [#559](https://github.com/widgetti/solara/pull/559)
+   * Bug Fix: Theme CSS was not loaded when `rootPath` was non-trivial. [829946c](https://github.com/widgetti/solara/commit/829946c4bf47a2ea78d783bb500faaab93b2549b)
+   * Fix: `Route.component` is now rendered, instead of the internal `RenderPage` component. [#555](https://github.com/widgetti/solara/pull/555)
+   * Fix: `Route.layout` now allows for layouts to be used when defining routes manually. [#554](https://github.com/widgetti/solara/pull/554)
+   * Fix: Allow custom command like arguments that can be parsed by the application. [#558](https://github.com/widgetti/solara/pull/558)
+
+
 ## Version 1.29.1
 
 ### Details

solara/website/pages/documentation/advanced/__init__.py

@@ -1,36 +1,9 @@
 from pathlib import Path
 
-import solara
 from solara.autorouting import generate_routes_directory
+from solara.website.components.markdown import MarkdownWithMetadata
 
-title = "Advanced"
 HERE = Path(__file__)
 # if we didn't put the content in the subdirectory, but pointed to the current file
 # we would include the current file recursively, causing an infinite loop
-routes = generate_routes_directory(HERE.parent / "content")
-
-
-@solara.component
-def Page(route_external=None):
-    solara.Markdown(Path(HERE.parent / "content" / "10-howto" / "00-overview.md").read_text())
-
-    with solara.Row(justify="center", style={"flex-wrap": "wrap", "align-items": "start"}):
-        for child in route_external.children:
-            if child.path == "/":
-                continue
-
-            card_title = solara.Link("/documentation/advanced/" + child.path, children=[child.label])
-
-            with solara.Card(title=card_title, style={"min-width": "300px"}):
-                with solara.v.List():
-                    with solara.v.ListItemGroup():
-                        for grandchild in child.children:
-                            if grandchild.path == "/":
-                                continue
-                            with solara.Link(
-                                "/documentation/advanced/" + child.path + "/" + grandchild.path
-                                if child.path != "/"
-                                else "/documentation/advanced/" + grandchild.path
-                            ):
-                                with solara.v.ListItem():
-                                    solara.v.ListItemTitle(children=[grandchild.label])
+routes = generate_routes_directory(HERE.parent / "content", MarkdownWithMetadata)

solara/website/pages/documentation/advanced/content/10-howto/00-overview.md

@@ -1 +1,6 @@
+---
+title: Overview of how-to articles
+description: The how-tos are meant as deeper dives into specific topics from various perspectives
+---
+
 The how-tos are meant as deeper dives into specific topics. Although we try to write each how-to as a standalone document, some parts of a how-to may build on top of a previous one.

solara/website/pages/documentation/advanced/content/10-howto/10-multipage.md

@@ -1,3 +1,8 @@
+---
+title: Building multi-page apps in Solara
+description: The simplest way to create a multi-page app is to create a directory with multiple scripts.
+---
+
 # Multi-page support
 
 In the [Web App tutorial](/documentation/getting_started/tutorials/web-app), we created an application consisting of a single page. Web applications generally have multiple pages, and Solara supports this as well.

solara/website/pages/documentation/advanced/content/10-howto/20-layout.md

@@ -1,3 +1,8 @@
+---
+title: Making different layouts in Solara
+description: Solara comes with a layout system ideal for data apps. Learn how to use them in this short guide.
+---
+
 # Layout
 
 Solara comes with a layout system ideal for data apps.
@@ -33,7 +38,7 @@ def Page():
                     solara.Info("two per column on small screens, three per column on large screens")
 ```
 
-[Navigate here to watch this layout in a full browser window](/documentation/examples/fullscreen/layout_demo)
+[Navigate here to watch this layout in a full browser window](/documentation/examples/fullscreen/layout-demo)
 
 The key takeaways are:
 

solara/website/pages/documentation/advanced/content/10-howto/30-testing.md

@@ -1,3 +1,8 @@
+---
+title: Testing your Solara application, both front and back end
+description: Using solara you can test both the front and back end functionalities of your application.
+---
+
 # Testing with Solara
 # Testing Application Logic
 

solara/website/pages/documentation/advanced/content/10-howto/31-debugging.md

@@ -1,4 +1,7 @@
-
+---
+title: Debugging Solara applications
+description: You can use the Python debugger to debug your Solara app.
+---
 # Debugging
 
 ## PDB

solara/website/pages/documentation/advanced/content/10-howto/40-embed.md

@@ -1,3 +1,9 @@
+---
+title: Embedding Solara applications into existing websites
+description: Solara can be embedded into existing websites. Although it is technically possible to embed a Solara app into an existing webpage,
+    we currently support embedding primarily via iframes.
+---
+
 # Embedding in existing websites
 
 Solara can be embedded into existing websites. Although it is technically possible to embed a Solara app into an existing webpage, we currently support embedding primarily via iframes.

solara/website/pages/documentation/advanced/content/10-howto/50-ipywidget_libraries.md

@@ -1,3 +1,7 @@
+---
+title: Using various ipywidgets libraries within a Solara application
+description: Solara can work with virtually any ipywidget library, and enables powerful interactivity with libraries like ipyleaflet, ipydatagrid, and bqplot.
+---
 # How can I use ipywidget library X?
 
 Solara can work with any ipywidget library, such as [ipyleaflet](https://github.com/jupyter-widgets/ipyleaflet), [ipydatagrid](https://github.com/bloomberg/ipydatagrid) or [bqplot](https://github.com/bqplot/bqplot).

solara/website/pages/documentation/advanced/content/20-understanding/00-introduction.md

@@ -1,3 +1,9 @@
+---
+title: Understanding Solara's functionality
+description: Solara builds on existing technologies. If you are new to Solara or some of the underlying technologies, you may feel lost at times.
+    These 'understanding' guides are meant to help you understand topics at a deeper level and how they connect to Solara.
+---
+
 # Introduction
 
 Solara builds on existing technologies. If you are new to Solara or some of the underlying technologies, you may feel lost at times.

solara/website/pages/documentation/advanced/content/20-understanding/05-ipywidgets.md

@@ -1,3 +1,8 @@
+---
+title: Understanding how ipywidgets work together with Solara
+description: Solara's primarily standalone app approach differs from the ipywidgets one. This article dives deeper into the different approaches and adapting to using
+    ipywidgets within Solara.
+---
 # IPywidgets
 
  * [Documentation](https://ipywidgets.readthedocs.io/en/stable/)

solara/website/pages/documentation/advanced/content/20-understanding/06-ipyvuetify.md

@@ -1,3 +1,7 @@
+---
+title: Using ipyvuetify widgets with Solara
+description: Ipyvuetify is an ipywidgets based library that wraps the Vuetify javascript framework for use with python widgets. Learn how to use these to build apps with Solara.
+---
 # ipyvuetify
 
  * [Documentation](https://ipyvuetify.readthedocs.io/)

solara/website/pages/documentation/advanced/content/20-understanding/10-reacton.md

@@ -1,3 +1,7 @@
+---
+title: Understanding how Solara builds on Reacton
+description: Solara adapts the React way of using components declaratively to build UIs and brings it to Python.
+---
 # Reacton
 
  * [Documentation](https://reacton.solara.dev/)

solara/website/pages/documentation/advanced/content/20-understanding/12-reacton-basics.md

@@ -1,3 +1,7 @@
+---
+title: Understanding the basics of Reacton
+description: Using your favorite component, we try to understand better how it works to improve your understanding of Reacton and, thus, how to use Solara.
+---
 # Reacton basic understanding
 
 

solara/website/pages/documentation/advanced/content/20-understanding/15-anatomy.md

@@ -1,3 +1,7 @@
+---
+title: The anatomy of Solara's functionality
+description: Dive deep into how Solara uses the technologies it builds on.
+---
 # Anatomy
 
 For communication, it is useful to speak the same language and use the same idiom.

solara/website/pages/documentation/advanced/content/20-understanding/17-rules-of-hooks.md

@@ -1,3 +1,7 @@
+---
+title: The rules of hooks in Solara
+description: Learn the rules that govern the usage of hooks in your Solara application.
+----
 # Rules of hooks
 
 For now, we refer to the [ReactJS documentation](https://reactjs.org/docs/hooks-rules.html).

solara/website/pages/documentation/advanced/content/20-understanding/18-containers.md

@@ -1,3 +1,9 @@
+---
+title: Using Solara with containers to build complex UIs
+description: Solara allows for using python with statements to populate your UIs in a structured manner. This makes it easy to compose different components to build cohesive
+    wholes.
+---
+
 # Laying out components with containers
 
 ## Introduction

solara/website/pages/documentation/advanced/content/20-understanding/20-solara.md

@@ -1,3 +1,8 @@
+---
+title: Understanding different parts of Solara
+description: Solara is made of two main components, the bulk of the Solara package with UI elements that can be used together with Jupyter, and Solara server, which
+    allows for these UI elements to be used in standalone apps and dashboards
+---
 # Solara
 
 Solara combines [ipywidgets](./ipywidgets), [reacton](./reacton) and puts it into a opinionated framework to make web apps with a focus on data (data apps for short).