getodk / getodk/docs

Overfull and underfull issues in pdf generation

Open
#560 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
58
Forks
160
Avg merge
5d 11h
Merged PRs (30d)
12

Description

Building pdf from latex file generated by sphinx latex builder results in underfull and overfull boxes in case of admonitions of long contents and images. Though it does not break the output currently, we need to find a way to fix this.

One of the solutions is to expand or contract the content when we have an underfull or overfull case respectively but that will result in a poor output.

Contributor guide

Open the contributing guide

Research direction

Reproduce the Sphinx LaTeX build for an admonition containing long content and images, then inspect the generated PDF and the underfull or overfull box warnings. The work is complete when these layout issues are resolved without degrading the PDF output; no source files or tests are named in the issue.

Written by the indexing model from the issue text.

Assessment

Tech stack
latex
Domain
build-system, documentation
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
28/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.