Translate

The Caards theme includes built-in support for multiple languages and can be fully translated using simple JSON files. It also offers automatic RTL support for the Arabic language (ar).

Included Languages:

• English (EN)

• Spanish (ES)

• French (FR)

• Portuguese (PT)

• German (DE)

• Dutch (NL)

• Italian (IT)

• Turkish (TR)

• Arabic (AR)

How it Works

Translations are handled using Ghost’s official {{t}} helper and simple JSON files located in the theme’s locales/ folder. You can easily modify existing translations or add your own without needing to install any dependencies.

For more information, see: Ghost Translate System

How to Edit or Add a Translation

Follow the steps below:

1

Unzip the Theme

• Unzip the theme caards.zip file on your computer.

2

Open the Translations Folder

• Go to the locales/ directory inside the theme folder.

3

Edit an Existing File

• Open a file like pt.json using a code editor such as Visual Studio Code or Sublime Text.
• Update the values to match your preferred translations:

  {
    "Subscribe": "Inscreva-se"
  }

4

Add a New Language (Optional)

• Duplicate an existing file (e.g., en.json)

• Rename it using a valid language code (e.g., de.json for German)
• Replace the values with your own translations.

5

Repackage the Theme

• Compress the entire theme folder into a new caards.zip file.

6

Upload the Updated Theme

• In Ghost Admin, go to: Settings > Site > Theme > Change theme > Upload Theme yoursite.com/ghost/#/settings/theme

7

Set the Site Language

• Go to Settings > General > Publication Language and enter your language code (e.g., pt, es, fr, ar, de)

Recommended Tools

To safely edit translation files, always use a code editor that supports UTF-8 encoding and JSON formatting, such as:

• Visual Studio Code
• Sublime Text

Avoid using basic text editors like Notepad or word processors like Word — they can break the file structure, add hidden characters, or corrupt encoding, which may cause errors when uploading the theme.