|
1 | 1 | ---
|
2 | 2 | title: Understanding and configuring the publishing page transformation model
|
3 | 3 | description: Provides detailed guidance on how to configure and use the publishing page transformation model
|
4 |
| -ms.date: 09/11/2019 |
| 4 | +ms.date: 11/04/2019 |
5 | 5 | ms.prod: sharepoint
|
6 | 6 | localization_priority: Normal
|
7 | 7 | ---
|
@@ -82,13 +82,16 @@ Upcoming chapters will provide more details.
|
82 | 82 | Let's analyze how a page layout mapping is configured in the page layout mapping model, which is best done based upon a sample definition:
|
83 | 83 |
|
84 | 84 | ```Xml
|
85 |
| - <PageLayout Name="MyPageLayout" AlsoAppliesTo="MyOtherPageLayout;MyOtherPageLayout2" AssociatedContentType="CustomPage1" PageLayoutTemplate="AutoDetect" PageHeader="Custom"> |
| 85 | + <PageLayout Name="MyPageLayout" AlsoAppliesTo="MyOtherPageLayout;MyOtherPageLayout2" AssociatedContentType="CustomPage1" PageLayoutTemplate="AutoDetect" IncludeVerticalColumn="true" PageHeader="Custom"> |
| 86 | + <SectionEmphasis VerticalColumnEmphasis="Soft"> |
| 87 | + <Section Row="3" Emphasis="Neutral" /> |
| 88 | + </SectionEmphasis> |
86 | 89 | <Header Type="FullWidthImage" Alignment="Left" ShowPublishedDate="true">
|
87 | 90 | <Field Name="PublishingRollupImage;PublishingPageImage" HeaderProperty="ImageServerRelativeUrl" Functions="ToImageUrl({@name})" />
|
88 | 91 | <Field Name="ArticleByLine" HeaderProperty="TopicHeader" Functions=""/>
|
89 | 92 | <Field Name="PublishingContact" HeaderProperty="Authors" Functions="ToAuthors({PublishingContact})"/>
|
90 | 93 | </Header>
|
91 |
| - <MetaData ShowPageProperties="true" PagePropertiesRow="1" PagePropertiesColumn="3" PagePropertiesOrder="1"> |
| 94 | + <MetaData ShowPageProperties="true" PagePropertiesRow="1" PagePropertiesColumn="4" PagePropertiesOrder="1"> |
92 | 95 | <Field Name="PublishingContactName;PublishingContactEmail" TargetFieldName="MyPageContact" Functions="" />
|
93 | 96 | <Field Name="MyCategory" TargetFieldName="Category" Functions="" ShowInPageProperties="true" />
|
94 | 97 | </MetaData>
|
@@ -131,10 +134,26 @@ The following properties are used on the PageLayout element:
|
131 | 134 | - **AlsoAppliesTo**: when this mapping will be used for multiple page layouts then you can specify the names of those additional page layouts as a semi colon delimited list in this attribute. The **Name** property will be name of the first page layout, the **AlsoAppliesTo** just contains the additional ones.
|
132 | 135 | - **AssociatedContentType**: the name of the modern site page content type you want use. Leave this blank if you want to use the default site page content type.
|
133 | 136 | - **PageLayoutTemplate**: the layout system to use...defaults to `AutoDetect` which should work fine in all cases, but optionally you can pick a specific wiki layout as well.
|
| 137 | +- **IncludeVerticalColumn**: optional element to specify the created target page should have a vertical column. When using a vertical column you target the vertical column as an extra column, so if you before adding a vertical column had 3 columns you'll now have 4 and as such you can set the column value of page content to 4 to put it in the vertical column. |
134 | 138 | - **PageHeader**: controls the type of page header that will be used. Defaults to `Custom` as that allows for a nice header, but you can switch it to `None` for no header or `Default` for the default modern page header.
|
135 | 139 |
|
136 | 140 | > [!Note]
|
137 |
| -> - The **AlsoAppliesTo** attribute was introduced in the September 2019 release |
| 141 | +> - The **AlsoAppliesTo** attribute was introduced in the September 2019 release |
| 142 | +> - The **IncludeVerticalColumn** attribute was introduced in the November 2019 release |
| 143 | +
|
| 144 | +### SectionEmphasis element |
| 145 | + |
| 146 | +The following properties are used on the optional SectionEmphasis element: |
| 147 | + |
| 148 | +- **VerticalColumnEmphasis**: use this property to set the vertical column emphasis to None, Neutral, Soft or Strong |
| 149 | + |
| 150 | +For each section you optionally can specify a section emphasis via the Section element: |
| 151 | + |
| 152 | +- **Row**: indicates the row number of this section, first section will have number 1 |
| 153 | +- **Emphasis**: sets the section emphasis to None, Neutral, Soft or Strong |
| 154 | + |
| 155 | +> [!Note] |
| 156 | +> The **SectionEmphasis** element was introduced in the November 2019 release |
138 | 157 |
|
139 | 158 | ### Header element
|
140 | 159 |
|
|
0 commit comments