"Title Page" Content Discussion

[jaredmorgs]

http://asciidoctor.org/docs/user-manual/#title-page is currently available to create content for.

Use this issue as a tracker for content suggestions, or feel free to provide PRs referencing this ticket to keep track of contributions.

This content is contained in https://github.com/asciidoctor/asciidoctor.org/blob/master/docs/user-manual.adoc

[jaredmorgs]

I think mentioning attributes like :showtitle: and how to structure author info here would be a good win. I know this is mentioned in the Kismet Chameleon sections a bit, but it bears repeating here (hopefully using include:: directives).

[rockyallen]

Copied from discussion. Think these are for asciidoc-pdf only. Is this the right place to document them?
":title-logo-image: image:images/titleimage.png[pdfwidth=3.5in,align=center]
title-logo-image must be a header attribute

Example with all elements:

= Title: Subtitle
Author Name
v1.0.0, 2016-02-22
:title-logo-image: image:logo.png[Logo,100,100]
:title-page-background-image: image:bg.jpg[]

Aside from that, content is not supported on the title page (unless you are willing to customize the converter code).
If you need a more general layout for a cover page, I recommend using a front cover, which is defined using the front-cover-image attribute.
:front-cover-image: image:front-cover.pdf[]
-Dan"

[mojavelinux]

The term "title page" means very different things for different output formats. For the HTML output, it's more of a title area (document title, author, revision, etc). For PDF, it's a dedicated page whose layout can be controlled by the theme. PDF can also have a cover page. EPUB3 doesn't have a dedicated title page (only a cover page), but looks for the front-matter.html file to populate an inner title page. And those defaults could evolve. Suffice to say, there's no one definition.

Perhaps this section would fit better under "Processing Your Content", with a discussion of the title page in each format to which it is relevant. In a general sense, we can say that the document header is used to populate the content of the title page or area. The common attributes are the document title, authors and built-in attributes prefixed with title- or containing -cover-.