LogoLogo
MainsailMainsailOSCrowsnest
  • Welcome to Mainsail
  • Setup
    • Installation
      • MainsailOS
      • KIAUH
      • Docker
      • Manual setup
      • my.mainsail.xyz
    • Updates
      • Update Manager
      • Manual Update
    • Configuration
  • overview
    • Features
      • Bed Mesh
      • Console
      • Dashboard Organisation
      • Exclude Objects
      • Hide macros, outputs or fans
      • Localization
      • Macro Management
      • Macro Prompts
      • Presets
      • Print History and Statistics
      • Query devices
      • Built-in Themes
      • Custom Themes
        • Prepare
        • Backgrounds
        • Logos and Icons
        • Custom Navigation
        • Custom CSS
        • Community Themes
      • Thumbnails
      • Webcam
    • Settings
      • General
      • Console
      • Control
      • Dashboard
      • Editor
      • G-Code Viewer
      • Macros
      • Presets
      • Printers
      • UI-Settings
      • Webcams
    • Slicer
      • Cura
      • Ideamaker
      • PrusaSlicer
      • SuperSlicer
    • Quicktips
      • Slicer upload
      • Remote Access
      • Printer power switch
      • Additional Sensors
      • Disable Octoprint LCD menu
      • config.json
  • FAQ
    • Mainsail
    • Klipper warnings
      • Deprecated Values
      • Deprecated Options
      • Runtime Warning
    • Moonraker warnings
      • PolicyKit Permissions
    • Klipper errors
      • MCU Protocol error
    • Mainsail errors
      • Unauthorized
    • Getting Help
      • Discord
      • GitHub Discussions
  • About
    • Data Privacy
    • Sponsors
    • Development
      • Code standards
      • Contribute
      • Environment
      • Localization
    • Credits
  • 🔗Links
    • Github
    • Release Notes
    • Discord
    • Youtube
Powered by GitBook
On this page
Edit on GitHub
  1. About
  2. Development

Localization

PreviousEnvironmentNextCredits

Last updated 1 year ago

Was this helpful?

CtrlK
  • How to contribute
  • Translate via Webtool - Weblate
  • Testing

Was this helpful?

Mainsail uses vue-i18n for its localization. All Locales can be found in the /src/locales directory in JSON format.

How to contribute

You can contribute in a couple of different ways:

  1. Create/Update translations using an i18n translation tool. (For Example: BabelEdit, i18N-Manager)

  2. Create/Update translations using VSCode and i18n Ally.

If you have a finished translation file, you can make a PR (pull request) on Github or create an issue on Github and attach the translation.

Translate via Webtool - Weblate

Weblate is a web based translation tool with tight version control integration. It features a simple and clean user interface, propagation of translations across components, quality checks and automatic linking to source files. Click here to go to Weblate.

Current translation state

Testing

Test your translations live

You can follow this guide to start Mainsail in a “Debug Mode” and check your translation live.

Check the translation with vue-i18n-extract

Mainsail comes with the vue-i18n-extract dependency, with this tool, you can check your translation for missing or unused entries.

npm install           # only once and if you updated/installed packages
npm run i18n-extract  # starting i18n-extract to check all translation files