Skip to content

Language

Danny White edited this page Jul 9, 2023 · 4 revisions

Prefixes

Some place names start with a prefix like 'the' in 'the Inner West'. The prefix key in guide frontmatter handles this. Prefixes are ignored in situations like the alphabetically sorted directory but included in things like page titles. That way we end up with nice-sounding sentence like:

How to compost in the Inner West

Instead of:

How to compost in Inner West

...which sounds wrong as local.

There is no default prefix set in the collection's guides.json file because prefixes are opt-in. I.e. most places don't have a prefix as part of their name.

Possessive

Some places have the same or similar names to places in other regions. For example: both Sydney and Melbourne have an area named ‘the Inner West’. The boolean possessive key in the guide frontmatter tells the guide layout to render the parent in its respective pages. That way we end up with distinct titles for affected pages, like:

How to Compost in Sydney’s Inner West

How to Compost in Melbourne’s Inner West

As mentioned in Taxonomy: permalinks are formed by the country and then the place name. Not all guides have an ancestor between them and the country so the general rule cannot be more specific. That said, the guide permalink looks for these clashes and appends the parent city's name (Sydney or Melbourne, in this example) to the URL. See Taxonomy for more information.

Preposition

All guides use a preposition to form their title sentence, highlighted in the below example in bold:

How to compost in Sydney

Most of the time that preposition is "in". Sometimes it is "on" like in:

How to compost on the Sunshine Coast

Given that there is always a preposition and that it is usually "in", we set the following default in guides.json:

"preposition": "in",
Clone this wiki locally