PageExcerpt

This tag outputs the contents of the page Excerpt field if one is specified or, if not, an auto-generated excerpt from the page Body field followed by an ellipsis (“…”). If an excerpt is auto-generated also note that any HTML is stripped.

The length of the auto-generated output of this tag can be set in the blog’s Entry Settings.

Attributes

• no_generate (optional; default “0”): When set to 1, the system will not auto-generate an excerpt if the excerpt field of the page is left blank. Instead it will output nothing.

• words (optional; default “40”): Controls the length of the auto-generated Page excerpt. Does not limit the content when the excerpt field contains content.

• convert_breaks (optional; default “0”): When set to 1, the page’s specified text formatting filter will be applied. By default, the text formatting is not applied and the excerpt is published either as input or auto-generated by the system. Note that the filters modifier may be more useful to format this text.

Example

 <mt:PageExcerpt words="100" convert_breaks="1">

Below is a more complex example. This example grabs the EntryExcerpt, but only if one has been manually created in the Excerpt field, then saves it to the excerpt variable. That excerpt variable is then tested

<mt:PageExcerpt no_generate="1" setvar="excerpt">
<mt:If name="excerpt">
    <mt:PageExcerpt>
<mt:Else>
    <mt:PageBody>
</mt:If>