The structure of the short and descriptive names of editions is configurable.

More precisely, the edition object contains two automatically computed attributes 'descName' and 'shortName' whose values are used as the descriptive name and short name. These attributes are auto-computed based on templates specified in (new) attributes in the title the edition belongs to. In this way how the names are computed are not only configurable, but they can be different for different titles (as it was in GN3 for pages).

A template is a list of XML elements specifying fixed and variable parts to be put in the name - e.g.

  <var name="editionNumberName"/>

  <text value=" "/>

  <var name="name"/>

specify to insert in the name the value of the variable 'editionNumberName' followed by a space and then the value of the variable 'name'.

To edit editions names

See Configure edition names and Configure edition template names.

About template elements

The possible elements are:

•var: inserts the value of the variable specified by the 'name' attribute (see example above).

•var-date: inserts the value of the date-time variable specified by the 'name' attribute formatted using the formatting string contained in the 'format' attribute - e.g.

  <var-date name="date" format="d"/>

inserts the value of the 'date' variable formatted as a short date according to the current locale (see http://msdn.microsoft.com/en-us/library/az4se3k1 and http://msdn.microsoft.com/en-us/library/8kb3ddd4 for a list of all the possible formatting strings)

•text: inserts the fixed text specified in the 'value' attribute (see example above).

The available variables are:

•titleName: the name of the title the edition belongs to

•date: the edition date-time, empty if the edition is a template

•editionNumberName: the name of the edition number of the edition. Empty if the edition number has the special name '-'.

•name: the edition name. Empty if the edition has the special name '-'.

There are four different templates - that are used to generate the descriptive and short name for normal edition and edition templates. The templates are read from these attributes of the edition's title:

•editionDescName: contains the template used to generate the descriptive name of normal editions. If empty the system uses:

   <var name="titleName"/>

   <text value=" "/>

   <var-date name="date" format="d"/>

   <text value=" "/>

   <var name="editionNumberName"/>

   <text value=" "/>

   <var name="name"/>

i.e. the title name followed by the edition date, edition number name and edition name (all space-separated).

The version without the title name, containing the edition name first, and then the date:

   <var name="name"/>

   <text value=" "/>

   <var-date name="date" format="d"/>

   <text value=" "/>

 

•editionShortName: contains the template used to generate the short name of normal editions. It is used also on the page label. If empty the system uses:

   <var-date name="date" format="d"/>

   <text value=" "/>

   <var name="editionNumberName"/>

   <text value=" "/>

   <var name="name"/>

i.e. the edition date followed by the edition number name and edition name (all space-separated).

•editionTemplateDescName: contains the template used to generate the descriptive name of template editions. If empty the system uses:

  <var name="titleName"/>

  <text value=" Template "/>

  <var name="name"/>

i.e. the title name followed by ' Template ' and edition name.

•editionTemplateShortName: contains the template used to generate the short name of template editions. If empty the system uses:

  <text value="Template "/>

  <var name="name"/>

i.e. 'Template ' followed by the edition name.

Examples of default names for editions in the title 'DH'

•Edition date-time 2/10/2010 at 1:00PM with edition number '-' and name '-': descriptive name 'DH 2/10/2010', short name '2/10/2010'

•Edition date-time 2/10/2010 at 1:00PM with edition number 'First' and name 'MyEdition': descriptive name 'DH 2/10/2010 First MyEdition', short name '2/10/2010 First MyEdition'

•Edition template named 'Base': descriptive name 'DH Template Base', short name 'Template Base'.