HorizonPaper2 문서 원본 보기 | 읽기역사 보기 | 문서토론 여기를 가리키는 문서 가리키는 글의 최근 바뀜 문서 정보 새로 고침 ← HorizonPaper2 분류: 문서 편집 권한이 없습니다. 다음 이유를 확인해주세요: 요청한 명령은 다음 권한을 가진 사용자에게 제한됩니다: 사용자. 문서의 원본을 보거나 복사할 수 있습니다. '''HorizonPaper2'''는 [[플레이시티 위키]]에서 사용하는 MediaWiki 스킨이다. 플레이시티의 Horizon Paper 디자인 시스템을 위키 화면에 맞게 적용한 자체 개발 스킨으로, 데스크톱과 모바일 화면을 하나의 반응형 레이아웃으로 처리한다.<ref>MediaWiki에서 스킨은 사이트의 외형과 사용자 인터페이스를 구성하는 요소이다. [https://www.mediawiki.org/wiki/Manual:Skins MediaWiki Manual:Skins]</ref> 2026년 5월 31일 기준 플레이시티 위키의 기본 스킨으로 설정되어 있다. {|class="wikitable" style="width:100%;" !항목 !내용 |- |이름 |HorizonPaper2 |- |내부 스킨 키 |<code>horizonpaper2</code> |- |버전 |1.0.0 |- |라이선스 |GPL-2.0-or-later |- |요구 버전 |MediaWiki 1.43 이상 |- |구현 방식 |<code>SkinMustache</code>, Mustache 템플릿, ResourceLoader 모듈 |- |현재 기본 테마 |자동(<code>auto</code>) |} == 구조 == HorizonPaper2는 <code>SkinMustache</code>를 확장한 PHP 스킨 클래스를 통해 템플릿 데이터를 만들고, Mustache 템플릿으로 본문 레이아웃을 렌더링한다. 기본 본문 템플릿은 <code>skin.mustache</code>이며, 헤더, 사이드바, 목차, 푸터는 별도 partial 템플릿으로 분리되어 있다. MediaWiki의 스킨 개발 문서에서도 Mustache 템플릿과 partial을 이용해 데이터와 표현을 분리하는 방식을 안내한다.<ref>[https://www.mediawiki.org/wiki/Manual:How_to_make_a_MediaWiki_skin/en Manual:How to make a MediaWiki skin]</ref> ResourceLoader 모듈은 기본 스타일, RTL 보정, 코드 표시 보정, JavaScript, 아이콘 초기화 모듈로 나뉜다. PHP 훅은 화면 출력 전 리소스와 메타 정보를 추가하고, 사용자 메뉴와 문서 도구를 재배치하며, 환경설정에 스킨 테마 관련 옵션을 등록한다. == 화면 구성 == 데스크톱 화면은 상단 고정 헤더, 본문 영역, 우측 레일, 푸터로 구성된다. 헤더에는 로고, 검색, 최근 바뀜, 임의 문서, 특수 문서, 파일 올리기, 사용자 메뉴, 테마 선택기가 배치된다. 문서 제목 행에는 공유 버튼, 읽기·편집·역사 등의 기본 문서 동작, 문서 정보와 새로고침 등 추가 도구가 표시된다. 우측 레일에는 최근 바뀜 위젯, 광고 영역, 탐색 위젯이 배치된다. 모바일 화면에서는 로고와 주요 도구를 상단에 두고, 검색을 별도 행으로 분리한 2단 헤더를 사용한다. == 주요 기능 == * '''반응형 레이아웃''': 스킨 자체가 반응형으로 동작하며, 데스크톱과 모바일을 별도 스킨으로 나누지 않는다. * '''테마''': 라이트, 다크, 자동, 색각 배려, 흑백 고대비 계열 테마를 지원한다. 로그인 사용자는 헤더 색상, 배경 색상, 로고 표시 방식을 사용자 정의 테마로 저장할 수 있다. * '''검색 보조''': MediaWiki API를 이용해 검색 제안을 표시하며, 한글 초성 입력을 일부 확장해 검색 후보를 요청한다. 키보드 방향키와 Enter 이동도 처리한다. * '''최근 바뀜 위젯''': 우측 레일에서 일반 문서 이름공간의 최근 바뀜을 불러오고, 동일 문서의 중복 항목을 줄여 표시한다. 위젯 결과는 브라우저 저장소에 캐시되며 주기적으로 갱신된다. * '''목차와 이동 도구''': 문서 목차가 있는 일반 문서에서는 목차 데이터를 활용하고, 데스크톱에서는 문단 위치를 나타내는 점형 빠른 이동 도구를 제공한다. * '''공유''': 문서의 전체 URL과 축약 URL을 복사하거나 이메일로 보낼 수 있는 공유 모달을 제공한다. * '''표시 보정''': 표, 코드 블록, 이미지, 최근 바뀜, 로그인 화면 등에 별도 스타일을 적용해 Horizon Paper 디자인 시스템의 간결한 문서 화면을 유지한다. * '''광고와 분석''': 설정 값이 있을 때 AdSense 슬롯과 Google Analytics 연동을 활성화한다. 특수 문서와 편집·역사 등 읽기 외 동작에서는 AdSense 영역을 비활성화한다. == 운영상 유의사항 == 스킨의 공개 이름과 내부 스킨 키는 HorizonPaper2와 <code>horizonpaper2</code>이지만, 일부 PHP 네임스페이스와 메시지 키에는 이전 개발명인 <code>HorizonWikiTest</code> 또는 <code>horizonwikitest-</code> 접두사가 남아 있다. 문서나 설정을 갱신할 때에는 화면에 노출되는 이름과 내부 구현명이 다를 수 있음을 구분해야 한다. 테마의 기본값은 현재 <code>auto</code>이며, 컴팩트 모드는 꺼져 있고 기본 로고와 파비콘을 사용한다. 광고, 분석, CDN 프리커넥트, 사용자 정의 로고와 파비콘은 별도 설정 값이 있을 때만 실제로 동작한다. == 관련 문서 == * [[플레이시티 위키]] * [[MediaWiki]] * [[특수:환경설정]] == 각주 == <references /> == 외부 링크 == * [https://www.mediawiki.org/wiki/Manual:Skins MediaWiki Manual:Skins] * [https://www.mediawiki.org/wiki/Manual:How_to_make_a_MediaWiki_skin/en Manual:How to make a MediaWiki skin] [[분류:플레이시티 위키 스킨]] HorizonPaper2 문서로 돌아갑니다. 분류
