iamgio/quarkdown

[Enhancement] Scope .totalpages to last .resetpagenumber via document|section argument

Open

#596 aperta il 14 lug 2026

Vedi su GitHub
 (3 commenti) (0 reazioni) (1 assegnatario)Kotlin (387 fork)batch import
enhancementgood first issue

Metriche repository

Star
 (13.975 star)
Metriche merge PR
 (Merge medio 1g 6h) (31 PR mergiate in 30 g)

Descrizione

Before submitting

  • I am using the latest version of Quarkdown.
  • I have checked the wiki to confirm this feature doesn't already exist.
  • I have searched existing issues for duplicates.

Description

I would want .totalpages to also be affected by .resetpagenumber. Consider this scenario where I don't want a numbering on the title page:

.doctype {paged}

.center 
    #! Title Page
.pagebreak

# First content page
.pagemargin {bottomcenter}
    .currentpage / .totalpages
.resetpagenumber

# Second content page

# Third content page

I want the page numbering to range from 1/3 to 3/3. Instead it ranges from 1/4 to 3/4.

Proposed syntax or behavior

A relatively easy and backwards-compatible fix would be to allow .totalpages to have an optional argument being one of document | section with document being the default.

  • document will act as the .totalpages-command just as before
  • section will be the number of pages starting from either the last .resetpagenumber-command (considering the start argument there) or the document start

Additional context

This would actually also mimic the behaviour of Microsoft Word, which uses {NUMPAGES} for the total page count of the whole document and {SECTIONPAGES} for the total page count only within the current section.

I am using quakdown version 2.3.1.

Guida contributor