squirrelscan
GitHub

Typographic hygiene: double spaces, mixed quotes and stray dashes

Repeated spaces, mixed straight and curly quotes, a space before punctuation and a double hyphen used as a dash read as unproofread. squirrel counts each in your body copy.

What typographic hygiene is

Each of these is trivial on its own. Together they are the tell that nobody proofread the page: two spaces between words, a page that uses both "straight" and “curly” quotes, a stray space before a comma, or -- typed where a dash was meant. The rule is deliberately low-key. It is an info rule and it cannot move the health score more than any other info-class rule.

What squirrel checks

The rule runs on every crawled page over the rendered prose in <body>. It leaves out <script>, <style>, <noscript>, <pre>, <code>, <samp>, <kbd>, code editors and syntax highlighters, so quoted source is never judged. It emits a single check named typography:

  • Skipped when there is no parsed document or no <body>.
  • Pass when nothing matched. Message: No typographic inconsistencies in body copy.
  • Warn when something matched. Message: 3 typographic issue(s) in body copy (double-space, mixed-quotes).
  • Fail when 20 or more occurrences were found in total.

The four families:

KindWhat matches
double-spaceTwo or more spaces, or a space beside a no-break space, between two words on one line
mixed-quotesStraight and curly double quotes both present, or straight and curly single quotes and apostrophes both present. A page that is all straight or all curly is clean
space-before-punctuationA word, a single space, then , . ; : ! ? that ends the word. Ellipses, domains such as example.com and emoticons are not matched
double-hyphen-dash-- surrounded by spaces, or glued between two words. ---, --> and a CLI flag such as --verbose are not matched

Some locales put a space before ; : ! ? on purpose. French is the main one, and the space-before-punctuation check is not run when the page’s lang is fr or one of the languages that follow French typography (br, oc, co, wa, ht, ln, wo, mg). It is also not run when the page declares no lang at all, because a French page and a sloppy English page cannot be told apart. The other three checks always run.

Note that browsers collapse repeated spaces when they render, so a double space is a source hygiene signal rather than something a visitor sees, unless it uses a no-break space.

How to fix it

Pick one convention and apply it everywhere. Let your editor or CMS smart-quote the copy so quotes and apostrophes come out consistent. Use CSS, not extra spaces, for layout. Replace -- with an em dash, or with a comma, colon or full stop. If the page is French, set <html lang="fr">.

Rule IDcontent/typography
CategoryContent
ScopePer-page
Severityinfo
Weight1/10

Enable / disable

Disable this rule

[rules]
disable = ["content/typography"]

Disable all Content rules

[rules]
disable = ["content/*"]

Enable only this rule

[rules]
enable = ["content/typography"]

enable replaces the default ["*"], so this is the only rule selected. Leave disable out: a rule that matches any disable pattern is skipped even when enable names it. Only an enabled setting under a rule’s own [rule_options] table overrides both lists.

Check names by outcome

Each check name this rule can emit, by what it means to a tool comparing two audits. A problem check is a finding. A clean check says the rule ran over what it covers and found nothing; it clears the problem checks listed beside it, so a finding is fixed when the rule ran over the same scope and a clean check took its place. A not checked check says the rule did not evaluate, and never clears a finding.

Check nameOutcomeClears
typographyProblem
typographyCleantypography
typographyNot checked

Content findings ship in every audit next to the SEO, performance and agent experience rules. See Fix SEO issues with AI for how an agent works through a report.

Check your site

Run squirrel audit https://example.com and open the Content section of the report. Signed-out local audits need no account and cost nothing. Signed-in audits spend credits.

Type to search…

↑↓ navigate↵ openesc close