Adding a localized name table ↩

• Introduction
  • Name records
• Name record values
  • Name ID
  • Platform ID
  • Encoding ID
  • Language ID
• Adding name records with the Font Info sheet
• Adding name records with a script

Introduction

OpenTypeAn extension to the TrueType sfnt font format that allows for either TrueType or Postscript outlines to be used.

OpenType fonts can include layout tables for advanced typographic features, color font formats, and variations. The format is developed jointly by Microsoft and Adobe. fonts consist of several tables. The name table is where textual information about the font – such as font names, copyright notice, description, sample strings etc. – is stored. The font maker can supply this kind of information in multiple languages, so that for example German users are presented with texts in German, French users with texts in French, etc.

• Naming table (OpenType Specification)
• OpenType Name Table Fields (UFO3 Specification)

Name records

Translations of any name table attribute can be added using name records.

In UFO fonts, name records are stored as dictionaries with the following format:

Records should have a unique combination of nameID, platformID, encodingID and languageID. In cases where a duplicate is found, the last occurrence of the nameID, platformID, encodingID and languageID combination is taken as the value.

• Name Record Format (UFO3 Specification)

Name record values

This section gives an overview of the possible values for name, platform, encoding and language IDs.

Name ID

Name IDs identify specific kinds of data stored in the OpenType name table.

The following table maps each name ID to its corresponding UFO info.plist attribute, where the default value can be found.

• name IDs (OpenType Specification)
• Name Record Format (UFO3 Specification)

Platform ID

Platform IDs identify the platform to which the name records applies.

• platform IDs (OpenType Specification)

Encoding ID

Encoding IDs are platform-specific: the meaning of each value depends on the current platform ID.

These are the recommended values for Mac and Windows platforms:

• encoding ID (Mac)
• encoding ID (Windows)

Language ID

Language IDs identify the language in which a particular string is written.

The list of languages IDs is extensive, and depends on the platform ID. Please see the OpenType specification for all supported languages and their IDs:

• language ID (Mac)
• language ID (Windows)

Adding name records with the Font Info sheet

Name records can be edited manually in the OpenType section of the Font Info sheet.

Click on the plus button to add a new name record, and fill in the cells with the required data.

Use the minus button to remove the selected name records.

Adding name records with a script

The following example shows how to add name records with a script.

nameRecords = [
  {
    "nameID"     : 19, # openTypeNameSampleText
    "platformID" : 1,  # Mac
    "encodingID" : 0,  # Roman
    "languageID" : 1,  # French
    "string"     : 'Voix ambiguë d’un cœur qui au zéphyr préfère les jattes de kiwi ',
  },
  {
    "nameID"     : 19, # openTypeNameSampleText
    "platformID" : 3,  # Windows
    "encodingID" : 1,  # Unicode
    "languageID" : 1,  # French
    "string"     : 'Voix ambiguë d’un cœur qui au zéphyr préfère les jattes de kiwi ',
  },
  {
    "nameID"     : 19, # openTypeNameSampleText
    "platformID" : 1,  # Mac
    "encodingID" : 0,  # Roman
    "languageID" : 2,  # German
    "string"     : 'Victor jagt zwölf Boxkämpfer quer über den großen Sylter Deich.',
  },
  {
    "nameID"     : 19, # openTypeNameSampleText
    "platformID" : 3,  # Windows
    "encodingID" : 1,  # Unicode
    "languageID" : 2,  # German
    "string"     : 'Victor jagt zwölf Boxkämpfer quer über den großen Sylter Deich.',
  },
  {
    "nameID"     : 19, # openTypeNameSampleText
    "platformID" : 1,  # Mac
    "encodingID" : 0,  # Roman
    "languageID" : 6,  # Spanish
    "string"     : 'Benjamín pidió una bebida de kiwi y fresa; Noé, sin vergüenza, la más exquisita champaña del menú.',
  },
  {
    "nameID"     : 19, # openTypeNameSampleText
    "platformID" : 3,  # Windows
    "encodingID" : 1,  # Unicode
    "languageID" : 6,  # Spanish
    "string"     : 'Benjamín pidió una bebida de kiwi y fresa; Noé, sin vergüenza, la más exquisita champaña del menú.',
  },
]

f = CurrentFont()
f.info.openTypeNameRecords = nameRecords