Allow specification of cover image

[ronaldtse]

IHO now allows for cover images in newer documents.

B-12

B-13

M-2

S-44

S-65

[opoudjis]

The code for specifying coverpage images has already been moved to standoc: this keeps coming up as a requirement for different flavours.

https://www.metanorma.org/author/ref/document-attributes/

:coverpage-image:
Comma-delimited list of image locations, for images to be included on the (PDF) cover page. All image locations are relative to the source document. Currently only supported for BSI, ITU, JIS, Plateau.

That means that if you specify a coverpage image in the same way in IHO, it will be ingested into the Semantic XML already. It's just that nothing will do anything to render it under IHO.

Adding IHO to the list of flavours that use coverpage images in their PDFs is a PDF task, and there is nothing further for me to do here (unless we decide HTML or DOC is to support coverpage images as well—and we shouldn't.)

So this task is for @Intelligent2013

[Intelligent2013]

Currently, the cover page renders via IHO XSLT so:

There are two kinds of the cover page in the first post:

• similar to the cover page generates by XSLT + inner image in the rectangle
• 'free design' cover page

There are two options

1. the document author prepares the image cover.pdf and specify the document attribute :coverpage-image: cover.pdf, and XSLT fits the image into the rectangle (yellow box on the screenshot):

If author wants to use the 'free design' cover page, then adds the additional attribute presentation-metanorma-coverpage-image-fullpage (the attribute name just for example, may be changed):

:presentation-metanorma-coverpage-image-fullpage: true

In this case, XSLT just puts the cover.pdf image 'as is' in the PDF and doesn't add any another data on the cover page.

2. the document author prepares the image cover.pdf and specify the document attribute :coverpage-image: cover.pdf.
   In this case, XSLT just puts the cover.pdf image 'as is' in the PDF and doesn't add any another data on the cover page.
   I.e. author is full responsible for cover page layout.

Note: in both cases, if author doesn't specify the document attribute :coverpage-image:, then cover page will be render by XSLT (as currently).

I like the option 1. I assume that the free design cover pages were used for old documents (2017, 2018 year), and only new layout is using currently. But it just only my assumption...

@ronaldtse which option do you prefer?

[Intelligent2013]

And also need to add the edition number:

Currently, only document identifier is showing:

[Intelligent2013]

And also need to add the edition number:

Currently, only document identifier is showing:

In the original PDF (https://github.com/metanorma/S-102-Product-Specification/blob/main/reference-docs/S-102_EN_Bathymetric%20Surface%20Product%20Specification_Ed2.0.0.pdf) the edition number shows under the title:

therefore the edition number after the document identifier should be render only when there is the :coverpage-image: attribute.