위키백과:템플릿 스타일
Wikipedia:![]() | 이 페이지는 영어 위키백과 편집 지침을 문서화한다. |
TemplateStyles는 인터페이스 관리자가 사이트 전체 CSS를 편집할 필요 없이 사용자 정의 CSS 페이지를 사용하여 콘텐츠를 스타일링할 수 있도록 허용한다.TemplateStyles는 편집자가 템플릿을 스타일링하는 것을 더 편리하게 해준다. 예를 들어, 모바일 피부 또는 다른 피부(예: Timeless)의 사이트 전체 CSS가 현재 템플릿 표시에 부정적인 영향을 미치는 템플릿.
지침
- 스타일은 연관된 템플릿의 출력에만 적용되어야 한다.템플릿이 사용되는 인근 위키텍스트에도 적용될 수 있다. (예를 들어, TemplateStyles가 전체적으로 템플릿으로 제공되어야 하거나 Wikitext 테이블에 범례를 제공할 수 있는 많은 테이블 템플릿이 있다.)그렇지 않으면 페이지의 한 부분에 템플릿을 추가하는 것이 페이지의 관련 없는 부분의 표시나 스타일링을 완전히 또는 부분적으로 변경하는 것이라면 혼란스러울 것이다.
- 스타일 페이지는 특정 템플릿 또는 템플릿 그룹과 연결되어야 하며 그에 따라 이름이 지정되어야 한다.이를 통해 스타일 페이지를 쉽게 식별하고 편집할 수 있다.일반적으로, 이것은 스타일 페이지는 관련 템플릿의 하위 페이지여야 함을 의미한다. 예를 들어:템플릿:/myTemplatestyles.css 또는 myTemplateTemplate:/styles-foo.css가 아닌foo 템플릿:styles-.css 또는 Template:.foocss.
- 일반적으로 CSS에 대한 MediaWiki 코드 규칙을 따른다.몇 가지 세부 사항:
- 사용할 템플릿에 고유할 가능성이 높은 선택기를 사용하십시오.이것은 우발적으로 발생하는 CSS 규칙의 상충 가능성을 감소시킨다.예:.row보다는 .-myTemplaterow, tr보다는 .-myTemplaterow를 사용한다.
- 규칙당 #id를 사용하지 마십시오.HTML ID는 페이지에서 고유해야 한다.템플릿은 거의 고유하게 사용되지 않으며, 처음에 페이지당 1회용인 템플릿은 나중에 예상치 못한 방식으로 사용되는 경우가 많다.스타일링에는 ID 대신 클래스를 사용하십시오.
- 관련 템플릿에서 스타일 입력을 재정의하려면 모바일 뷰를 제외하고 규칙별로 중요!중요를 사용하지 마십시오.의 사용
!important
TemplateStyles에서 스타일 로딩 순서(개인 CSS 다음 TemplateStyles)로 인해 재정의하기가 예외적으로 어렵다.
- 대체되거나 대체될 가능성이 있는 템플릿의 경우 {{ifsubst}}을(를) 사용하여 TemplateStyles 태그를 제거하십시오.예: {{allcaps}}}.
- 대체 템플릿에서 인라인 스타일을 "변위" 케이스로 사용할 수 있다.예: {{smallcaps}}}.
- 귀속성이 필요 없는 영상(즉, 공용 도메인에 있는 영상)은 백그라운드 이미지로 사용할 수 있는 유일한 영상이다.일반적인 파일 사용을 위해 파일 설명 페이지에서 이미지를 클릭하여 액세스한다.이미지를 배경으로 사용하는 경우에는 이 작업이 가능하지 않다.
- 스타일 페이지의 보호 수준은 연관된 템플릿의 보호 수준과 일치해야 한다.템플릿이 고위험인 경우 템플릿 스타일도 고위험이므로 동일한 보호 기능을 가져야 한다.만약 템플릿이 고위험이 아니라면, 템플릿 자체를 편집하는 것만으로 혼란을 야기하는 파괴 행위를 달성할 수 있다.스타일 페이지에 대한 보호 수준이 높을수록 템플릿은 편집할 수 있지만 스타일 페이지는 편집할 수 없기 때문에 편집자가 템플릿에 인라인 스타일을 추가하도록 권장할 수 있다.보호 수준이 잘못된 CSS 페이지를 사용하는 템플릿은 다음 범주에 분류된다.보호 수준이 다른 TemplateStyles를 사용하는 템플릿
- 추가해야 함을 기억
/* {{pp-template}} */
적절한 잠금 아이콘을 표시하기 위해 보호되는 CSS 페이지로 이동하십시오.잠금 아이콘이 없는 CSS 페이지를 사용하는 템플릿은 다음 범주의 범주가 될 것이다.자물쇠가 없는 TemplateStyles를 사용한 템플릿
접근성 지침을 포함한 스타일 매뉴얼이 여전히 적용된다는 점에 유의하십시오.
변환 워크플로우
- 템플릿:myTemplate에서 개별 스타일시트로 이동할 수 있는 모든 인라인 스타일을 식별하십시오.
- 인라인 스타일을 대체할 모든 클래스를 포함하는 템플릿 만들기:/myTemplatestyles.css.가능한 경우 템플릿별 클래스 이름을 사용하십시오.
- 템플릿에서(myTemplate또는 템플릿:/myTemplate샌드박스(먼저 테스트하려는 경우) 추가
<templatestyles src="myTemplate/styles.css" />
(템플릿: 네임스페이스를 지정할 필요가 없음).그것은 아마도 상부에서 가장 좋기 때문에 분명하고 흐트러진 콘텐츠의 섬광을 피할 수 있을 것이지만, 템플릿이 새로운 라인(예: 위키-테이블)에서 시작해야 하는 위키 마크업으로 시작된다면 그것 자체로 줄을 설 필요가 있을 것이다. - 템플릿(또는 샌드박스)을 수정하여 인라인 스타일을 템플릿:/myTemplatestyle.css에서 정의한 클래스로 대체
- 가능한 한 많이 체크해라.샌드박스에서 테스트한 경우 테스트케이스 페이지가 존재하는 곳을 확인할 수 있지만, 특히 영향을 받은 스타일이 제대로 렌더링되는지 확인하십시오.
- 특히 인라인으로 사용하도록 지정된 템플릿의 경우 링크 내부에 용도가 있는지 확인하십시오.TemplateStyles 템플릿은 링크 내부(현재)에서 작동하지 않음
- 샌드박스를 사용한 경우 기본 템플릿에 대한 편집 요청을 하거나 변경 사항을 확신할 경우 업데이트를 수행하십시오.
- 필요에 따라 템플릿:/myTemplatestyle.css의 보호 수준을 템플릿:myTemplate의 보호 수준과 일치하도록 요청하거나 수정하십시오.
- 추가하다
{{Uses TemplateStyles}}
템플릿의 설명서로 이동하여 사용하는 TemplateStyles 스타일시트를 표시하십시오.
팁
- TemplateStyles 스타일시트의 사용은 템플릿횡단 및 Scrippunto 모듈 호출과 마찬가지로 기록된다.특수:WhatLinks여기서 편집 양식 아래의 "이 미리 보기에 사용된 템플릿" 섹션은 일반적인 방식으로 작동한다.
- TemplateStyles 스타일시트를 검색하려면 컨텐츠 모델:sanitized-css를 검색하십시오.참고 항목: mw:도움말:CirrusSearch#Content model.
- 언제
{{Uses TemplateStyles}}
템플릿의 설명서에 배치되어 있으며, 카테고리에 템플릿을 추가한다.TemplateStyles를 사용하는 템플릿.TemplateStyles 스타일시트의 보호 수준이 다른 경우, 템플릿은 Category에서 추적된다.보호 수준이 다른 TemplateStyles를 사용하는 템플릿(0페이지) - TemplateStyles 실험은 Template에서 생성할 수 있다.TemplateStyles 샌드박스(예: 모듈:샌드박스 모듈 실험.
재정의 TemplateStyles
TemplateStyles가 구현되는 방식 때문에 개인 CSS에서 TemplateStyles를 재정의하려면 평소보다 조금 더 많은 노력이 필요하다.특정 TemplateStyles 시트의 규칙은 전체 CSS 규칙이 아니며 선택기를 일치시켜 재정의할 수도 없다.
- 각 선택기를 '호스트'로 설정
.mw-parser-output
TemplateStyles 시트에서 다음과 같은 규칙을 재정의하려면.documentation {}
개인 CSS 파일의 순진한 오버라이드는 다음과 같이 보여야 한다..mw-parser-output .documentation {}
. - 그러나 HTML에서 각 TemplateStyles 스타일은 항상 개인 CSS 파일 로드 후에 배치된다.따라서, 새로운 규칙은 좀 더 구체적일 필요가 있을 것이다.그것은 두 가지 방법으로 올 수 있다.가장 쉬운 방법은 다음과 같이 HTML 요소를 선택하는 것이다.
.mw-parser-output div.documentation {}
다른 방법은 다음과 같이 클래스 선택기를 두 배로 늘리는 것이다..mw-parser-output.mw-parser-output .documentation {}
또는.mw-parser-output .documentation.documentation {}
이 후자의 방법은 좀 더 미래지향적이지만 좀 더 이상해 보인다. - 마지막으로.
!important
개인 CSS의 스타일을 항상 재정의할 수 있다.에 관한 통상적인 주의 사항!important
적용. 가능한 경우 게시판 2의 두 가지 옵션 중 하나를 선호한다. (위의 어떤 옵션이든 상관 없이 인라인 스타일을 재정의하려면 이렇게 해야 한다. 일부 템플릿은 템플릿 사용자에게 주어진 유연성에 따라 TemplateStyles로 모든 것을 이동할 수 없다.템플릿 구현자는 다음과 같은 매개 변수들을 고려해야 한다.style
그리고width
실제로 필요하다.자세한 내용은 다음 페이지를 참조하십시오.T200632).
예
- mw:도움말:TemplateStyles/예시
- 템플릿:온도계 및 템플릿:Temperature/styles.css는 TemplateStyles가 인라인 스타일(하나 이상의 스타일을 변경하기 위해 매개 변수가 전달되는 경우)과 어떻게 혼합될 수 있는지 간단하게 보여 준다.