Font Themes

Font themes define a document's theme fonts as well as additional typefaces and bullet point styles that are made available to users in Microsoft Office via the primedocs ribbon. They are configured per organizational unit and inherited by all child OUs.

Configuration

Font themes are stored as XML in the Font Theme field of the organizational unit.

Example

<FontTheme>
  <MajorFont>Calibri Light</MajorFont>
  <MinorFont>Calibri</MinorFont>
  <Fonts>
    <Font>Arial</Font>
    <Font>Verdana</Font>
  </Fonts>
  <Bullets>
    <CharacterBullet
      translate-DisplayName="Bullets.Arrow"
      TextIndent="0.8"
      TextIndentRelativeToFontSize="18"
      SizeFactor="1.2"
      CharCode="252"
      FontName="Wingdings">
      <Color>
        <ThemeIndex>Accent1</ThemeIndex>
      </Color>
    </CharacterBullet>
    <CharacterBullet
      translate-DisplayName="Bullets.Dash"
      TextIndent="0.8"
      TextIndentRelativeToFontSize="18"
      SizeFactor="1.0"
      CharCode="150"
      FontName="Arial">
      <Color>
        <Hex>000000</Hex>
      </Color>
    </CharacterBullet>
    <ImageBullet TextIndent="0.8" TextIndentRelativeToFontSize="18">
      <Base64Png>iVBORw0KGgoAAAANSUhEUgAAAA8AAAAPCAYAAAA71pVKAAAAAXNSR0IArs4c6Q==</Base64Png>
    </ImageBullet>
  </Bullets>
</FontTheme>

Elements

<MajorFont> and <MinorFont> are the two fonts of the Office / OpenXML font scheme. During document generation, primedocs replaces the existing scheme and writes both values as the latin major and minor font — for Word, PowerPoint and Excel content. How visibly this takes effect depends on whether the content and styles reference the theme fonts: directly assigned fonts are not rewritten. Both values are mandatory; empty values are invalid.

<MajorFont>

The major font of the font scheme (Office theme "Headings" font). It applies to content and styles that reference the "Headings" theme font — typically headings.

<MinorFont>

The minor font of the font scheme (Office theme "Body" font). It applies to content and styles that reference the "Body" theme font — typically body text.

<Fonts> (optional)

A list of additional <Font> elements. These fonts are offered to users via the primedocs ribbon as quick-access options, supplementing the standard Office font list. The major and minor fonts do not appear in this list automatically; to make them available as quick-access options, add them here explicitly.

<Fonts>
  <Font>Consolas</Font>
  <Font>Comic Sans MS</Font>
</Fonts>

<Bullets> (optional)

Defines the bullet point styles offered to users in the primedocs ribbon. The definition provides the selection in the ribbon; existing lists in the document are not reformatted automatically. Two types are supported:

<CharacterBullet>

A bullet defined by a character from a symbol font.

Attribute	Description
translate-DisplayName	Translation key for the bullet name. Use DisplayName for a plain string.
TextIndent	Indent of the bullet text in centimetres.
TextIndentRelativeToFontSize	Font size (pt) at which the TextIndent value applies.
SizeFactor	Scale factor for the bullet character relative to the text font size.
CharCode	Unicode character code of the bullet symbol.
FontName	Font family containing the symbol (e.g. Wingdings, Arial).

The <Color> child element sets the bullet color:

<!-- Use a theme accent color -->
<Color>
  <ThemeIndex>Accent1</ThemeIndex>
</Color>

<!-- Use a fixed hex color -->
<Color>
  <Hex>FF0000</Hex>
</Color>

Valid ThemeIndex values: Dark1, Light1, Dark2, Light2, Accent1–Accent6, Hyperlink, FollowedHyperlink.

<ImageBullet>

A bullet defined by a PNG image encoded as a Base64 string.

Attribute	Description
TextIndent	Indent of the bullet text in centimetres.
TextIndentRelativeToFontSize	Font size (pt) at which the TextIndent value applies.

<ImageBullet TextIndent="0.8" TextIndentRelativeToFontSize="18">
  <Base64Png>iVBORw0KGgo...</Base64Png>
</ImageBullet>

Inheritance

If no font theme is configured on an OU, the configuration from the nearest parent OU that has one is used. To override the parent, define a <FontTheme> element on the child OU.

note

Font and bullet changes take effect the next time a user synchronises primedocs Desktop or refreshes the web client.