From 9c672e69f011df0b82049431a60df478c5a01497 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Rodrigo=20Gir=C3=A3o=20Serr=C3=A3o?=
 <5621605+rodrigogiraoserrao@users.noreply.github.com>
Date: Wed, 22 Mar 2023 21:05:10 +0000
Subject: [PATCH] Fix missing border example.

Related issues: #2108
Related PRs: #2064
---
 .../border_sub_title_align_all_example.md     | 38 +++++++++++++++++++
 1 file changed, 38 insertions(+)

diff --git a/docs/snippets/border_sub_title_align_all_example.md b/docs/snippets/border_sub_title_align_all_example.md
index e69de29bb..b46502f2f 100644
--- a/docs/snippets/border_sub_title_align_all_example.md
+++ b/docs/snippets/border_sub_title_align_all_example.md
@@ -0,0 +1,38 @@
+This example shows all border title and subtitle alignments, together with some examples of how (sub)titles can have custom markup.
+ Open the code tabs to see the details of the code examples.
+
+ === "Output"
+
+     ```{.textual path="docs/examples/styles/border_sub_title_align_all.py"}
+     ```
+
+ === "border_sub_title_align_all.py"
+
+     ```py hl_lines="6 18 24 30 39 40 42 45 51 57 63"
+     --8<-- "docs/examples/styles/border_sub_title_align_all.py"
+     ```
+
+     1. Border (sub)titles can contain nested markup.
+     2. Long (sub)titles get truncated and occupy as much space as possible.
+     3. (Sub)titles can be stylised with Rich markup.
+     4. An empty (sub)title isn't displayed.
+     5. The markup can even contain Rich links.
+     6. If the widget does not have a border, the title and subtitle are not shown.
+     7. When the side borders are not set, the (sub)title will align with the edge of the widget.
+     8. The title and subtitle are aligned on the left and very long, so they get truncated and we can still see the rightmost character of the border edge.
+     9. The title and subtitle are centered and very long, so they get truncated and are centered with one character of padding on each side.
+     10. The title and subtitle are aligned on the right and very long, so they get truncated and we can still see the leftmost character of the border edge.
+     11. An auxiliary function to create labels with border title and subtitle.
+
+ === "border_sub_title_align_all.css"
+
+     ```sass hl_lines="12 16 30 34 41 46"
+     --8<-- "docs/examples/styles/border_sub_title_align_all.css"
+     ```
+
+     1. The default alignment for the title is `left` and the default alignment for the subtitle is `right`.
+     2. Specifying an alignment when the (sub)title is too long has no effect. (Although, it will have an effect if the (sub)title is shortened or if the widget is widened.)
+     3. Setting the alignment does not affect empty (sub)titles.
+     4. If the border is not set, or set to `none`/`hidden`, the (sub)title is not shown.
+     5. If the (sub)title alignment is on a side which does not have a border edge, the (sub)title will be flush to that side.
+     6. Naturally, (sub)title positioning is affected by padding.