How to add image to asciidoc book cover page?

Question

I would like to create a pdf book using asciidoc. The title page should include the title, subtitles and image. So far, I have not been able to find documentation on how to achieve this.

Intuivly I would do something like

My book title ============= :author: myself :toc: image:images/titelimage.png[width=400] 

but it just adds image:images/titelimage.png[width=400] as subtitles. I would like to have something like

 My book title <titleimage> subtitle 

Is there a way to do this in ascciidoc? If not, what do I need to do to get this?

Answer 1

If you are using asciidoctor-pdf , you can define an attribute for the logo. It will place the image above the title of the document.

 :title-logo-image: images/titelimage.png 

See pdf example here and raw adoc .

Answer 2

If you need a PDF file with docbook 4.x output, you should:

Create a docinfo file with an image for the first page. This is an XML file similar to the following example. This is discussed at http://www.methods.co.nz/asciidoc/userguide.html#X87

Example:

 <mediaobject> <imageobject> <imagedata align="center" depth="400" fileref="../images/tiger.png" /> </imageobject> </mediaobject> <subtitle>Subtitle of this book</subtitle> 

Then set up your DocBook style sheets to include the media element for the cover page (by default, style sheets do not include this). http://www.sagehill.net/docbookxsl/TitlePagePrint.html

DocBook 5 includes a cover element in its style sheets.

Answer 3

you just need to add an empty line between the toc statement and images :. The way asciidoc sort separates blocks.

Answer 4

It:

 = The Book Title :author: First Last :email: [e-mail] :toc: :toc-placement: preamble :doctype: book image:./images/title_page.jpg[] 

It produces:

 My book title [e-mail] - [e-mail] Image Table of Contents ...