The Marijn van Hoorn style guide

Or: The typing quirk hall of shame (version 1.6.0)

I have many, many quirks in how i use the English language — in fact, i’ve often made jokes about having to add something to my internal style guide. But recently, i realised it might actually be a good idea to start keeping one, so here it is! This document details how i try to write things up for this site.

1. Spelling

Use British English spellings: colour, not color.

Use -ise, not -ize.

Use Æ and Œ only when there is precedent for using ae and oe in modern usage: æsthetic and fœtus, but not æquals or œconomy. (See § 2.3 ‘Problem Words’ for semantically-important exceptions.)

Use diæreses when vowel sounds are separate and could potentially be confused for a preëxisting digraph: coöperative, poëtic, reünion.

IJ is one letter, and it should be treated as such: IJsselmeer, Marijn (with wide spacing).

Use em and en dashes for their proper purposes, surrounding the em dash with thin spaces:

Excuse me  is this the LondonManchester train?

Numbers should be set in old-style figures (e.g. 11987) when set flush with lowercase text; if on their own or next to all-caps text, they should be set in lining figures (e.g. 11987).

1.1. Capit­al­is­a­tion & proper nouns

De­capit­al­ise the pronoun i when not at the start of a sentence:

I thought i had left it over there.

Do not capit­al­ise positions of power unless they’re being used as a title:

Justin Trudeau, prime minister of Canada, met President Obama on Thursday.

For trademarks styled in all-caps, use title case: Lego, not LEGO.

The internet and (world wide) web are media for carrying in­form­a­tion, like tele­vi­sion and radio, and should generally be left un­capit­al­ised. Capit­al­is­ing Internet is acceptable if talking about its physical infra­struc­ture.

Proper nouns, nation­al­ities, ethnic groups, &c. should be capped up: Eswatini, German, Black.

This also applies to religious groups: the Baháʼí Faith0, Muslims, and Pagans.

1.2. Acronyms

Use all-caps for initialisms pronounced as multiple letters. When they do not function as proper nouns, use small-caps: FBI and BBC, but ATM and LGBTQ.

Use title case for acronyms pronounced as one word: Nasa, Ukip, Unesco, Latex1.

Use lowercase for acronyms which are pronounced as one word and have been fully naturalised as common nouns: laser, radar, gif.2

1.3. Apostrophes, quotes, ʻokinas, and more

The difference between all of these signs is often confusing, so i’m going to try to clear up how they’re used as best as possible.

“ ”, ‘ ’: These are quotes, used to mark when someone is speaking or used for sarcastic effect as “scare quotes”. Punctuation should be kept outside the quotes if not a part of the quote, British-style. Either double or single is fine, as long as you switch between them when nesting quotes:

The explosion was a rather unexpected consequence of getting a pet cat, said Aurora after the dust had settled.
The explosion was a rather unexpected consequence of getting a pet cat, said Aurora after the dust had settled.

In Dutch, the traditional „ ” form should be used, with the left side aligned beneath the text.

En hoe moest ík weten dat de kat een blok c4 bij zich had‽

: This is an apostrophe; it shares a Unicode character with the right single quote. It’s used for possessives and contractions: Aisha’s, ’twas, don’t.

ʻ ʼ: These are the ʻokina and saltillo, characters with separate Unicode characters used to denote glottal stops (like the gap in the middle of uh-oh or the British pronunciation of butter) in various foreign languages. Some of these languages, most notably Hawaiʻian, have imported words back into English: Hawaiʻi, ʻōʻō.

′ ″: These are the prime and double prime characters, most often used to transcribe feet and inches or arcminutes and arcseconds: 6′ 2″, 3° 5′ 30″. They are also inexplicably used in the official romanisation of Russian to indicate the Cyrillic character ь: КазаньKazan′.

' ": These are abominations and should only be used in verbatim transcriptions of computer code. For example: console.log("When the imposter is sus!");

2. Term­in­o­logy

When referring to the country of the United States, never use the unqualified term America; that term can refer to the entire continent. Where one would normally use American, use US-American instead.

Use the singular they when talking about someone of unknown gender. It’s that easy.

If someone uses multiple sets of pronouns, use pWitch.js to switch between them.

After the first mention of a person, refer to them with a courtesy title (e.g. Mr., Ms., Mx.), using their given name if their surname is either unknown or nonexistent. For example:

2.1. Foreign terms

