Skip to content

Improve the examples given in PDF9 #4315

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

Open
DuffJohnson opened this issue Apr 3, 2025 · 1 comment
Open

Improve the examples given in PDF9 #4315

DuffJohnson opened this issue Apr 3, 2025 · 1 comment

Comments

@DuffJohnson
Copy link

PDF9 includes the following:

Heading markup can be used:

  • to indicate start of main content;
  • to mark up section headings within the main content area;
  • to demarcate different navigational sections, such as top or main navigation, left or secondary navigation, and footer navigation;
  • to mark up images (containing text) which have the appearance of headings visually.

However, in the PDF context (the technology to which this technique applies)...

  • the 1st bullet is dubious at best (especially if H1 is used for the document's title), as many documents locate front-matter (which isn't "main content") after the title.
  • the 2nd bullet would ideally be enhanced to read: "to mark up section headings (text or images) within the main content area;"
  • the 3rd bullet is simply inapplicable in the PDF context, and should be removed
  • the 4th bullet can be retired based on the suggested change to the 2nd bullet.

Ironically, the given examples are far more applicable to HTML content than to PDF... but the various techniques applicable to HTML don't provide these examples.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

1 participant