You're on your way to the next level! Join the Kudos program to earn points and save your progress.
Level 1: Seed
25 / 150 points
1 badge earned
Challenges come and go, but your rewards stay with you. Do more to earn more!
What goes around comes around! Share the love by gifting kudos to your peers.
Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!
Join now to unlock these features and more
The Atlassian Community can help you and your team get more value out of Atlassian products and practices.
Related article: Using macrons in Jira Cloud
Māori is one of the official languages in New Zealand. In written form, Māori language uses a diacritical mark called a macron, indicating long vowel sounds.
Like umlauts and Asian characters, you cannot always assume they will display correctly within your tools.
Why are macrons important?
These diacritical marks are more than clothing or an accessory for letters that indicate how a word should be pronounced as the example below shows:
So what do you need to know when using macrons in Confluence Cloud?
You will need to set up your keyboard to be able to type letters with macrons (details here) or use a copy-and-paste technique with the help of the online keyboard maori.typeit.org.
Like with Jira project keys, macrons cannot be used in space keys.
Printing to PDF
Not all font families have support for macrons. If you can see macrons saved in your pages but the letters are missing then you use Export to PDF, follow the instruction here to change font. Roboto is an example of a font family that is Māori macron friendly.
Searching with macrons
The search function in Confluence is not able to return a search for a word when it contains a macron, unless you type the search word using macrons.
CONFCLOUD-22495 'Allow search feature to ignore accent' has been open since 2011 and has a status of gathering interest.
There are two workarounds:
Page URLs and macrons
Many of us like to use Confluences default page title "pretty" format:
Any macrons in your page title will be replaced with "+" signs just like spaces. This means a page called 'Guide to Māori macrons' would look like:
The page ID format will be used if page title contains a URL reserved or unsafe character, such as: % & ? / \ ; " § +, or, if the final character of the page title is of any non-alphanumeric character.
The good news
Space names, page titles, and page content can be saved and displayed in Confluence Cloud without requiring apps or additional steps.
Wellington, New Zealand
69 accepted answers