Don’t italicise foreign words that have been naturalised into English, unless talking about them in a linguistic context: sushi, fatwa, hygge.

Do italicise foreign phrases used as English terms: je ne sais quoi, a priori, déjà vu, feng shui. This does not apply to proper nouns like names and places: Jón Þór Birgisson, Alphen aan den Rijn.

Don’t italicise words in languages that don’t use the Latin script, even when they otherwise would be. The script change alone is enough to distinguish them: ξενία and пропага́нда, not ξενία and пропага́нда.

When writing something in a non-Latin/Greek/Cyrillic script, provide a webfont that supports it. Not everyone has the same fonts on their computer as you do.

People generally know their own language better than you do; when romanising terms, use the roman­is­a­tion system employed by the largest community or government of that language. Some examples are specified in this table:

Language Romanisation Example
Arabic UNGEGN standard v. 5.0 يولد جميع الناس أحراراً متساوين في الكرامة والحقوق.
Yūladu jamīʻu n-nāsi aẖrāran mutasāwīna fī l-karāmati wa-l-ẖuqūq.
Modern Greek ELOT 743 transcription ’Ολοι οι άνθρωποι γεννιούνται ελεύθεροι και ίσοι στην αξιοπρέπεια και τα δικαιώματα.
Óloi oi ánthropoi genniountai eléftheroi kai ísoi stin axioprépeia kai ta dikaiómata.
Hindi Hunterian transliteration सभी मनुष्यों को गौरव और अधिकारों के मामले में जन्मजात स्वतन्त्रता और समानता प्राप्त है।
Sabhī manushyon ko gaurav aur adhikārom kai māmle men janmajāt svatantratā aur samānta prāpt hai.
Japanese Hepburn romanisation すべての人間は、生まれながらにして自由であり、かつ、尊厳と権利とについて平等である。
Subete no ningen wa, umarenagara ni shite jiyū de ari, katsu, songen to kenri to ni tsuite byōdō de aru.
Mandarin Hànyǔ Pīnyīn 人人生而自由,在尊严和权利上一律平等。
Rénrén shēng ér zìyóu, zài zūnyán hé quánlì shàng yīlù píngděng.
Russian Gost 7.79-2000 system B Все люди рождаются свободными и равными в своем достоинстве и правах.
Vse lyudi rozhdayu­tsya svobodnyʹmi i ravnyʹmi v svoem dostoi­stve i pravax.

An exception is made for roman­is­a­tions of Ancient Greek terms, which use the following more Latinate conventions:

Ancient Greek roman­is­a­tion table
Greek Latin Notes
α a
β b
γ g
n Before another velar stop, i.e. in the sequences γγ, γκ, γξ, γχ
δ d
ε e
ζ z
η ē
θ th
ι i
κ c
λ l
μ m
ν n
ξ x
ο o
π p
ρ r
rh Word-intially and after another ρ
σ/ς ſ/s
τ t
υ y
u In the sequences αυ, ευ, ηυ, υι, ωυ
φ ph
χ ch
ψ ps
ω ō
Digraphs
αι æ
οι œ
oi Word-finally

2.2. Table of demonyms

Some countries and territories have unexpected adjectives or terms for their residents. An incomplete list can be found in the table below:

Place name Demonym Adjective
Countries & territories
Botswana a Motswana, many Batswana Botswanan or Motswana
Burkina Faso a Burkinabé
Côte d’Ivoire an Ivorian
Dominica a Dominican3
the Dominican Republic a Dominican4 or Quisqueyano/a (poëtic) Dominican or Quisqueyan (poëtic)
Eswatini a or many Swazi or Swati Swazi
Kiribati an or many I-Kiribati Gilbertese
Lesotho a Mosotho, many Basotho Basotho
Madagascar a or many Malagasy
Monaco a Monégasque
Myanmar N/A Myanma or Burmese
Niger a Nigerien
the Philippines a Filipino/a Filipino or Philippine
the Seychelles a or many Seychellois
St. Vincent and the Grenadines a Vincentian
the United Arab Emirates an Emirati
Vanuatu a or many Ni-Vanuatu
US states (generally no adjectival form)
Hawaiʻi N/A or a Kamaʻāina Hawaiʻian5
Illinois an Illinoian or Illinoisian
Indiana a Hoosier
Massa­chu­setts a Bay Stater, Massa­chu­setts­an, or (vulgar) Masshole
Michigan a Michigander or Michiganian
New Hampshire a New Hampshirite
Utah a Utahn

