feat(styles): add hyphenation utility for post content
Tachyons has no hyphenation classes. Add a hyphenate utility class with
hyphens: auto and hyphenate-limit-chars, keep headings and code words
whole, and apply it to single-page content. Sites redefine the class in
custom CSS to change or disable it.
4 files modified
1 files added
| | |
| | | Tachyons typography utilities define the scale and families. Ananke's defaults layer these choices on top: |
| | | |
| | | * **Body shell:** `avenir` with `bg-near-white` on the `<body>`. |
| | | * **Article body:** `serif f4 lh-copy nested-links`, overridable with `post_content_classes`. |
| | | * **Article body:** `serif f4 lh-copy nested-links`, overridable with `post_content_classes`. Single-page content also has `hyphenate`, Ananke's own hyphenation utility in `_styles.css` (Tachyons has none); sites redefine the class in custom CSS to change or disable it. |
| | | * **Headlines:** `athelas` for article and summary headings; site hero headings use lightweight sans-serif (`fw2`). |
| | | * **Navigation:** lightweight sans-serif with responsive sizes (`f5 f4-ns` for menu items and `f3 fw2` for the site title/logo text). |
| | | * **Metadata:** `helvetica tracked ttu` and small text sizes for section labels, dates, reading time, and word count. |
| | |
| | | } |
| | | |
| | | /* ------------------------------------------------------------------ * |
| | | * Hyphenation utility (Tachyons has none) |
| | | * |
| | | * Browsers hyphenate only text in a language they have a dictionary |
| | | * for; baseof.html sets `lang` from the site locale. Words need six |
| | | * letters, with three on each side of the break. Headings and code |
| | | * keep their words whole. Sites change or disable this by redefining |
| | | * `.hyphenate` in ananke.custom_css, for example |
| | | * `.hyphenate { hyphens: manual; }`. |
| | | * ------------------------------------------------------------------ */ |
| | | |
| | | .hyphenate { |
| | | hyphens: auto; |
| | | hyphenate-limit-chars: 6 3 3; |
| | | } |
| | | |
| | | .hyphenate :where(h1, h2, h3, h4, h5, h6, code, kbd, samp) { |
| | | hyphens: manual; |
| | | } |
| | | |
| | | /* ------------------------------------------------------------------ * |
| | | * Header navigation (see layouts/_partials/site-navigation.html) |
| | | * |
| | | * Colours, type, and spacing come from Tachyons classes in the template; |
| | |
| | | {{ .Title }} |
| | | </h1> |
| | | </header> |
| | | <div class="nested-copy-line-height lh-copy f4 nested-links {{ $.Param "text_color" | compare.Default "mid-gray" }}"> |
| | | <div class="nested-copy-line-height lh-copy hyphenate f4 nested-links {{ $.Param "text_color" | compare.Default "mid-gray" }}"> |
| | | {{- partials.Include "hook.html" (dict "hook" "content-before" "context" .) -}} |
| | | {{ .Content }} |
| | | {{- partials.Include "hook.html" (dict "hook" "content-after" "context" .) -}} |
| | |
| | | <span class="f6 mv4 dib tracked"> - {{ lang.Translate "wordCount" .WordCount }} </span> |
| | | {{ end }} |
| | | </header> |
| | | <div class="nested-copy-line-height lh-copy {{ $.Param "post_content_classes" | compare.Default "serif"}} f4 nested-links {{ $.Param "text_color" | compare.Default "mid-gray" }} {{ compare.Conditional (compare.Eq $.Site.Language.Direction "rtl") "pl4-l" "pr4-l" }} {{ if $needs_aside }}w-two-thirds-l{{ else }}w-100-l{{ end }}"> |
| | | <div class="nested-copy-line-height lh-copy hyphenate {{ $.Param "post_content_classes" | compare.Default "serif"}} f4 nested-links {{ $.Param "text_color" | compare.Default "mid-gray" }} {{ compare.Conditional (compare.Eq $.Site.Language.Direction "rtl") "pl4-l" "pr4-l" }} {{ if $needs_aside }}w-two-thirds-l{{ else }}w-100-l{{ end }}"> |
| | | {{- partials.Include "hook.html" (dict "hook" "content-before" "context" .) -}} |
| | | {{- .Content -}} |
| | | {{- partials.Include "hook.html" (dict "hook" "content-after" "context" .) -}} |
| New file |
| | |
| | | import { expect, test } from "@playwright/test"; |
| | | |
| | | const POST = "/posts/hello/"; |
| | | |
| | | const hyphens = (selector: string) => (page: import("@playwright/test").Page) => |
| | | page |
| | | .locator(selector) |
| | | .first() |
| | | .evaluate((element) => getComputedStyle(element).hyphens); |
| | | |
| | | test.describe("hyphenation utility", () => { |
| | | test("hyphenates post paragraphs in the page language", async ({ page }) => { |
| | | await page.goto(POST); |
| | | await expect(page.locator("html")).toHaveAttribute("lang", /.+/); |
| | | await expect(page.locator("article .hyphenate")).toHaveCount(1); |
| | | expect(await hyphens("article .hyphenate p")(page)).toBe("auto"); |
| | | }); |
| | | |
| | | test("keeps code words whole", async ({ page }) => { |
| | | await page.goto(POST); |
| | | expect(await hyphens("article .hyphenate p code")(page)).toBe("manual"); |
| | | expect(await hyphens("article .hyphenate pre")(page)).toBe("none"); |
| | | }); |
| | | |
| | | test("site CSS can redefine the class", async ({ page }) => { |
| | | await page.goto(POST); |
| | | await page.addStyleTag({ content: ".hyphenate { hyphens: manual; }" }); |
| | | expect(await hyphens("article .hyphenate p")(page)).toBe("manual"); |
| | | }); |
| | | }); |