Add docs for Pretty, fix some reference issues in docs (#2678)

docs/examples/widgets/pretty.py

@@ -0,0 +1,24 @@
+from textual.app import App, ComposeResult
+from textual.widgets import Pretty
+
+DATA = {
+    "title": "Back to the Future",
+    "releaseYear": 1985,
+    "director": "Robert Zemeckis",
+    "genre": "Adventure, Comedy, Sci-Fi",
+    "cast": [
+        {"actor": "Michael J. Fox", "character": "Marty McFly"},
+        {"actor": "Christopher Lloyd", "character": "Dr. Emmett Brown"},
+    ],
+}
+
+
+class PrettyExample(App):
+    def compose(self) -> ComposeResult:
+        yield Pretty(DATA)
+
+
+app = PrettyExample()
+
+if __name__ == "__main__":
+    app.run()

docs/widget_gallery.md

@@ -158,6 +158,16 @@ Display placeholder content while you are designing a UI.
 ```{.textual path="docs/examples/widgets/placeholder.py"}
 ```
 
+## Pretty
+
+Display a pretty-formatted Rich renderable.
+
+[Pretty reference](./widgets/pretty.md){ .md-button .md-button--primary }
+
+
+```{.textual path="docs/examples/widgets/pretty.py"}
+```
+
 ## ProgressBar
 
 A configurable progress bar with ETA and percentage complete.

docs/widgets/pretty.md

@@ -0,0 +1,44 @@
+# Pretty
+
+Display a pretty-formatted object.
+
+- [ ] Focusable
+- [ ] Container
+
+## Example
+
+The example below shows a pretty-formatted `dict`, but `Pretty` can display any Python object.
+
+=== "Output"
+
+    ```{.textual path="docs/examples/widgets/pretty.py"}
+    ```
+
+=== "pretty.py"
+
+    ```python
+    --8<-- "docs/examples/widgets/pretty.py"
+    ```
+
+## Reactive Attributes
+
+This widget has no reactive attributes.
+
+## Messages
+
+This widget posts no messages.
+
+## Bindings
+
+This widget has no bindings.
+
+## Component Classes
+
+This widget has no component classes.
+
+---
+
+
+::: textual.widgets.Pretty
+    options:
+        heading_level: 2

docs/widgets/static.md

@@ -32,6 +32,7 @@ This widget sends no messages.
 ## See Also
 
 * [Label](./label.md)
+* [Pretty](./pretty.md)
 
 
 ---