From 797dcc9c19d2efa5e8b76fed1f6eb8eaca8b2147 Mon Sep 17 00:00:00 2001 From: Dan Allen Date: Fri, 18 Nov 2016 13:04:08 -0700 Subject: revise documentation about nonfacing option --- docs/theming-guide.adoc | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) (limited to 'docs') diff --git a/docs/theming-guide.adoc b/docs/theming-guide.adoc index 867ed4fd..456fd0fe 100644 --- a/docs/theming-guide.adoc +++ b/docs/theming-guide.adoc @@ -3149,12 +3149,20 @@ If a document uses the book doctype, a blank page will be inserted, if necessary * First page of body content * Parts and chapters -It is possible to mark parts and chapters with a nonfacing option. -In this case no automatic facing pages will be created. -For this add [%nonfacing] before a title. - Other facing pages may be added in the future. +It's possible to disable the automatic facing feature for a given part or chapter. +This can be done by adding the nonfacing option to the section node. +When the nonfacing option is present, the part or chapter title will be placed on the following page. + +[source,asciidoc] +---- +[%nonfacing] += Minor Chapter + +content +---- + For documents that use the article doctype, Asciidoctor PDF incorrectly places the document title and table of contents on their own pages. This can result in the page numbering and the page facing to be out of sync. As a workaround, Asciidoctor PDF inserts a blank page, if necessary, to ensure the first page of body content is a recto-facing page. -- cgit v1.2.3