도움말:캐스케이딩 스타일 시트
| 이 문서는 한국어 위키백과의 정보문입니다. 이 문서는 정책과 지침은 아니지만, 위키백과의 규범과 관습 측면에서 공동체의 확립된 관행을 설명하고 있습니다. 공동체의 총의나 검토를 어느 정도 반영하고 있습니다. |
캐스케이딩 스타일 시트는 페이지를 유연하게 서식 지정할 수 있도록 한다. 가능한 한 표 대신 비표 형식 콘텐츠에 사용해야 하는데, CSS가 틀을 통해 다른 페이지에 포함되어 있으면 독자가 조작하거나 작성자가 덮어쓸 수 있기 때문이다.
CSS 설정의 수준
[편집]콘텐츠의 특정 부분에 대해 스타일을 선택할 수 있다. 예를 들어 색상; 매개변수 범위를 참고한다.
또는 CSS 선택자에 대해 스타일이 지정되며, 이는 요소, 클래스 및 ID 측면에서 표현된다. 이는 다양한 수준에서 이루어진다.
다음 순서로 작성자 스타일 시트가 적용된다.
미디어위키 핵심 스타일 시트
[편집]스킨별: 미디어위키 매뉴얼: 사용자 스타일 갤러리 등 일반적으로 로드되는 스타일 시트:
- 스킨별 주 파일
예: monobook/main.css (PC용 일반 스킨), chick/main.css (휴대용 기기용 일반 스킨)
- 브라우저별 수정 (스킨별)
모노북 예시:
사이트 전체 스타일 시트
[편집]- 모든 스킨용 사이트 전체 (데스크톱 보기만 해당): MediaWiki:Common.css
- 모든 스킨용 사이트 전체 (모바일 보기만 해당): MediaWiki:Mobile.css
- 스킨별 사이트 전체: MediaWiki:Vector.css, MediaWiki:Monobook.css 등
- 사용자 그룹별 사이트 전체: MediaWiki:Group-user.css, MediaWiki:Group-autoconfirmed.css 등
- 전문 목적용 사이트 전체: MediaWiki:Print.css, MediaWiki:Noscript.css, MediaWiki:Filepage.css
- 가젯 로드 시 사이트 전체: 자세한 정보는 Wikipedia:Gadget 참조
참고: 영어 위키백과 외의 미디어위키 사이트는 MediaWiki:Common.css 대신 MediaWiki:Gadget-site.css를 사용할 수 있다.
페이지별 스타일 시트
[편집]페이지별 스타일 시트는 틀 스타일을 통해 도입될 수 있다. 페이지, 특히 틀은 인라인 CSS를 가질 수도 있다.
일부 페이지는 자체 CSS를 가지고 있다. 예: MediaWiki:FileUploadWizard.css
사용자별 스타일 시트
[편집]- 모든 스킨용 전역 사용자별: meta:Special:MyPage/global.css
- 모든 스킨용 사용자별: Special:MyPage/common.css
- 스킨별 사용자별: 예: Special:MyPage/vector.css 또는 현재 스킨용 Special:MyPage/skin.css
- 자바스크립트를 통해 로드되는 사용자별 CSS. 예: Special:MyPage/common.js에 로드됨
- 사용자별 웹 전체 브라우저 설정: 브라우저 설정에서 참조되는 로컬 파일 또는 브라우저에 직접 설정
CSS 용어에서 사용자별 스타일 시트는 사용자 스타일 시트가 아님에 유의한다.
사용법
[편집]HTML 요소는 위키텍스트에서 바로 가져올 수 있다(위키텍스트 내 HTML 참조). 예를 들어 span 태그 또는 위키텍스트 번역의 결과로 생성될 수 있다. 예: '''...''' 코드는 <b>...</b>로 변경되거나 스킨 코드의 일부가 된다.
클래스는 소프트웨어에 의해 생성될 수 있다. 예를 들어 HTML 요소 "body"에 대한 ns-네임스페이스 번호, 페이지 본문의 인터위키 링크에 대한 extiw, 또는 위키텍스트에서 가져올 수 있다.
마찬가지로 ID는 소프트웨어에 의해 생성될 수 있다. 예를 들어 bodyContent, 또는 위키텍스트에서 가져올 수 있다.
콘텐츠에 대한 스타일 설정이 충돌하는 경우, 결과 설정은 주로 "!important" 지시에 따라 달라진다. 다음으로 둘 다 중요한 경우 사용자가 이기고, 둘 다 중요하지 않은 경우 작성자가 이긴다. 세 번째로 특이도에 따라 달라진다. 마지막으로 스타일 시트 간 및 스타일 시트 내의 순서에 따라 달라진다. 마지막이 이긴다. 따라서 User:username/monobook.css는 MediaWiki:Monobook.css(둘 다 작성자이고 사용자가 아님)의 특이도가 더 크면 이기지 못한다. 또한 캐스케이드를 참조한다.
지원되는 요소
[편집]미디어위키는 url() 속성 등 일부 예외를 제외하고 대부분의 CSS를 지원한다. 초기 버전에서는 CSS 지원에 일부 버그가 있었다.
위키텍스트 내 CSS
[편집]일반 HTML 마크업에서처럼 코드의 HTML 요소에 CSS 스타일링을 사용할 수 있다(위키텍스트 내 HTML에서 미디어위키가 지원하는 요소 목록을 참조한다).
예를 들어, 녹색 테두리와 내용이 오른쪽으로 떠 있는 <div>...</div> 요소는 다음과 같이 생성된다.
<div style="float:right; border:thin solid green;">
여기에 짧은 단락이 있습니다.<br />
"div" 요소에 포함되어 있으며<br />
오른쪽으로 떠 있습니다.
</div>
여기에 짧은 단락이 있습니다.
"div" 요소에 포함되어 있으며
오른쪽으로 떠 있습니다.
이는 오른쪽에 상자를 생성한다. 일부 위키텍스트 요소는 CSS 스타일링을 직접 삽입할 수 있도록 한다. 예를 들어 테이블 문법이 있다.
{| style="your style here"
|-
|your table stuff
|}
미디어위키 기존 스타일
[편집]미디어위키 또는 방문하는 사이트에서 이미 정의된 스타일 유형을 사용하고 싶을 수 있다. 또한 페이지에 고유한 스타일을 만들 수도 있다.
벡터는 기본 스타일이며, MediaWiki:Vector.css에서 볼 수 있다.
기존 "클래스"를 CSS 태그에 부여할 것이다.
팁과 요령
[편집]비표시
[편집]포함된 페이지에서 한 버전에서는 주석을 숨기고 다른 보기에서는 표시할 수 있다. 텍스트에 대한 극단적인 "스타일" 중 하나는 다음과 같이 표시하지 않는 것이다.
.classname {display: none}
#id {display: none}
등.
표시되지 않는 링크는 작동하지 않는다(매우 작은 글꼴의 링크와는 대조적으로).
템플릿 이름, 매개변수 이름, 매개변수 값, 링크의 페이지 이름 등 표현식에서 텍스트를 제거하는 데 사용할 수 없다.
숨겨진 텍스트를 보려면 파이어폭스용 웹 개발자 도구 모음을 여기에서 다운로드한 다음, 해당 도구 모음에서 기타 → 숨겨진 요소 표시를 선택한다. 모든 숨겨진 요소가 나타난다.
비인쇄
[편집]"noprint" 클래스로 콘텐츠를 선언하여 인쇄되지 않도록 제외할 수 있다.
<div class="someclass noprint">이것은 인쇄 버전에 나타나지 않습니다.</div>
주요 스타일 블록
[편집]
- column-content – 콘텐츠가 존재하는 여백 내의 전체 공간.
- firstHeading – 모든 페이지 상단의 제목 태그의 클래스
- contentSub – 본문 바로 아래에 있지만 본문 위에 있는 위키의 이름
- content – 기본 페이지 콘텐츠를 포함하는 흰색 배경의 얇은 테두리 상자.
- bodyContent – 콘텐츠 상자 내의 기본 페이지 콘텐츠
portlet 클래스는 기본 콘텐츠 주변의 모든 div 블록에서 사용되는 스타일이다. 해당 클래스를 사용하는 식별된 블록:
- p-cactions – 기본 콘텐츠 위에 있는 페이지 관련 탭 목록(페이지, 토론, 편집 등)의 ID, 상단.
- p-personal – 기본 콘텐츠 위에 있는 사용자 관련 링크 목록(사용자 이름, 토론 등)의 ID, 상단.
- p-logo – 로고를 포함하는 블록의 ID, 왼쪽 상단.
- p-navigation – 페이지 왼쪽에 있는 탐색 링크를 포함하는 블록의 ID
- p-search – 검색 버튼을 포함하는 블록
- p-tb – 도구 상자 링크를 포함하는 블록
- p-lang – 언어 간 링크를 포함하는 블록
페이지 하단의 푸터에는 다음 ID를 가진 블록이 포함된다.
- footer – 전체 푸터 컨테이너 블록
- f-poweredbyico – 일반적으로 페이지 오른쪽에 있는 "Powered by MediaWiki" 이미지
- f-list – 페이지 하단에 있는 모든 텍스트 조각을 포함하는 목록의 ID
매개변수 또는 변수에 따른 스타일
[편집]변수 클래스 또는 ID
[편집]클래스 또는 ID는 템플릿이 생성한 결과나 템플릿 매개변수에 따라 달라질 수 있다. 예: class="abc{{{1|def}}}". 가능한 클래스 이름 중 하나 이상에 대해 해당 클래스의 스타일을 정의할 수 있다. 클래스가 정의되지 않으면 무시되므로 표준 스타일이 사용된다.
가장 간단한 경우, 예: class="abc{{{1}}}"와 클래스 abcdef를 정의한다. 매개변수 값이 "def"이면 적용된다.
일반적으로 사용되는 페이지가 특정 클래스에 대해 스타일이 정의되어야만 의미가 있다면, 이러한 스타일은 MediaWiki:Common.css 페이지에 지정해야 하며, 이는 덮어쓰지 않는 한 모든 사용자 및 모든 스킨에 적용된다.
변수 스타일 매개변수 값
[편집]<span style="display:{{{3|none}}}">Wed</span>
와 같은 위키텍스트는 매개변수 3이 정의되어 있지만 값이 "none"이 아니면 "Wed"를 표시하고, 매개변수 3이 정의되지 않았거나 "none"이면 아무것도 표시하지 않는다. 매개변수 3의 값이 "none"이 아닌 다른 표시 스타일이면 해당 스타일이 적용된다.
위키 제목
[편집]위키 제목은 다음 기본 CSS를 사용한다.
| 위키 마크업 | HTML | 스타일 |
|---|---|---|
= Heading = | <h1> |
color: #000000; background: none; overflow: hidden; page-break-after: avoid; font-size: 1.8em; font-family: 'Linux Libertine',Georgia,Times,serif; margin-top: 1em; margin-bottom: 0.25em; line-height: 1.3; padding: 0; border-bottom: 1px solid #AAAAAA;
|
== Heading == | <h2> |
color: #000000; background: none; overflow: hidden; page-break-after: avoid; font-size: 1.5em; font-family: 'Linux Libertine',Georgia,Times,serif; margin-top: 1em; margin-bottom: 0.25em; line-height: 1.3; padding: 0; border-bottom: 1px solid #AAAAAA;
|
=== Heading === | <h3> |
color: #000000; background: none; overflow: hidden; page-break-after: avoid; font-size: 1.2em; font-weight: bold; margin-top: 0.3em; margin-bottom: 0; line-height: 1.6; padding-top: 0.5em; padding-bottom: 0;
|
==== Heading ==== | <h4> |
color: #000000; background: none; overflow: hidden; page-break-after: avoid; font-size: 100%; font-weight: bold; margin-top: 0.3em; margin-bottom: 0; line-height: 1.6; padding-top: 0.5em; padding-bottom: 0;
|
===== Heading ===== | <h5> |
color: #000000; background: none; overflow: hidden; page-break-after: avoid; font-size: 100%; font-weight: bold; margin-top: 0.3em; margin-bottom: 0; line-height: 1.6; padding-top: 0.5em; padding-bottom: 0;
|
====== Heading ====== | <h6> |
color: #000000; background: none; overflow: hidden; page-break-after: avoid; font-size: 100%; font-weight: bold; margin-top: 0.3em; margin-bottom: 0; line-height: 1.6; padding-top: 0.5em; padding-bottom: 0;
|
같이 보기
[편집]- Span과 div
- 캐스케이딩 스타일 시트 – CSS 문서
- 위키백과:사용자 정의 – 사용자 이름, 환경 설정, 스킨, 사용자 스크립팅 등도 다룬다.
- 도움말:사용자 스타일 – 접근성 또는 추가 기능 테스트를 위한 스타일 수정.
- 위키백과:틀 스타일 – 템플릿으로 적용할 수 있는 고급 시각적 모양을 위한 스타일 수정.
- 위키백과:CSS 클래스 카탈로그 – 사이트 전체에 전역적으로 정의된 클래스 목록
- 도움말:등폭 코딩 글꼴용 사용자 CSS – 편집 창 및
<code>와 같은 등폭 요소 표시에 모두 사용 - meta:Help:Cascading_style_sheets
- mw:Manual:CSS 및 mw:Manual:Interface/Stylesheets
- mw:Gallery of user styles
- m:Customization:Explaining skins
- mw:Skin projects