quarto-dev / quarto-dev/quarto-cli

Feature request: Page Breaks for printing HTML output

Open
#1,200 2 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement html
Dominant language
JavaScript
Stars
6k
Forks
458
Avg merge
1d 9h
Merged PRs (30d)
41

Description

As discussed at the Boston R Users meeting tonight, it would be nice to see quarto gracefully handle setting page breaks in HTML documents. Use case:

  • Prepare a well-designed HTML report that can be sent via email and open/read by non-technical users
  • Deliver report to users who will:
    • view in browser of choice, and/or
    • print a copy, expecting clean page breaks like in a docx file.

Basically, smart CSS print style sheets by default, or with ease.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

No files, tests, or entry points are named. Start by locating the Quarto CLI's HTML output and print-style handling, then inspect how generated HTML output is tested. Done means establishing a clear approach for convenient, clean page breaks when HTML reports are printed.

Written by the indexing model from the issue text.

Assessment

Tech stack
css, javascript
Domain
web-dev
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.