diff options
| author | Dan Allen <dan.j.allen@gmail.com> | 2022-08-05 02:33:05 -0600 |
|---|---|---|
| committer | Dan Allen <dan.j.allen@gmail.com> | 2022-08-05 02:34:06 -0600 |
| commit | e7b2b805bae9efeea15081c531f2fadc7e309218 (patch) | |
| tree | 648570ecc8076f3a0b59a686f92513fab37b8b2a | |
| parent | 327bdaf7a0579d530d123ce6a122559147a76364 (diff) | |
mention that heading-min-height-after key can be used to enable orphan prevention on headings
| -rw-r--r-- | docs/modules/extend/pages/use-cases.adoc | 4 |
1 files changed, 2 insertions, 2 deletions
diff --git a/docs/modules/extend/pages/use-cases.adoc b/docs/modules/extend/pages/use-cases.adoc index 8767cc8a..ffcf19e2 100644 --- a/docs/modules/extend/pages/use-cases.adoc +++ b/docs/modules/extend/pages/use-cases.adoc @@ -188,8 +188,8 @@ This line has been changed. == Avoid break after heading -This functionality is already provided by the converter if you set the `breakable` option on section title or discrete heading. -The code is presented here both to explain how it works and to use to make this behavior automatic. +This functionality is already provided by the converter if you set the `breakable` option on section title or discrete heading or you set the `heading-min-height-after` theme key to `auto`. +The code is presented here both to explain how it works and show how to do it programmatically (perhaps to tune it for specific headings). If an in-flow heading is followed by content that doesn't fit on the current page, and the `breakable` option is not set on the heading, the converter will orphan the heading on the current page. You can fix this behavior by overriding the `arrange_heading` method in an extended converter. |