2015-05-01

I was working on SharePoint 2013 pilot project and I need to integrate customized HTML into Master page for this (publishing site). SharePoint 2013 comes up with new feature called “Design Manager” (This feature available only for publishing site). In SharePoint 2010 we have an option to create a customized master page using SharePoint Designer 2010 (in most cases). Design Manager allows us to create a Master Page in SharePoint 2013 from an existing HTML page which has associated graphics, scripts, CSS files, Java Scripts, JQuery etc. In previous versions it required an ASP.NET developer to create dynamic pages, but Design Manager Feature allows designers to create dynamic pages. We can integrate HTML using SharePoint Designer 2013 as well. I have created a HTML which looks like below image (which I am going to convert into Master Page)

Design/Plan your Master Page

Generally, Master page in any technology represents elements which remains same from page to page and associated with master styles, scripts, fonts, images etc. Same concept applies for SharePoint master pages as well. For this project, I wanted to use these amounts of content in master page as all the central style sheets, JavaScripts, images, etcThe content in the below part of the page is what will governed dynamically by SharePoint using a combination of Page Layouts and dynamic content. I will add few more design areas later on into the same master page. I am assuming you have designed/created a stripped down HTML file that has the chrome isolated with the appropriate images, CSS, JavaScript, etc. in folders. I have designed my HTML and the folder structure for this looks like :

Now We are ready to create Master Page in SharePoint 2013. Create a SharePoint 2013 Account I have used cloud based environment to deploy this Master page because its easy and free for the moment. You can download and install the SharePoint 2013 Preview and work locally as well. You can create an account from here to signup for an account. Create Publishing Site Collection Once you are done with your SharePoint 2013 account creation, you are allocated a public facing web site and a collaboration site along with Central Administration area to manage all your site collection and sites. You can use public facing web site as well, but I would recommend to create a separate Publishing Site Collection as Microsoft allows one public facing web site in the current cloud environment. To create it, go to AdminSharePointSite Collection and click on the New Private Site Collection link.

It will allow you to create a  Site Collection using different templates. We will use “Publishing Portal” Template.

Now we have a Publishing Site ready, we can start to customize it with new Master Page. The Default home page will look like this:

How to use Design Manager

You can see two different areas on the default home page. One for Information Architecture and second for Visual Designer. If you click on “Design your site”, this will bring you to SharePoint 2013’s new Design Manager:

Note: You can also reach this screen by clicking on the settings menu at the top right hand of the page and clicking on Design Manager

Map Master Page Directory

Click on 4. Edit Master Pages and you will see a screen like this:

Now we are going to Convert an HTML file to a SharePoint master page (as i said earlier). Click on that link and you will see this dialogue box:

This directory is the folder containing Master Page and Page Layouts as well as their dependent assets (CSS files, scripts, images, etc.). I have already uploaded the folder structure (you can see css, images, and fonts folder in above screen). You can manage this folder by mapping to network drive in Windows.

Note: Upload all your folders and .HTML page at this location

Creating Master Page from HTML

Now we have uploaded our files, we’re going to create a Master Page. how it converts? SharePoint 2013 can take the HTML file and convert it into a ASP.NET Master Page automatically. It will also link the HTML and Master Page together so that if any change happen to HTML file it will sync these changes into the Master Page. This allows designers to now work in their comfort zone with HTML, CSS, JavaScript, etc. Go to the Design Manager. Click on 4. Edit Master Pages and then click on Convert an HTML File to a SharePoint master page. You will see your HTML page over there. Select that page and click on “Insert” button. It will insert master page into Design Manager’s Master pages list.

NOTE: SharePoint 2013 expects your HTML to be XML Compliant. If you have older or non-compliant HTML you will get an error. Fix your file and try again. To preview this page, click on the Master Page. At the bottom of the page you will see a Yellow Box that represents the place holder where dynamic content is going to be inserted. Publish it When you insert HTML page into Master Pages list, it would be in Draft version. We need to publish it otherwise it will not be available in Site Master Page Settings drop down. To publish it, go to Site Settings — Master pages and page layouts and then find your HTML file. Hit the Publish button on the ribbon. Assign it To assign master page, go to Site Settings –> Master Page (under Look and Feel) and select your master page from the drop down list. Your site will now adopt your new look and feel. My page looks like this after publishing it on SharePoint 2013.

About the author 

Kirti Prajapati