Skip to content

Commit 65f0cf2

Browse files
committed
Doc updates
1 parent 8a23014 commit 65f0cf2

File tree

3 files changed

+45
-7
lines changed

3 files changed

+45
-7
lines changed

docs/transform/modernize-userinterface-site-pages-api.md

Lines changed: 20 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Page Transformation Functions and Selectors
33
description: Page Transformation Functions and Selectors
4-
ms.date: 09/03/2019
4+
ms.date: 11/04/2019
55
ms.prod: sharepoint
66
localization_priority: Normal
77
---
@@ -283,6 +283,24 @@ Name|Description
283283
Name|Description
284284
:-----|:----------
285285
{ServerRelativeFileName}|New target ___location for the asset if transferred.
286+
### ImageAnchorUrlRewrite
287+
288+
**Description:** Rewrite the image anchor tag url.
289+
290+
**Example:** `ImageAnchorUrlRewrite({Anchor},{ImageUrl},{ServerRelativeFileName})`
291+
292+
#### Input parameters
293+
294+
Name|Description
295+
:-----|:----------
296+
{Anchor}|Original anchor tag fetched from the source image
297+
{ImageUrl}|Original image url
298+
{ServerRelativeFileName}|New image url
299+
#### Output parameters
300+
301+
Name|Description
302+
:-----|:----------
303+
{Anchor}|The url after url rewrite. If the anchor and original image url were the same then the anchor will be set to the new image url
286304
### ExtractWebpartProperties
287305

288306
**Description:** Extracts the client side web part properties so they can be reused.
@@ -594,7 +612,7 @@ Name|Description
594612
{return value}|A formatted preview image url
595613
### ToAuthors
596614

597-
**Description:** Looksup user information for passed user id
615+
**Description:** Looks up user information for passed user id
598616

599617
**Example:** `ToAuthors({PublishingContact})`
600618

docs/transform/modernize-userinterface-site-pages-model-publishing.md

Lines changed: 23 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Understanding and configuring the publishing page transformation model
33
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
55
ms.prod: sharepoint
66
localization_priority: Normal
77
---
@@ -82,13 +82,16 @@ Upcoming chapters will provide more details.
8282
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:
8383

8484
```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>
8689
<Header Type="FullWidthImage" Alignment="Left" ShowPublishedDate="true">
8790
<Field Name="PublishingRollupImage;PublishingPageImage" HeaderProperty="ImageServerRelativeUrl" Functions="ToImageUrl({@name})" />
8891
<Field Name="ArticleByLine" HeaderProperty="TopicHeader" Functions=""/>
8992
<Field Name="PublishingContact" HeaderProperty="Authors" Functions="ToAuthors({PublishingContact})"/>
9093
</Header>
91-
<MetaData ShowPageProperties="true" PagePropertiesRow="1" PagePropertiesColumn="3" PagePropertiesOrder="1">
94+
<MetaData ShowPageProperties="true" PagePropertiesRow="1" PagePropertiesColumn="4" PagePropertiesOrder="1">
9295
<Field Name="PublishingContactName;PublishingContactEmail" TargetFieldName="MyPageContact" Functions="" />
9396
<Field Name="MyCategory" TargetFieldName="Category" Functions="" ShowInPageProperties="true" />
9497
</MetaData>
@@ -131,10 +134,26 @@ The following properties are used on the PageLayout element:
131134
- **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.
132135
- **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.
133136
- **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.
134138
- **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.
135139

136140
> [!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
138157
139158
### Header element
140159

docs/transform/modernize-userinterface-site-pages-urlmapping.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: URL mapping during cross site page transformation
33
description: Explains how to the default URL mapping works when transforming pages cross site collection + also explains how to use a custom URL mapping file
4-
ms.date: 09/03/2019
4+
ms.date: 11/04/2019
55
ms.prod: sharepoint
66
localization_priority: Priority
77
---
@@ -16,6 +16,7 @@ URL mapping/rewriting applies to the following locations:
1616

1717
- All content ending up as text parts on the modern page (as of May 2019 release)
1818
- SummaryLinks transformation into either text content or the modern QuickLinks web part (as of May 2019 release)
19+
- Anchor tags of images (as of November 2019 release)
1920

2021
## Default URL mapping logic
2122

0 commit comments

Comments
 (0)