Text tokens

Text tokens, also known as wildcards or text codes, are codes that you can use as substitutes for information stored in your project, such as titles, composers, and the time and date. This can reduce the risk of mistakes or outdated information appearing in your project.

For example, if you use a token for the title of your project, you can change the project title in the Project Info dialog as often as you want, and the project title in every layout in your project is updated automatically.

Tokens can refer to the project-wide information on the Project page in the Project Info dialog, or to individual Flow pages in the Project Info dialog. Tokens can also refer to the current time and date and the time and date the project was last saved.

Note
  • You can only use text tokens in text frames. You cannot use tokens in text/system text objects.

  • Because flow tokens refer to the first flow on the page, if you want to use tokens that refer to flow information on pages that contain no music, such as title pages, you must specify the flow number. For example, if you use {@flowtitle@} on a title page containing no music frames, the token does not display any information, but {@flow1title@} displays the title of the first flow in your project.

    Similarly, if there are multiple flows on a page, default flow tokens only refer to the first flow. For example, if you have two flows with two titles on the same page, the second title must use the token {@flow2title@}.

The following tokens are available in Dorico:


Table 1. General tokens

Description

Token

Page number

{@page@}

Player list

{@playerlist@}

Player names

{@playernames@}

Layout name

{@layoutname@}



Table 2. Project/Flow-specific information tokens

Field in the Project Info dialog

Token for Project page

Token for Flow pages

Title

{@projecttitle@}

{@flowtitle@}

Subtitle

{@projectsubtitle@}

{@flowsubtitle@}

Dedication

{@projectdedication@}

{@flowdedication@}

Composer

{@projectcomposer@}

{@flowcomposer@}

Arranger

{@projectarranger@}

{@flowarranger@}

Lyricist

{@projectlyricist@}

{@flowlyricist@}

Artist

{@projectartist@}

{@flowartist@}

Copyist

{@projectcopyist@}

{@flowcopyist@}

Publisher

{@projectpublisher@}

{@flowpublisher@}

Editor

{@projecteditor@}

{@floweditor@}

Copyright

{@projectcopyright@}

{@flowcopyright@}

Work number

{@projectworknumber@}

{@flowworknumber@}

Composer dates

{@projectcomposerdates@}

{@flowcomposerdates@}

Composition year

{@projectcompositionyear@}

{@flowcompositionyear@}

Other information

{@projectotherinfo@}

{@flowotherinfo@}


Tip

You can also specify the flow to which you want the token to refer. For example, {@flow2title@}.


Table 3. Time/Date tokens to show when the project was last saved

Time/Date description

Time/Date example

Token

Standard date and time string (locale dependent)

Sun Dec 31 11:10:12 2017

{@projectdate@}

Four-digit year

2017

{@projectdateyear@}

Two-digit year

17

{@projectdateyearshort@}

Full month name (locale dependent)

October

{@projectdatemonth@}

Short month name (locale dependent)

Oct

{@projectdatemonthshort@}

Month as a decimal number, range 1-12

10

{@projectdatemonthnum@}

Full weekday name (locale dependent)

Friday

{@projectdateday@}

Abbreviated weekday name (locale dependent)

Fri

{@projectdatedayshort@}

Day of month as decimal number, range 1-31

24

{@projectdatedaynum@}

ISO8601 date

2017-12-31

{@projectdateymd@}

Month day, year

December 31, 2017

{@projectdatemdy@}

Day month year

31 December 2017

{@projectdatedmy@}

Time representation (locale dependent)

11:10:12

{@projectdatetime@}

Hours:minutes, hour in 24-hour clock range

23:10

{@projectdatetimeHHMM@}

Hours:minutes, hour in 12-hour clock range

11:10

{@projectdatetimeHHMMSS@}

Hour in 24-hour clock range

23

{@projectdatetimehour24@}

Hour in 12-hour clock range

11

{@projectdatetimehour12@}

Minute as decimal number, range 00-59

10

{@projectdatetimeminute@}

Second as decimal number, range 00-59

44

{@projectdatetimesecond@}



Table 4. Time/Date tokens to show the current time and date

Time/Date description

Time/Date example

Token

Standard date and time string (locale dependent)

Sun Dec 31 11:10:12 2017

{@date@}

Four-digit year

2017

{@dateyear@}

Two-digit year

17

{@dateyearshort@}

Full month name (locale dependent)

October

{@datemonth@}

Short month name (locale dependent)

Oct

{@datemonthshort@}

Month as a decimal number, range 1-12

10

{@datemonthnum@}

Full weekday name (locale dependent)

Friday

{@dateday@}

Abbreviated weekday name (locale dependent)

Fri

{@datedayshort@}

Day of month as decimal number, range 1-31

24

{@datedaynum@}

ISO8601 date

2017-12-31

{@dateymd@}

Month day, year

December 31, 2017

{@datemdy@}

Day month year

31 December 2017

{@datedmy@}

Time representation (locale dependent)

11:10:12

{@datetime@}

Hours:minutes, hour in 24-hour clock range

23:10

{@datetimeHHMM@}

Hours:minutes, hour in 12-hour clock range

11:10

{@datetimeHHMMSS@}

Hour in 24-hour clock range

23

{@datetimehour24@}

Hour in 12-hour clock range

11

{@datetimehour12@}

Minute as decimal number, range 00-59

10

{@datetimeminute@}

Second as decimal number, range 00-59

44

{@datetimesecond@}