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

toc start at value don't always behave as expected #2489

Closed
mojavelinux opened this issue Feb 3, 2024 · 0 comments
Closed

toc start at value don't always behave as expected #2489

mojavelinux opened this issue Feb 3, 2024 · 0 comments
Assignees
Milestone

Comments

@mojavelinux
Copy link
Member

mojavelinux commented Feb 3, 2024

The expectation is that if the page numbering or running content start at value is set to toc, the respective feature will start at the first page of the TOC.

Here are the scenarios that are not working as expected:

  • start at is toc and toc placement is macro (both page numbering and running content)
  • start at is toc and toc placement is preamble (both page numbering and running content)
  • index entry page numbers when page numbering start at is toc

Here's a reproducible example:

= Book Title
:doctype: book
:toc: macro
:media: prepress

[colophon%notitle]
== Dedication

Credit where credit is due.

toc::[]

== Start

Let's go.

== Finish

Let's wrap this up.

This example is expected to be used with a theme that configures the page numbering to start at the toc:

extends: default
page-numbering:
  start-at: toc

The documentation should also be updated to emphasize that the toc and after-toc start at values are really only intended to be used with the book doctype (though they do work with the article doctype if the title page is enabled). Also emphasize that for a prepress book, the after-toc value maps to the first recto page that follows the TOC.

@mojavelinux mojavelinux self-assigned this Feb 3, 2024
@mojavelinux mojavelinux added the bug label Feb 3, 2024
@mojavelinux mojavelinux added this to the v2.3.x milestone Feb 3, 2024
mojavelinux added a commit to mojavelinux/asciidoctor-pdf that referenced this issue Feb 4, 2024
…ng and running content when toc is added using macro
mojavelinux added a commit to mojavelinux/asciidoctor-pdf that referenced this issue Feb 4, 2024
…ng and running content when toc is added using macro
mojavelinux added a commit to mojavelinux/asciidoctor-pdf that referenced this issue Feb 5, 2024
…ng and running content when toc is added using macro
mojavelinux added a commit that referenced this issue Feb 5, 2024
…and running content when toc is added using macro
mojavelinux added a commit that referenced this issue Feb 16, 2024
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