How to Translate Images

Overview

There are 3 steps to create translated versions of our resources’ images:

  1. Translate the SVG source file

  2. Export the translated image as a PNG

  3. Commit your changes and open a Pull Request

Initial step: Declare your intent

In accordance with the WAI Translations process, please always declare your intent and wait for reply from WAI team before starting a translation.

Step 1: Translate the SVG source file

When an image from our website can be translated, it is usually provided with an SVG source file.

In general:

What you will need:

Translating the SVG source file:

  1. Duplicate the SVG file and add your language subtag in the filename. Example: bridge.fr.svg

  2. Open the SVG file in your SVG editor.

  3. In Inkscape, select the “Text Tool” on the lateral toolbar (or use the keyboard shortcut T)

  4. Select the text objects and translate them. If necessary, you can slightly adjust the font size to prevent the text from going beyond the frame.

  5. Change the language (dc:language) value of the file, with your language subtag. For example: fr instead of en.

    In Inkscape, you can go to File > Document Properties…. Then, in the “Metadata” tab, change the value of the “Language” field.

  6. Save the SVG file.

Step 2: Export the translated image as a PNG

  1. Export the file as a PNG image, with your language subtag in the middle. Example: bridge.fr.png.\

    In Inkscape, go to File > Export… and make sure:

    • the Export area is “Page” (not “Document”)
    • “PNG” is the selected export format.

    Then click on the “Export” button.

  2. Move the PNG file in the same location as the English version (generally at the root of the content-images/ folder)

Step 3: Commit your changes and open a Pull Request

Include the PNG and the SVG source file.

Back to Top