.. /* * This file is part of the SavaPage project . * Copyright (c) 2026 Datraverse B.V. * Author: Rijk Ravestein. * * SPDX-FileCopyrightText: (c) 2020 Datraverse B.V. * SPDX-License-Identifier: CC-BY-SA-4.0 * * For more information, please contact Datraverse B.V. at this * address: info@datraverse.com */ .. _ch-i18n: .. figure:: ../images/manual/savapage-logo-no-text-100px.png :width: 75px Internationalization ==================== .. admonition:: |ADMONITION_TABLE_OF_CONTENTS| - :numref:`{number}. {name} ` - :numref:`{number}. {name} ` *Internationalization* is the process of designing a software application so that it can potentially be adapted to various languages and regions without engineering changes. *Localization* is the process of adapting internationalized software for a specific region or language by adding locale-specific components and translating text. |PRODUCT_NAME| is internationalized software and can easily be localized to different languages, countries or regions. .. _ch-i18n-localization: Localization ------------ The following localization rules apply: - The Web App user interface localizes according to either the locale saved in the browser's local storage during a previous visit [1]_, or to the country/region code of the browser, or finally to the language chosen at :ref:`Login `. - Reports generated from the Web App localize according to the language of the Web App, except for :ref:`Vouchers ` and Receipts at the |RST_LINK_POS_WEBAPP| and :ref:`User Web App `, which use the :ref:`System Locale `. - The :ref:`System Locale ` is applied to all system messages as broadcasted to the Admin Web App :ref:`Dashboard `, written to the Application Log, or send by email. - Text in log and audit files is fixed to the English language. So, when in need for support, these files can easily be understood by |PRODUCT_NAME| Support. - Dates and numbers are formatted according to the localization context. - The currency symbol of the localization context is used. - When localized text is not found the fall-back language will be English. So, in case |PRODUCT_NAME| is partially translated for a selected locale, the user experience will be fragmented, as part of the text will fall back to English. |PRODUCT_NAME| handles all localized text and user entered data as Unicode. The Web Browser, and therefore the Web App, natively displays Unicode correctly. However, the correct display of Unicode in PDF reports, needs special attention. Therefore, :ref:`Internal Fonts ` are available to customize PDF generation. .. [1] After login, the locale of the WebApp is saved in the browser's local storage, together with the :ref:`Authentication Tokens `. .. _ch-i18n-localization-notes-for-translators: Notes for Translators ~~~~~~~~~~~~~~~~~~~~~ Currently |PRODUCT_NAME| is fully localized to *English*, *German*, *French*, *Swedish*, *Chinese (Traditional, Taiwan)* and *Dutch*. If you want to localize the software to another region, the easiest way to get started is by using the :ref:`Custom i18n ` feature with the ``*.xml`` files from the `savapage-i18n-en `__ repository as a reference. In this way your translation is directly visible in the application. .. important:: Please tell us about your localization effort by sending an email to |RST_SAVAPAGE_SUPPORT_EMAIL|, so we can give you all the support needed.