swaits
093fcf88fd
Incoroporates changes from [this PR](https://github.com/typst/packages/pull/1527) and updates tests accordingly. Thank you to [neuralpain](https://github.com/neuralpain) and [ssotoen](https://github.com/ssotoen) for the suggestions and code fixes.
126 lines
3.2 KiB
Typst
126 lines
3.2 KiB
Typst
#import "/lib.typ": *
|
|
|
|
#import "@preview/codly:1.2.0": *
|
|
#import "@preview/codly-languages:0.1.1": *
|
|
#show: codly-init.with()
|
|
#codly(languages: codly-languages)
|
|
|
|
#show: easy-typography.with(
|
|
fonts: (heading: "Source Sans 3", body: "Source Serif 4"),
|
|
)
|
|
|
|
= Introducing Easy Typography
|
|
|
|
#set heading(numbering: (..nums) => {
|
|
numbering("1.1.", ..nums.pos().slice(1))
|
|
})
|
|
|
|
The `easy-typography` package transforms complex typographic decisions into
|
|
simple choices, letting you focus on your content while ensuring professional
|
|
results. By adjusting the settings to match your specific needs, you can refine
|
|
the aesthetic or adapt your layout for everything from casual reading to formal
|
|
publication.
|
|
|
|
== Core Typography Features
|
|
|
|
The package manages:
|
|
|
|
#columns(2)[
|
|
- Precise heading scale with a clear hierarchy
|
|
- Optimal line height and paragraph spacing
|
|
#colbreak()
|
|
- Professional text justification and hyphenation
|
|
- Balanced vertical rhythm throughout
|
|
]
|
|
|
|
These features ensure that your document is both visually appealing and easy to
|
|
read.
|
|
|
|
=== Type Formatting
|
|
|
|
This package automatically adjusts line spacing, paragraph spacing, and
|
|
justification to maintain a clean layout. Headings are also carefully weighted
|
|
to balance them against the body text, so you can focus on content rather than
|
|
tweaking spacing and sizing. Standard formatting like *bold* and _italic_
|
|
integrates seamlessly with `easy-typography`'s approach.
|
|
|
|
=== Heading Levels
|
|
|
|
The heading scale gracefully steps down, ensuring that each level remains
|
|
distinct yet consistent. Behind the scenes, `easy-typography` calculates the
|
|
ideal size for each heading, preserving a cohesive visual hierarchy as your
|
|
document gets deeper. This approach supports manuals, academic papers, and any
|
|
long-form text where structure matters. It also helps in shorter documents,
|
|
guaranteeing a crisp layout with minimal effort.
|
|
|
|
== Why Typography Matters
|
|
|
|
Good typography isn't just about aesthetics. It's about effective communication.
|
|
Well-designed text:
|
|
|
|
#columns(2)[
|
|
- Improves reading comprehension
|
|
- Reduces eye strain
|
|
- Maintains reader engagement
|
|
#colbreak()
|
|
- Establishes visual hierarchy
|
|
- Conveys professionalism
|
|
]
|
|
|
|
Notice how this document's typography enhances readability. The justified text,
|
|
proper hyphenation, and optimized line breaks create a clean, professional
|
|
appearance. With each heading level, the user can quickly scan and digest
|
|
important information.
|
|
|
|
== Example Usage and Output
|
|
|
|
#set heading(numbering: none)
|
|
#show raw.where(block: true): set text(size: 7pt)
|
|
|
|
#grid(
|
|
columns: (55%, auto),
|
|
gutter: 1.0em,
|
|
[
|
|
// code
|
|
```typst
|
|
#import "@preview/easy-typography:0.1.0": *
|
|
#show: easy-typography.with(
|
|
fonts: (
|
|
heading: "Source Sans Pro",
|
|
body: "Source Serif Pro"
|
|
),
|
|
)
|
|
|
|
#lorem(6)
|
|
= Level One
|
|
#lorem(6)
|
|
== Level Two
|
|
#lorem(6)
|
|
=== Level Three
|
|
#lorem(6)
|
|
==== Level Four
|
|
#lorem(6)
|
|
===== Level Five
|
|
#lorem(6)
|
|
```
|
|
],
|
|
box(
|
|
stroke: 0.5pt + silver,
|
|
inset: 0.5em,
|
|
radius: 0.2em,
|
|
[
|
|
#lorem(6)
|
|
= Level One
|
|
#lorem(6)
|
|
== Level Two
|
|
#lorem(6)
|
|
=== Level Three
|
|
#lorem(6)
|
|
==== Level Four
|
|
#lorem(6)
|
|
===== Level Five
|
|
#lorem(6)
|
|
]
|
|
) // box
|
|
)
|