diff options
| author | Dan Allen <dan.j.allen@gmail.com> | 2022-07-14 11:41:47 -0600 |
|---|---|---|
| committer | Dan Allen <dan.j.allen@gmail.com> | 2022-07-14 11:41:47 -0600 |
| commit | 02f7b972c93f2f88bf5585eefe9f4ba1ae2f2288 (patch) | |
| tree | e737c01eb7006460a6fe373d61d6ae36f0e17d1e /docs/modules/extend | |
| parent | c9e00fb53a04f4df87f0336e64efd40c8a7463fb (diff) | |
clarify that the ink_title_page method cannot start a new page
Diffstat (limited to 'docs/modules/extend')
| -rw-r--r-- | docs/modules/extend/pages/use-cases.adoc | 3 |
1 files changed, 2 insertions, 1 deletions
diff --git a/docs/modules/extend/pages/use-cases.adoc b/docs/modules/extend/pages/use-cases.adoc index 8d4f53ca..21bbb76a 100644 --- a/docs/modules/extend/pages/use-cases.adoc +++ b/docs/modules/extend/pages/use-cases.adoc @@ -32,7 +32,8 @@ Every title page is as unique as the work itself. That's why Asciidoctor PDF gives you the ability to customize the title page by overriding the `ink_title_page` method in an extended converter. The `ink_title_page` method is called after the title page has been created and the background applied, so it can focus on writing content. In this method, you can choose to honor the `title-page` settings from the theme, or go your own way. -The one rule is that this method must not start a new page. +The one rule is that the `ink_title_page` method *must not* start a new page. +If it tries to start a new page, that request will be ignored and a warning will be generated. Let's create a custom title page that shows the document title and subtitle between two lines in the top half and a logo in the bottom half. |