Skip to content

Improved PDF typography #2906

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.

Sign up for GitHub

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
ViralBShah wants to merge 3 commits into
base: master
Choose a base branch
from
Open

Improved PDF typography #2906

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
4ba8c9e
Enable microtype for improved PDF typography
ViralBShah Mar 14, 2026
932c388
Add changelog entry for microtype
ViralBShah Mar 14, 2026
4139fb6
Add selnolig, bookmark, page headers, and friendly code theme
ViralBShah Mar 14, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions .github/workflows/CI.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -100,9 +100,11 @@ jobs:
with:
packages: |
scheme-medium
bookmark
hyperref
minted
newunicodechar
selnolig
transparent
upquote
tabulary
Expand Down
1 change: 1 addition & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
### Added

* Support self-hosted GitHub instances. ([#2755])
* Improved PDF typography: `microtype` for character protrusion and font expansion, `selnolig` for ligature suppression, `bookmark` for improved PDF bookmarks, page headers with chapter/section names, and `friendly` Pygments theme for syntax-highlighted code blocks. ([#2906])


## Version [v1.17.0] - 2026-02-20
Expand Down
19 changes: 19 additions & 0 deletions assets/latex/documenter.sty
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,14 @@
% DejaVu Sans instead.
\newfontfamily\unicodeveebarfont{DejaVu Sans}[Scale=MatchLowercase]
\newcommand\unicodeveebar{{\unicodeveebarfont ⊻}}

% typography: enable microtypographic enhancements (character protrusion,
% font expansion, tracking) for improved paragraph layout and justification.
\usepackage{microtype}
\microtypesetup{nopatch=item} % avoid interaction with memoir's list formatting

% suppress inappropriate ligatures (LuaLaTeX only)
\usepackage{selnolig}
%

% colours
Expand Down Expand Up @@ -38,6 +46,7 @@
frame = none,
bgcolor = codeblock-background,
rulecolor=codeblock-border,
style = friendly,
}
%

Expand All @@ -56,6 +65,8 @@
urlcolor = dark-purple,
colorlinks = true,
}
% improved PDF bookmarks (must be loaded after hyperref)
\usepackage{bookmark}
%

% table of contents
Expand All @@ -72,6 +83,14 @@
\setlrmarginsandblock{1.5in}{1in}{*}
\setheaderspaces{1in}{*}{*}
\checkandfixthelayout

% page headers: show chapter and section for navigation
\makepagestyle{documenter}
\makeevenhead{documenter}{\thepage}{}{\slshape\leftmark}
\makeoddhead{documenter}{\slshape\rightmark}{}{\thepage}
\makeevenfoot{documenter}{}{}{}
\makeoddfoot{documenter}{}{}{}
\pagestyle{documenter}
%

% images etc.
Expand Down
Loading