FileTemplate

Produces a file name and path using the archive file naming specifiers.

Attributes:

• format

  A required attribute that defines the template with a string of specifiers. The supported specifiers are (NOTE: do not confuse the following table with the specifiers used for MT date tags. There is no relationship between these — any similarities are coincidental. These specifiers are tuned for publishing filenames and paths for various contexts.)

  • %a

    The entry's author's display name passed through the dirify global filter. Example: melody_nelson

  • %-a

    The same as above except using dashes. Example: melody-nelson

  • %b

    For individual archive mappings, this returns the basename of the entry. By default, this is the first thirty characters of an entry dirified with underscores. It can be specified by using the basename field on the edit entry screen. Example: my_summer_vacation

  • %-b

    Same as above but using dashes. Example: my-summer-vacation

  • %c

    The entry's primary category/subcategory path, built using the category basename field. Example: arts_and_entertainment/tv_and_movies

  • %-c

    Same as above but using dashes. Example: arts-and-entertainment/tv-and-movies

  • %C

    The entry's primary category label passed through the dirify global filter. Example: arts_and_entertainment

  • %-C

    Same as above but using dashes. Example: arts-and-entertainment

  • %d

    2-digit day of the month. Example: 09

  • %D

    3-letter language-dependent abbreviation of the week day. Example: Tue

  • %e

    A numeric entry ID padded with leading zeroes to six digits. Example: 000040

  • %E

    The entry's numeric ID. Example: 40

  • %f

    Archive filename with the specified extension. This can be used instead of %b or %i and will do the right thing based on the context. Example: entry_basename.html or index.html

  • %F

    Same as above but without the file extension. Example: filename

  • %h

    2-digit hour on a 24-hour clock with a leading zero if applicable. Example: 09 for 9am, 16 for 4pm

  • %H

    2-digit hour on a 24-hour clock without a leading zero if applicable. Example: 9 for 9am, 16 for 4pm

  • %i

    The setting of the IndexBasename configuration directive with the default file extension appended. Example: index.html

  • %I

    Same as above but without the file extension. Example: index

  • %j

    3-digit day of year, zero-padded. Example: 040

  • %m

    2-digit month, zero-padded. Example: 07

  • %M

    3-letter language-dependent abbreviation of the month. Example: Sep

  • %n

    2-digit minute, zero-padded. Example: 04

  • %s

    2-digit second, zero-padded. Example: 01

  • %x

    File extension with a leading dot (.). If a file extension has not been specified a blank string is returned. Example: .html

  • %y

    4-digit year. Example: 2005

  • %Y

    2-digit year with zero-padding. Example: 05

Example:

    <$mt:FileTemplate format="%y/%m/%f"$>