SharePoint 2013으로 업그레이드할 때 발생할 수 있는 브랜딩 문제
적용 대상:
2013 
2016 2019 Subscription Edition SharePoint in Microsoft 365
SharePoint 2013에서는 가볍고 빠르고, 유연한 새 사용자 인터페이스를 도입했습니다. 이 UI는 새 CSS 스타일, 테마 및 마스터 페이지를 사용하여 만들어졌습니다. 이러한 새로운 환경을 사용하려면 새로운 UI로 업그레이드해야 합니다. 그러나 새로운 UI를 지원하기 위한 중대한 변경 때문에 사용자 지정 브랜딩을 사용하는 일부 시나리오에서 업그레이드 계획에 문제가 생길 수 있습니다.
SharePoint 2010 제품에서는 다음 몇 가지 방법 중 하나로 사이트를 브랜딩했을 것입니다.
사이트에 SharePoint의 기본 스타일을 재정의하는 사용자 지정 스타일 시트 적용
사이트에 사용자 지정 테마(THMX 파일) 적용
SharePoint 2013에 포함된 마스터 페이지를 복사한 후 변경
게시 사이트에서 완전히 새로운 사용자 지정 마스터 페이지 만들기. 이러한 게시 가이트에서 사용자 지정 마스터 페이지는 사용자 지정 스타일을 사용하고 사용자 지정 페이지 레이아웃에 의해 참조됩니다.
사이트 모음을 SharePoint 2013으로 업그레이드하는 경우 기본 CSS 스타일, 테마 및 마스터 페이지가 변경되었으므로 이러한 유형의 사용자 지정이 적용되지 않습니다. 대신, 사용자 지정 브랜딩을 다시 만들어야 합니다. 이렇게 하려면 SharePoint 2013에서 사용할 수 있는 새 스타일, 테마 또는 마스터 페이지를 사용한 다음 새로 만든 디자인을 업그레이드된 사이트 모음에 적용해야 합니다.
더 빠르고 좀 더 유연한 사용자 인터페이스를 만들고 이후 업그레이드를 예측 가능하게 하기 위해 기본 SharePoint 스타일, 테마 및 마스터 페이지를 변경해야 했습니다.
따라서 사이트 모음에 사용자 지정 브랜딩이 포함되어 있는 경우 업그레이드하기 전에 먼저 SharePoint 2013 환경에서 사용자 지정 브랜딩을 다시 만들고 테스트할 수 있는 평가 사이트 모음을 만듭니다. 평가 사이트 모음에 대한 자세한 내용은 사이트 모음 업그레이드를 참조하세요.
다음 섹션에서는 SharePoint 2013으로 업그레이드할 때 발생할 수 있는 브랜딩 문제에 대해 설명합니다.
사용자 지정 CSS
SharePoint 2010 제품 사이트에 사용자 지정 브랜딩을 적용하는 가장 일반적인 방법은 기본 SharePoint 스타일을 재정의하는 스타일이 포함된 CSS 파일을 만드는 것입니다.
새로운 UI를 더 빠르고 보다 유연하게 만들기 위해 SharePoint 2013에서는 CSS가 구현되는 방식을 기본적으로 다음과 같이 변경했습니다.
CSS 파일 크기가 감소됩니다.
CSS 선택기의 중첩이 제한됩니다.
가능한 경우 CSS 상속이 사용됩니다.
클래스는 한 위치에서만 정의됩니다.
관련 클래스가 CSS 파일에 그룹화됩니다.
인라인 스타일과 !important 선언은 재정의할 수 없으므로 사용되지 않습니다.
스타일은 일관성 있는 구조와 명명 규칙을 사용합니다.
SharePoint 2013에서 스타일은 일관성 있는 구조와 명명 규칙을 사용합니다.
| NAMING PART | MS- | <FEATURE>- | <NAME> |
|---|---|---|---|
|
설명 |
Microsoft 클래스임을 나타냅니다. |
이 항목이 연결된 기능의 이름이거나 핵심 UI의 일부로 사용되는 경우 "core"입니다. |
제목, 링크 등, 항목을 설명하는 이름 |
SharePoint 2013에서 CSS를 구현하는 방식이 이와 같이 변경되었으므로 업그레이드 시, 사용자 지정 CSS 스타일이 사이트에 적용되지 않습니다. 이 문제를 해결하려면 먼저 평가 사이트 모음을 만들어야 하고 해당 사이트를 재정의해야 하는 새 SharePoint 2013 스타일을 식별할 수 있는 환경으로 사용해야 합니다. 이러한 스타일에 대한 CSS 파일을 만들고 업그레이드된 사이트를 해당 CSS를 적용합니다.
사용자 지정 테마
SharePoint 2010 제품에서 PowerPoint 2010와 같은 Office 프로그램을 사용하여 THMX 파일을 만들 수 있습니다. 그런 후 해당 테마 파일을 SharePoint 2010 제품에 업로드하고 사이트에 테마를 적용할 수 있습니다.
SharePoint 2013의 테마 엔진이 개선되었으므로 테마를 더 빠르고 유연하게 지정할 수 있고, 좀 더 쉽게 업그레이드할 수 있습니다. 테마 모델은 css에서 주석 스타일 태그를 사용하고 사용자가 선택하는 글꼴 및 색 구성표와 같은 매개 변수를 토대로 CSS의 부분을 바꿉니다. SharePoint 2013의 테마는 XML 파일에 의해 정의됩니다.
SPColor.xml 색 값을 변경할 때 어떤 UI 요소가 영향을 받을지 보다 명확하게 알 수 있도록 슬롯에 의미 체계 이름이 있는 색상표를 정의합니다. 또한 테마는 이제 불투명도 설정을 지원합니다.
SPFont.xml은 글꼴 구성표를 정의하고 웹에 적합한 다언어 글꼴 및 웹 글꼴을 지원합니다.
그렇지만 SharePoint 2010 제품에서 SharePoint 2013으로의 THMX 파일 업그레이드는 지원되지 않습니다. SharePoint 2010 제품 사이트에 사용자 지정 테마를 적용한 경우 SharePoint 2013으로 업그레이드할 때 테마 파일은 그대로 유지됩니다. 하지만 사이트에 테마가 더 이상 적용되지 않으면 사이트는 기본 테마로 돌아갑니다.
이 문제를 해결하려면 먼저 평가 사이트 모음을 만든 후 SharePoint 2013의 새로운 테마 기능을 사용하여 테마를 다시 만드세요. 새 테마에 대한 자세한 내용은 MSDN의 다음 문서를 참조하세요.
중요
계속해서 사용자 지정 브랜딩을 사용하려는 경우와 추후 업그레이드 후에도 해당 브랜딩이 작동하게 하려면 테마를 사용하여 디자인을 구현하는 것이 좋습니다. 추후 업데이트를 사용할 수 있는 경우 테마가 업그레이드를 지원하게 됩니다. 테마가 사용자 시나리오에 적합하지 않거나 보다 광범위한 브랜딩이 있어야 하는 경우 게시 사이트와 디자인 관리자를 함께 사용하는 것이 좋습니다. 그러나 사용자 지정 마스터 페이지 및 페이지 레이아웃 구축에 투자하는 경우에는 각 SharePoint 업그레이드 도중 및 이후에 디자인 파일을 재작업하거나 업데이트해야 할 수 있습니다.
SharePoint 2013에 포함된 마스터 페이지 복사 및 변경
SharePoint 2010 제품에서 UI를 부분적으로 사용자 지정하는 일반적인 방법은 SharePoint 2010 제품에 포함된 마스터 페이지를 복사한 후 변경하는 것입니다. 예를 들어 마스터 페이지를 변경하여 기능을 제거하거나 사용자로부터 숨길 수 있습니다.
SharePoint 2010 제품 사이트를 SharePoint 2013으로 업그레이드하면 SharePoint 2013의 기본 마스터 페이지를 사용하도록 마스터 페이지가 다시 설정됩니다. 따라서 업그레이드 후 사이트에 사용자 지정 브랜딩이 표시됩니다. SharePoint 2010 Products에서 만든 사용자 지정 마스터 페이지는 여전히 사이트에 있지만 새 사이트가 예상대로 표시되지 않으므로 새 사이트에 이전 마스터 페이지를 적용하면 안 됩니다.
SharePoint 2013에서 새 UI를 지원하기 위해 기본 마스터 페이지가 변경되었습니다. 따라서 SharePoint 2010 제품에서 만든 마스터 페이지를 SharePoint 2013의 사이트에 적용할 수 없습니다.
이 문제를 해결하려면 먼저 평가용 사이트 모음을 만든 후 SharePoint 2013 사이트에서 마스터 페이지를 만들어야 합니다. 새 마스터 페이지가 예상대로 작동하는지 확인한 후에는 마스터 페이지를 새 사이트 모음으로 이동하고 사이트에 적용합니다. 사이트가 게시 사이트인 경우 디자인 관리자를 사용하여 마스터 페이지를 내보낸 후 디자인 패키지의 일부로 가져올 수 있습니다. 그렇지 않으면 샌드박스 솔루션의 일부로 또는 마스터 페이지 갤러리에 파일을 업로드하여 마스터 페이지를 이동할 수 있습니다.
중요
SharePoint Foundation 2013에서는 게시 사이트를 지원하지 않습니다. 게시 사이트를 사용하려면 SharePoint 2013이 필요합니다.
게시 사이트의 사용자 지정 마스터 페이지
회사 통신 인트라넷 사이트와 같은 완전하게 브랜딩된 사이트를 원하는 경우 완전한 사용자 지정 마스터 페이지 및 사용자 지정 마스터 페이지에 연결된 사용자 지정 페이지 레이아웃이 있는 게시 사이트를 사용합니다.
SharePoint 2010 제품 사이트를 SharePoint 2013으로 업그레이드하면 SharePoint 2013의 기본 마스터 페이지를 사용하도록 마스터 페이지가 다시 설정됩니다. 따라서 업그레이드 후에는 사이트에 사용자 지정 브랜딩이 표시되지 않습니다. SharePoint 2010 제품에서 만든 사용자 지정 마스터 페이지 및 페이지 레이아웃은 여전히 사이트에 있지만 새 사이트가 예상대로 표시되지 않으므로 이전 마스터 페이지를 새 사이트에 적용하면 안 됩니다.
이 문제를 해결하려면 먼저 게시 사이트에 해당하는 평가용 사이트 모음을 만든 후 SharePoint 2013 사이트에서 마스터 페이지를 만들어야 합니다. 새 마스터 페이지가 예상대로 작동하는지 확인한 후 다음 단계를 수행합니다.
마스터 페이지를 디자인 패키지의 일부로 내보냅니다.
디자인 패키지를 새 사이트 모음으로 가져옵니다.
사이트에 새 마스터 페이지를 적용합니다.
사용자 지정 마스터 페이지의 사용자 지정 콘텐츠 자리 표시자
중요
사용자 지정 마스터 페이지에 사용자 지정 콘텐츠 자리 표시자가 포함되어 있고 사용자 지정 페이지 레이아웃에도 이 사용자 지정 콘텐츠 자리 표시자가 포함된 경우 업그레이드 후에 오류로 인해 사이트의 홈페이지가 렌더링되지 않을 수 있습니다. 대신, 업그레이드 후에 "예기치 않은 오류가 발생했습니다."라는 오류 메시지가 표시될 수 있습니다.
이 문제가 있는지 확인하려면 게시 사이트에 해당하는 평가 사이트 모음을 만든 다음 마스터 페이지를 SharePoint 2013에 포함된 마스터 페이지로 설정할 수 있습니다. 사이트가 계속 표시되면 이 문제가 없는 것입니다. 사이트가 표시되지 않고 상관 관계 ID와 함께 "예기치 않은 오류" 메시지가 표시되면 이 문제가 있는 것일 수 있습니다.
이 문제를 해결하려면 다음을 수행합니다.
게시 사이트 모음에 해당하는 평가 사이트 모음을 만듭니다.
SharePoint 2013 마스터 페이지를 만듭니다.
2013 마스터 페이지에 사용자 지정 콘텐츠 자리 표시자를 추가합니다.
사이트에 새 마스터 페이지를 적용합니다.
사용자 지정 콘텐츠 자리 표시자를 포함하지 않는 페이지 레이아웃을 만듭니다.
해당 페이지 레이아웃이 사이트에 적용된 새 마스터 페이지에 연결됩니다.
기존 페이지 레이아웃을 사용하는 모든 페이지를 새 페이지 레이아웃으로 변경합니다.
브라우저에서 수동으로 각 페이지를 따로 편집하고 리본의 옵션을 사용하거나 SharePoint용 클라이언트 쪽 개체 모델을 사용하여 프로그래밍 방식으로 페이지를 업데이트할 수 있습니다.
사용자 지정 콘텐츠 자리 표시자를 포함하지 않는 이전 페이지 레이아웃을 삭제합니다.
사용자 지정 마스터 페이지 또는 페이지 레이아웃에는 사용자 지정 콘텐츠 자리 표시자를 추가하지 않는 것이 좋습니다.
참고 항목
기타 리소스
SharePoint 2013에서 사이트 모음 업그레이드 문제 해결
SharePoint 2013으로 업그레이드된 사이트 모음 검토
Upgrade a site collection to SharePoint 2013