Documentation fixes for RC1 (#7228)

doc/how_to/custom_components/esm/custom_layout.md

@@ -244,6 +244,7 @@ split_anywidget = SplitAnyWidget(
 )
 split_anywidget.servable()
 ```
+:::
 
 ::::
 
@@ -264,8 +265,6 @@ split_react.right=pn.pane.Markdown("Hi. I'm a `Markdown` pane replacing the `Cod
 ```
 :::
 
-:::
-
 :::{tab-item} `AnyWidgetComponent`
 ```{pyodide}
 split_anywidget.right=pn.pane.Markdown("Hi. I'm a `Markdown` pane replacing the `CodeEditor` widget!", sizing_mode="stretch_both")

doc/how_to/custom_components/reactive_html/reactive_html_layout.md

@@ -182,10 +182,8 @@ The component will trigger a rerendering if you update the `List` value.
 
 You must
 
-- wrap the `{% for object in objects %}` loop in an HTML element with an `id`. Here it is wrapped
-with `<div id="container">...</div>`.
-- close all HTML tags! `<hr>` is valid HTML, but not valid with `ReactiveHTML`. You must close it
-as `<hr/>`.
+- wrap the `{% for object in objects %}` loop in an HTML element with an `id`. Here it is wrapped with `<div id="container">...</div>`.
+- close all HTML tags! `<hr>` is valid HTML, but not valid with `ReactiveHTML`. You must close it as `<hr/>`.
 
 You can optionally
 
@@ -232,11 +230,9 @@ You can now use `[...]` indexing and the `.append`, `.insert`, `pop`, ... method
 expect.
 
 :::{note}
-
 You must list `ListLike, ReactiveHTML` in exactly that order when you define the class! The other
 way around `ReactiveHTML, NamedListLike` will not work.
-
-::::
+:::
 
 ## Layout a dictionary
 
@@ -271,10 +267,6 @@ LayoutOfDict(object={
 ```
 
 :::{note}
-
-Please note
-
 - We can insert the `key` as a literal value only using `{{ key }}`. Inserting it as a template variable `${key}` will not work.
 - We must not give the HTML element containing `{{ key }}` an `id`. If we do, an exception will be raised.
-
 :::

doc/how_to/editor/markdown.md

@@ -82,6 +82,7 @@ def hello_world(text):
 pn.Row(widget, pn.bind(hello_world, widget)).servable()
 ```
 ````
+:::
 
 Then, from the command line, launch a server with:
 

doc/how_to/extending_panel.md

@@ -3,7 +3,7 @@
         <meta http-equiv='refresh' content='0; URL=./index.html#extending-panel>
     </head>
 
-# Test and debug
+# Extending Panel
 
 ```{toctree}
 :titlesonly:

doc/how_to/integrations/FastAPI.md

@@ -24,6 +24,8 @@ conda install fastapi
 ```
 :::
 
+::::
+
 ## Create a FastAPI application
 
 Start by creating a FastAPI application. In this application, we will define a root endpoint that returns a simple JSON response. Open your text editor or IDE and create a file named main.py:

doc/how_to/templates/template_theme.md

@@ -62,7 +62,7 @@ template.main.append(
 )
 template.servable();
 ```
-::::
+:::
 
 Now, we can activate this app on the command line:
 

doc/pyodide_dependencies.json

@@ -1,6 +1,6 @@
 {
   "gallery/altair_brushing.ipynb": ["altair"],
-  "gallery/gapminders.ipynb": ["altair", "plotly", "hvplot"],
+  "gallery/gapminders.ipynb": ["altair", "plotly", "hvplot", "matplotlib"],
   "gallery/glaciers.ipynb": ["holoviews", "colorcet", "hvplot"],
   "gallery/hvplot_explorer.ipynb": ["hvplot", "scipy"],
   "gallery/iris_kmeans.ipynb": ["hvplot", "scikit-learn"],

panel/io/convert.py

@@ -548,7 +548,7 @@ def convert_apps(
     compiled: bool
         Whether to use the compiled and faster version of Pyodide.
     """
-    if isinstance(apps, str):
+    if isinstance(apps, (str, os.PathLike)):
         apps = [apps]
     if dest_path is None:
         dest_path = pathlib.Path('./')
@@ -563,7 +563,7 @@ def convert_apps(
         for app in apps:
             matches = [
                 deps for name, deps in requirements.items()
-                if app.endswith(name.replace(os.path.sep, '/'))
+                if str(app).endswith(name.replace(os.path.sep, '/'))
             ]
             app_requirements[app] = matches[0] if matches else 'auto'
     else:

panel/tests/test_docs.py

@@ -139,3 +139,28 @@ def test_markdown_codeblocks(file, tmp_path):
         f.writelines(lines)
 
     runpy.run_path(str(mod))
+
+
+@doc_available
+@pytest.mark.parametrize(
+    "file", doc_files, ids=[str(f.relative_to(DOC_PATH)) for f in doc_files]
+)
+def test_colon_blocks_symmetric(file):
+    stack = []
+    for i, line in enumerate(file.read_text(encoding='utf-8').splitlines(), 1):
+        if ':::::' in line:
+            # Not checking triple nesting
+            stack.clear()
+            break
+        elif '::::' in line:
+            if stack:
+                assert stack[-1] == '::::', f'Expected ::: on line {i}, found ::::'
+                stack.pop()
+            else:
+                stack.append('::::')
+        elif ':::' in line:
+            if not stack or stack[-1] == '::::':
+                stack.append(':::')
+            else:
+                stack.pop()
+    assert not stack, 'Colon blocks were not symmetric, ensure all blocks were closed'