Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

S-102 - Blank pages - Rules #293

Open
RohdeBSH opened this issue Jan 18, 2025 · 4 comments
Open

S-102 - Blank pages - Rules #293

RohdeBSH opened this issue Jan 18, 2025 · 4 comments
Assignees
Labels
enhancement New feature or request

Comments

@RohdeBSH
Copy link

In the IHO documents, there are intentionally left blank pages so that, for example, certain chapters in a printed book always start on an even page (on the right).
These pages follow fixed rules. For example, the first chapter of the standard document must always start on an even page. In the S-102 2.2.0 PDF document, a page was automatically added by Metanorma. The automatic handling during the creation of the output format is also absolutely correct.
Unfortunately, it seems that not all IHO rules have been implemented yet. The IHO has contacted the S-102PT and asked it to correct the layout. However, correcting the layout in the ASCII doc is not the most effective approach. Even the smallest changes to the text can force a correction of the layout. Furthermore, the blank pages are not relevant for all output formats. HTML, for example, does not require the layout with the blank pages.
The objective is to request the rules from the IHO and implement them accordingly in Metanorma. This is also necessary for all future IHO standards that are written with Metanorma.

Image

@ronaldtse ronaldtse added the enhancement New feature or request label Jan 29, 2025
@github-project-automation github-project-automation bot moved this to 🆕 New in Metanorma Jan 29, 2025
@ronaldtse ronaldtse moved this from 🆕 New to 🌋 Urgent in Metanorma Jan 29, 2025
@ronaldtse
Copy link
Contributor

@iho-ohi would provide the relevant rules so we can implement.

@JeffWootton
Copy link

Rules for inclusion of "Page intentionally left blank" pages:

Blank pages are added to ensure that the next component of a document is numbered with an odd page number. Generally, this is done in order to facilitate hard-copy printing of the document. Therefore, in the below rules, "Page intentionally left blank" is only required in order to add an even numbered page within the document page numbering.

  • If the publication has no copyright boxed note (normally on page ii of the publication), page ii should be "Page intentionally left blank".
  • If the "document structure and history" (roman numeral numbered section of the document - title page, copyright note, table of contents, document history, summary of changes, ...) also contains a Forward or an Introduction, this should commence on an odd-numbered page. If not, a "Page intentionally left blank" page should be inserted before (as an even-numbered page).
  • The last page of the "document structure and history" (roman numeral numbered section of the document) must be an even number. If not, a "Page intentionally left blank" page must be inserted at the end (as an even-numbered page).
  • If the publication has multiple Parts (for example S-4, S-100), the last page of each Part must be an even page numbered page. If not, a "Page intentionally left blank" page must be inserted at the end (as an even-numbered page). If each Part has its own "part structure and history" (roman numeral numbered section), the above rules apply for each Part.
  • In general, IHO Publications do not require each major Section (level 1 headings) of the publication to begin on an odd page, however this may be required in some cases for clarity. Where this is the case a "Page intentionally left blank" page may need to be inserted at the end of a Section (as an even-numbered page).
  • If the orientation of pages changes within a document (portrait to landscape and vice-versa), the first page of changed orientation must be an odd numbered page. If not, a "Page intentionally left blank" page must be inserted at the end of the previous page orientation (as an even-numbered page).
  • Any Appendices or Annexes included within the document must commence on a odd numbered page. If not, a "Page intentionally left blank" page must be inserted before (as an even-numbered page).
  • The last page of the document must be an even numbered page. If not, a "Page intentionally left blank" page must be inserted at the end (as an even-numbered page).

@Intelligent2013 Intelligent2013 moved this from 🌋 Urgent to 🏗 In progress in Metanorma Feb 15, 2025
@Intelligent2013
Copy link
Contributor

@JeffWootton thank you for the rules!

  • If the publication has multiple Parts (for example S-4, S-100), the last page of each Part must be an even page numbered page. If not, a "Page intentionally left blank" page must be inserted at the end (as an even-numbered page). If each Part has its own "part structure and history" (roman numeral numbered section), the above rules apply for each Part.

@ronaldtse currently, IHO XSLT doesn't support the collection (multiple documents in one PDF). Should I add it?

  • In general, IHO Publications do not require each major Section (level 1 headings) of the publication to begin on an odd page, however this may be required in some cases for clarity. Where this is the case a "Page intentionally left blank" page may need to be inserted at the end of a Section (as an even-numbered page).

@ronaldtse currently, IHO XSLT doesn't insert the page break before each level 1 clause. I propose to add the document attribute something like this: :presentation-metadata-section-from-new-page: true.

Intelligent2013 added a commit to metanorma/mn-native-pdf that referenced this issue Feb 16, 2025
@Intelligent2013
Copy link
Contributor

IHO XSLT updated for these requirements:

  • If the publication has no copyright boxed note (normally on page ii of the publication), page ii should be "Page intentionally left blank".
  • If the "document structure and history" (roman numeral numbered section of the document - title page, copyright note, table of contents, document history, summary of changes, ...) also contains a Forward or an Introduction, this should commence on an odd-numbered page. If not, a "Page intentionally left blank" page should be inserted before (as an even-numbered page).
  • The last page of the "document structure and history" (roman numeral numbered section of the document) must be an even number. If not, a "Page intentionally left blank" page must be inserted at the end (as an even-numbered page).
  • If the orientation of pages changes within a document (portrait to landscape and vice-versa), the first page of changed orientation must be an odd numbered page. If not, a "Page intentionally left blank" page must be inserted at the end of the previous page orientation (as an even-numbered page).
  • Any Appendices or Annexes included within the document must commence on a odd numbered page. If not, a "Page intentionally left blank" page must be inserted before (as an even-numbered page).
  • The last page of the document must be an even numbered page. If not, a "Page intentionally left blank" page must be inserted at the end (as an even-numbered page).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
Status: 🏗 In progress
Development

No branches or pull requests

4 participants