.. /*  
    * This file is part of the SavaPage project <https://www.savapage.org>.
    * Copyright (c) 2026 Datraverse B.V.
    * Author: Rijk Ravestein.
    *
    * SPDX-FileCopyrightText: (c) 2020 Datraverse B.V. <info@datraverse.com>
    * SPDX-License-Identifier: CC-BY-SA-4.0
    *
    * For more information, please contact Datraverse B.V. at this
    * address: info@datraverse.com
    */

.. _app-ipp-ext-localization:

IPP Localization
----------------

User interface localization of regular IPP attributes and 
:ref:`Internal IPP Extensions <app-ipp-ext-internal>` are part of |PRODUCT_NAME|.

Localization of :ref:`External IPP Extensions <app-ipp-ext-external>`
text, and optionally 16x16 pixel icons, must be supplied by XML files in
the ``/opt/savapage/server/custom/cups/i18n`` directory. The default
``ipp-i18n.xml`` file is reserved for the English locale. Variants are
created by appending the language locale to the base file name. For
example: ``ipp-i18n_de.xml`` is the German version.

An annotated ``ipp-i18n.xml.template`` file is available in the target
directory.

See :ref:`Custom Text and Icons <ch-webapp-user-main-printer-settings-print-custom-text-icons>`
for an example screenshot.

.. tip::

   ``ipp-i18n*.xml`` files can also be used to override IPP localization
   that is part of |PRODUCT_NAME|.

.. warning::

   After creating or updating any of the ``ipp-i18n*.xml`` files you
   might need to restart the server to see the effect.