Validate 2024 PDF layout using production standard

[ronaldtse]

We need to validate our implementation of the 2024 layout against a production standard:

• https://github.com/metanorma/mn-samples-iso-private/blob/main/reference-docs/19152-1_2024.pdf

This is a private copy.

[Intelligent2013]

Our implementation of the 2024 layout looks differently:

• page margins

  • rendered PDF

  • production standard

• header font-size

  • rendered PDF (0.5pt smaller font)

  • production standard

• copyright font-size

  • rendered PDF

  • production standard

• main text font-size

  • rendered PDF

  • production standard

• last page footer

  • rendered PDF

  • production standard

Our PDF layout was updated in https://github.com/metanorma/metanorma-iso/issues/1079 based on the provided PDF example 2024-iso-new-pdf-layout.pdf "Sample of layout for an International Standard (cover page, back page and internal centered layout)".

@ronaldtse to further actions I have to know exactly - what is the correct PDF - in this issue or in https://github.com/metanorma/metanorma-iso/issues/1079?

Note: the PDF from the initial posts opens in the Chrome browser only. Adobe Acrobat opens it and closes immediately, also Foxit Reader and PDF-XChange Viewer. So I have to repair it somehow.

[ronaldtse]

Adobe Acrobat opens it and closes immediately

I'm seeing the same issue too. I can open it in macOS Preview however.

It is very likely that their "design spec" and implemented production PDF are slightly different.

[Intelligent2013]

• blue email vs. www link:

  • rendered PDF:

  • production standard:

The last link points to https://www.iso.org/.

From metanorma-iso gem boilerplate.adoc:

[[boilerplate-address]]
[align=left]
ISO copyright office +
CP 401 • Ch. de Blandonnet 8 +
CH-1214 Vernier, Geneva +
Phone: +41 22 749 01 11 +
Email: copyright@iso.org +
Website: www.iso.org

Presentation XML:

    <p id="boilerplate-address" align="left">ISO copyright office<br/>
CP 401 • Ch. de Blandonnet 8<br/>
CH-1214 Vernier, Geneva<br/>
Phone: +41 22 749 01 11<br/>
Email: <link target="mailto:copyright@iso.org"/>
        <br/>
Website: www.iso.org</p>
                ...
        </copyright-statement>

copyright@iso.org automatically converts to <link target="mailto:copyright@iso.org"/>, but www.iso.org doesn't. I need update boilerplate.adoc

[Intelligent2013]

To check the whole document I'll encode it in adoc.

[Intelligent2013]

• [x] one numbered Note

  • rendered PDF:

  • production PDF:

The rendered PDF is correct. From https://www.iso.org/sites/directives/current/part2/index.xhtml#_idTextAnchor340:

24.3 Numbering and subdivision Within a given clause or subclause, notes shall be numbered sequentially. The numbering restarts at each new subdivision. A single note in a subdivision shall not be numbered.

• [x] ordered list numbering - alphabetic vs. arabic:

  • rendered PDF:

  • production PDF:

From https://www.metanorma.org/author/topics/blocks/lists/#general-2:

• [x] ~different font size of Note:~ no difference, just PDF viewer approximation.

  • ~rendered PDF (a bit smaller):~
  • ~production PDF:~

• [x] wrong baseline when list text contains superscripted text

  • rendered PDF:

• [x] there isn't footnotes separator (51mm horizontal line) in the rendered PDF

• [x] indents between footnotes:

  • rendered PDF:
  • production PDF:

[Intelligent2013]

There is the identical entry in the Normative references and Bibliography:

therefore different identifiers should be used in the adoc:

[bibliography]
== Normative references

* [[[ISO19103,ISO 19103]]], _Geographic information -- Conceptual schema language_
...

[bibliography]
== Bibliography

* [[[ISO19103bib,ISO 19103]]], _Geographic information -- Conceptual schema language_
,..

[Intelligent2013]

• [x] Source color link:

  • rendered PDF:

  • production PDF:

• [x] Example (numbered vs. unnumbered) alignment:

  • rendered PDF:

  • production PDF:

[Intelligent2013]

• [x] dash after modified:
  • rendered PDF en dash (U+2013):
  • production PDF em dash (U+2014):

Presentation XML contains en dash:

</xref>, modified
 – Note 1 to entry removed.]</termsource>

[Intelligent2013]

• [x] different vertical indents between the definition list items, need increase a bit

[Intelligent2013]

• [x] text with indent
  • rendered PDF:
  • production PDF:

Note: I don't know how to achieve it.

• [x] space before table name

  • rendered PDF:

  • production PDF:

• [x] table footer top border

• [x] space between footnotes

  • rendered PDF
  • production PDF

• [x] space after table

  • rendered PDF:

  • production PDF:

[Intelligent2013]

• [x] reference from Annex A sub-clause to another sub-clause

  • rendered PDF:
  • production PDF:

• [x] reference from Annex A sub-clause to main section sub-clause

  • rendered PDF
  • production PDF

[Intelligent2013]

• [x] table cell borders

  • rendered PDF:

  • production PDF:

[ronaldtse]

@Intelligent2013 can you help file issues for @opoudjis for those he needs to fix? Thanks.

[Intelligent2013]

• [x] smallcap font-size

  • rendered PDF

  • production PDF

[Intelligent2013]

• [x] references to the Bibliography items
  • rendered PDF:
  • production PDF

[Intelligent2013]

• [x] comma between bibliography references
  • rendered PDF:
  • production PDF:

Adoc markup:

<<ref10>>,<<ref15>>

[Intelligent2013]

• [x] text with indent
  • rendered PDF:
  • production PDF:

This issue can be solved via css: [css text-indent:7mm]#*1) CoreClassConformant*#. Rendered PDF:

[Intelligent2013]

• [x] reference to the standard
  • rendered PDF
  • production PDF

[Intelligent2013]

ISO XSLT updated for PDF layout 2024. Only one issue remains: https://github.com/metanorma/metanorma-iso/issues/1141 On hold.

[Intelligent2013]

Done.