2.3. Problem words

3D (as in three-di­men­sion­al)

Old-style 3, small-caps D. The correct markup, for ease of copying and pasting, is 3<span class="all-sc">D</span>.

Brown/brown, White/white

This style guide leaves the matter of the capit­al­is­a­tion of these words, in the context of ethnicity, de­liber­ate­ly unspecified while a consensus settles. The New York Times capit­al­ises neither; the Washington Post capit­al­ises White but not brown; CNN capit­al­ises both.

dæmon/demon

A dæmon (plural dæmones) is a good or neutral guiding spirit, like those of Hellenic Paganism. A demon is a malevolent entity like those of Abrahamic mythology.

déjà vu

Italicised, with acute and grave accents, and without a hyphen.

Hallowe’en

This spelling is now considered somewhat dated even in British English, but i still prefer it over Halloween.

phœnix/Phoenix

A phœnix is a reïncarnating fire-bird; Phoenix, with no ligature, is a city in Arizona.

practice/practise

Practice is a noun; practise is a verb.

Witch/witch

Use lowercase witch for fictional characters practising fictional magic; use capit­al­ised Witch for real life prac­ti­tion­ers of Witch­craft and fictional depictions of that demo­graph­ic. The same goes for derived words like W/witch­craft, W/witchy, &c.

3. Markup

Use <em> and <strong> when a change of tone is implied; when the font choice is merely stylistic, use <i> and <b>.

<i>Homo sapiens</i> is a <em>very</em> interesting animal.

Use sidenotes for ancilliary information.6 If something would take up too much space as a side note, it’s good courtesy to use a <details> element, like this:

Example element

Hello! I am an example of a <details> element. Pretty nifty, huh?

Make images as light­weight as possible, be it through gif dithering, jpeg com­pres­sion, or just shrinking the image’s dimensions down. It’s the kind thing to do for people with bad connections.

Clitics (e.g. -’s) at the end of terms styled with italics of small caps also have that style applied to them: Apollon’s bow and Back to the Future’s budget, not Apollon’s bow and Back to the Future’s budget.

Manually hyphenate words with more than about eleven letters using &shy;, e.g. ul-tra-crep-id-a-rian.7 Firefox’s hy­phen­ation libraries can sometimes be un­trust­worthy, and Chrome doesn’t support automatic hy­phen­ation at all.

In Dutch text, compound words should be manually hyphenated, regardless of length: stof-zuiger, Neder-lands-talig.

4. Dates

CE and BCE are preferred to AD and BC:

Emperor Augustus reigned from 27 BCE to 14 CE.

When com­muni­cat­ing dates in numerals only, use the yyyy.mm.dd format: The first Garfield comic strip was published 1978.06.19.

Feel free to write the Gregorian alongside the equivalent date in the Attic calendar. It being what it is — a lunisolar calendar invented before computers existed — implementations tend to differ, but here’s how i choose to calculate dates for this site:

5. Faith

In the context of Paganiſm, uſe the long S (ſ) for s,9 except under the following cir­cum­ſtan­ces:

When speaking of or to Gods, make the thou – you diſtinction.

5.1. The Gods

Typeſet the Gods’ names and untranſlated epithets in ſmall caps: Apollon Acestor, but owl-eyed Athena.

This alſo goes for terms derived from Their names and epithets, unless Their names are alſo that of common nouns: Baccha­nal­ian and Herme­tic­al­ly ſealed, but geology.

Typeſet Earth and ocean in ſmall caps. In religious contexts, Sun, Moon, and sky may also be typeſet as ſuch.

Nouns and pronouns referring directly to the Gods ſhould be capped up:

Apollon the Archer ſtretches His glittering bow back...

Do not ſet the names of gods of mono­theïſtic faiths in ſmall caps:

Intereſt­ing­ly, ſome Ancient Greeks aſsociated Jehovah with Dionysos due to his aſ­soci­a­tion with wine and the myſterious nature of his cults.

Do not refer to a handſome young man by Apollon’s name, or otherwiſe uſe the Gods’ names as common nouns referring to people.

Do not typeſet Gods’ names or derivatives thereof in ſmall caps when uſed as names for people:

The Common Era was devised by Dionysius Exiguus.

For reaſons of conſiſtency, do not typeſet days and months named after Gods in ſmall caps:

It’s the last Friday in January today.10

6. The most important rule of all

If following one of these rules makes something look worse, break it!

7. Changelog

← Back to home