템플릿:참조 목록
템플릿 설명서
 | 이 템플릿을 복사하고 다른 Wiki에서 사용하도록 수정하는 방법에 대한 자세한 내용은 이 정보를 참조하십시오. |
 | 이 템플릿은 TemplateStyles를 사용한다. |
이 인용 템플릿은 각주에 대한 형식과 조직적 특징을 제공한다. 그것은 캡슐을 씌운다. <references /> Cite MediaWiki 확장에서 정의한 참조 목록을 표시하기 위해 사용하는 태그 <ref> 태그. 열 너비, 그룹 및 목록 정의 참조의 크기를 지원하는 기능을 추가한다.
매개변수
필수 매개변수가 없으며, 제공되지 않을 경우 목록에 10개 미만의 참조가 있을 경우 단일 열 목록이 생성된다. 참조가 10개 이상인 경우 장치에서 허용하면 너비 30m의 열을 사용한다.
선택적 매개 변수:
- 이름 없는 매개 변수(사용할 경우 첫 번째 매개 변수여야 함): 각 참조 열에 대한 최소 너비(일반적으로 ems) 구문(예:)
30em공백 없이(즉, 없음)30 em) 이는 콜폭을 대체한다는 점에 유의한다. § 구식 매개변수를 참조한다. - refs: List-defined reference와 함께 사용.
- 그룹: 렌더링할 참조의 서브셋을 이름으로 식별한다. 값은 인라인에서 사용되는 값과 일치해야 한다(예:
{{Reflist group=groupname}}그룹 이름으로 모든 참조를 렌더링(그룹 이름)<ref group="groupname">리스트의 스타일을 다르게 하는 다섯 개의 미리 정의된 그룹 이름이 있다. 아래 § 그룹화 참조를 참조하십시오. - liststyle: 참조 목록을 렌더링할 때 사용되는 스타일을 지정하십시오. 기본값은 번호가 매겨진 목록이다. 설정할 경우, 이 설정은 에 의해 설정된 스타일을 재정의한다.
group=그룹 기능에 영향을 주지 않는 매개 변수. 아래 § 목록 스타일을 참조하십시오.
사용법
| 마크업 | 렌더링: |
|---|---|
로렘입숨 로렘 입숨 돌로르 시트 아멧 ==참조={Refbegin}} *참조 1 *참조 2 {{Refend}} | 로렘입숨 로렘 입숨 돌로르 시트 아멧
|
기둥
{{Reflist 30em}} (예를 들어) 표시창 너비가 주어진 경우 가능한 한 많은 열(이 예에서는 최소 30 em의 너비)을 만들도록 브라우저에 지시한다. (지원되는 유니트는 em, ex, in, cm, mm, pt, pc, px 등이 있지만 em은 거의 항상 사용된다.) 숫자와 단위 사이에 공백이 있어서는 안 된다. 퍼센트가 지지되지 않는다.
참조의 일반적인 너비에 적합한 너비를 선택하십시오.
- 자동 열(폭이 지정되지 않은 경우 기본값): 각주가 몇 개만 있는 경우(예: Silver State Arena(23:05, 2012년 12월 28일)를 참조하십시오.
- 30em: 각주에 페이지 너비의 서지학 하위 섹션이 많은 경우: 예: 에볼라 바이러스 질병(02:02, 2018년 1월 12일)을 참조하십시오.
- 20em: 단축 각주를 사용하는 경우, 예를 들어 NBR 224 및 420 클래스(13:32, 2011년 8월 1일)를 참조하십시오.
예
| 마크업 | 렌더링: |
|---|---|
로렘입숨<ref>출처명, 접속일자 등</ref> 로렘 입숨 돌로르 앉는다.<ref>출처명, 접속일자 등</ref> 로렘 입숨 돌로르 앉는다.<ref>출처명, 접속일자 등</ref> 로렘 입숨 돌로르 앉는다.<ref>출처명, 접속일자 등</ref> 로렘 입숨 돌로르 앉는다.<ref>출처명, 접속일자 등</ref> ==Reference=={Reflist 15em}} | |
- 참고 1: 구문
{{Reflist 2}}(예를 들어), 사용 가능한 표시 폭에 관계없이 동일한 폭의 두 열을 지정하는 경우, 사용되지 않으며(모바일 뷰의 경우 비활성화됨) 1을 사용하면 템플릿이 단일 열을 제공하는 반면 2는 30em을 지정한 것으로 간주한다. 더 높은 열 카운트를 사용할 경우, 25em을 지정한 것으로 간주한다. - 참고 2: 브라우저 지원: Internet Explorer 10+, Microsoft Edge, Firefox 2+, Chrome 4+, Safari 3.1+, Opera 11.1+
목록 정의 참조
참조 목록은 다음을 사용하여 {{Reflist}} 내에 정의할 수 있다. refs= 명명된 매개 변수 포함과 마찬가지로 <ref name="...">...</ref> 내부에 있는 요소 <references>...</references> 컨테이너의
예
그룹화된 참조
참조는 (설명 노트, 표 참조 등)을 통해 별도의 섹션으로 그룹화할 수 있다. group=:
<ref group="groupname">
, where groupname (예:) notes 또는 sources그룹 이름은 따옴표로 묶을 필요가 없으며, 그룹 이름에 공백이 포함되어 있으면 따옴표가 필요한 각주 마커와 다르다.
기사에 사용되는 각 그룹은 일치하는 참조 목록을 가지고 있어야 한다.
{{Reflist group=groupname}}
미리 정의된 그룹
각주 마커와 참조 목록의 라벨을 자동으로 다른 스타일로 설정하는 미리 정의된 그룹 이름이 있다. 그러므로, 세팅 {{Reflist group=lower-alpha}} 그룹을 로 설정한다. lower-alpha 그리고 참조 리스트를 낮은 알파벳 문자로 스타일링할 것이다. 일치하는 각주 마커는 다음에 의해 형성될 수 있다. <ref group="lower-alpha">...</ref>. 각주 마커 및 참조 목록에 대한 그룹/라벨 스타일을 설정하는 일련의 템플릿을 사용하면 쉽게 설정할 수 있다.
| 그룹형 | 각주 표식기 템플릿 또는 마크업 | 참조 리스트 템플릿. | 샘플 레이블 |
|---|---|---|---|
| 기본적으로 없음, 선택적으로 | <ref>...</ref> | {{reflist}} | 1 2 3 4 5 6 7 8 9 10 |
{{r}} (내포된 참조의 경우) | |||
{{refn}} (내포된 참조의 경우) | |||
| 하층민 | {{efn}}{{efn-la}} | {{notelist}}{{notelist-la}} | a b c d e g h i j |
| 상부의 | {{efn-ua}} | {{notelist-ua}} | A B C D E F G H I J |
| 하층 계급의 | {{efn-lr}} | {{notelist-lr}} | iii iii 4v vi vi vii 8 ix x |
| 상류 사회의 | {{efn-ur}} | {{notelist-ur}} | I III 4세 VI VIII 8세 |
| 하층민 | {{efn-lg}} | {{notelist-lg}} | α β γ δ ε ζ η θ ι κ |
| 주석을 달다 | {{NoteTag}} | {{NoteFoot}} | 노트 1 노트 2 노트 3 |
리스트 스타일
§ Predefined groups에서 언급한 바와 같이, 목록 스타일링을 자동으로 추가하는 사전 정의된 그룹이 있다. 나열된 템플릿을 사용하는 것이 사용보다 더 편리하다. liststyle=.
참조 목록은 기본적으로 번호가 매겨진 목록이다. 사용 liststyle= 매개변수, 목록 렌더링 방법을 제어할 수 있다. 예를 들어, 사용 liststyle=upper-roman 참고문헌은 소수점 대신 로마 숫자로 표기된다. 매개 변수가 다음에 대해 정의된 유효한 CSS 값을 수락함 list-style-type 아래와 같이
사용할 수 있다. liststyle= 각주 마커와 참조 목록 마커의 라벨이 달라지도록 한다. 이것은 독자들에게 혼란을 줄 수 있으므로 주의해서 사용해야 한다. 예를 들면 다음과 같다.
영상과의 상호 작용
참조 목록의 왼쪽에 이미지가 배치되는 특이한 경우, 일부 브라우저에서 레이아웃 문제가 발생할 수 있다. 열 기능을 사용하면 이를 방지할 수 있다.
기술적 세부사항
글꼴 크기
대부분의 브라우저에서 글꼴 크기는 90%로 줄여야 하지만 Internet Explorer와 다른 브라우저의 경우 100%로 표시될 수 있다.[general 1] 2010년 12월 21일 기준 <references /> 태그는 동일한 글꼴 스타일링을 가지고 있다. 작은 글꼴은 Preferences → Gadgets → Infoboxes, Navboxes 및 Reference 목록과 같은 요소의 작은 글꼴 크기를 비활성화하여 사용할 수 있다.
열에 대한 브라우저 지원
아직 개발 중인 CSS3를 사용하여 다중 컬럼이 생성되므로 다중 컬럼 속성을 적절히 지원하는 브라우저만 {{Reflist}}[general 2][general 3]이(가) 있는 다중 컬럼을 표시하게 된다.
이러한 브라우저는 CSS3 열을 지원한다.
- 모질라 파이어폭스와 같은 도마뱀붙이 기반 브라우저
- Safari 및 Google Chrome과 같은 WebKit 기반 브라우저
- 11.10 버전 이후의 오페라
- Internet Explorer 버전 10 이후 버전
이러한 브라우저는 CSS3 열을 지원하지 않는다.
- 최대 버전 9까지[general 4] Internet Explorer를 포함한 Microsoft Trident 기반 브라우저
- 오페라 버전 11까지
미망인과 고아
기둥의 사용은 과부 및 고아로 귀결될 수 있으며, 기둥 하단의 인용문을 다음 기둥의 맨 위로 분할할 수 있다. MediaWiki:Common.css에는 목록 항목이 열 간에 구분되지 않도록 하는 CSS 규칙이 포함되어 있다. 과부는 하나의 참조만 정의되는 열로 포맷된 참조 목록과 같은 극단적인 상황에서 여전히 나타날 수 있다.
지원 CSS
{{Reflist}}은(는) MediaWiki에서 CSS 규칙을 사용한다.글꼴 크기를 설정하는 Common.css:
div.reflist { font-size: 90%; }
열 너비를 설정할 때 템플릿에 의해 다음 클래스가 할당된다.
.references-column-width
{{column-width}} 템플릿을 사용하여 다음과 같은 CSS 속성을 활용한다.
column-widthCSS3 표준
보기 사용자 정의
CSS를 편집하면 참조 목록의 개인 외관을 사용자 정의할 수 있다. 기본 설정에서 모양 탭을 선택한 다음 선택한 스킨에서 사용자 지정 CSS를 선택하십시오. 편집 및 저장 후 페이지 상단의 지시에 따라 제거하십시오. 위키백과 참조:스킨#사용자 정의(고급 사용자)로 더 많은 도움 요청
글꼴 크기
모든 참조 목록의 글꼴 크기는 기본값은 표준 크기의 90%이다. 변경하려면 다음을 추가하십시오.
올.참고 문헌, .mw-파서-출력 칸막이하다.재목록을 작성하다, .mw-파서-출력 칸막이하다.다시 시작하다 { 글자 크기의: 90%; } 90%를 원하는 크기로 변경하십시오.
기둥
열을 비활성화하려면:
.참조-열 폭 { 기둥 너비: 자동차로 !중요하다; } 기둥 분할기
열 사이에 구분자(규칙)를 추가하려면 다음을 추가하십시오.
.참조-열 폭 { 칼럼 규칙: 1px를 붙이다 실체가 있는 #aaa; } 값을 변경하여 분할자의 모양을 변경할 수 있다.
다년생 제안
접기 및 스크롤
접기 가능 또는 스크롤링 참조 목록에 기능을 추가하라는 요청이 여러 번 있었다. 이러한 요청은 가독성, 접근성, 인쇄 등의 문제로 인해 충족되지 않았다. 해당 지침은 MOS:SCROLL에 있다. 참조 목록이 접힌 상자에 들어 있을 때는 인라인 인용문과 참조 목록 사이의 링크가 작동하지 않는다.
참조 목록을 스크롤 상자에 표시하거나 사용자당 축소하려면 도움말:참조 디스플레이 사용자 정의.
템플리트로 이 작업을 수행하려는 이전 시도에 대한 내용은 Scrollref 및 Refbox에 대한 토론을 참조하십시오.
섹션 제목 포함
다음과 같은 섹션 헤더 마크업을 포함하자는 제안이 있었다. ==References==. 이는 다음과 같은 이유로 볼 수 없다.
- 표준 섹션 이름이 없음 § 및
- 내용을 변환할 경우, 편집하기 위해 템플리트를 혼란스럽게 여는 편집 링크가 작성된다.
사용되지 않는 매개 변수
이 매개변수는 더 이상 사용되지 않는다.
- colwidth: 이름 없는 첫 번째 매개 변수에 대해 열 너비를 지정하는 것과 동일함. 이름 없는 첫 번째 매개 변수로 너비로 대체됨.
- close: 2014년까지 파라미터
close=1같은 페이지에 있는 {{Reflist}}의 여러 가지 용도와 관련된 버그 주변에서 작업할 때 사용하였다. 버그가 고정되었을 때, 이것은 제거되었다. (토크 페이지와 섹션으로 구성된 기타 비기사 페이지에서의 다중 사용은 {{Reflist-talk} 참조.)
지원되지 않는 매개 변수를 사용하는 아티클은 다음 범주에서 추적된다.알 수 없는 매개변수(2)가 있는 참조 목록을 사용하는 페이지.
템플릿 데이터
참조 목록에 대한 템플릿 데이터
이 템플릿은 기사 끝에 각주 목록을 표시하고 추가 형식과 구성 옵션을 제공한다. "Apply changes"를 누르고 VE read 모드로 다시 전환하면 참조 목록이 표시되지 않는다. "게시 페이지"를 누르고 정상 읽기 모드로 다시 전환한 후 변경사항이 적용된 참조 목록이 다시 나타난다(T53146 참조).
| 매개변수 | 설명 | 유형 | 상태 | |
|---|---|---|---|---|
| 열 / 열 너비 | 1 colwidth | 두 가지 모드가 지원됨 첫 번째 모드(사용되지 않음): 참조 목록을 렌더링할 고정 열의 정수. 두 번째 모드: 'em'과 같은 측정의 타이포그래픽 단위가 인식되지 않음, 예를 들어 '33em'과 같이 참조 목록 열의 너비를 지정함, 간격 '33 em'은 인식되지 않음
| 끈 | 선택적 |
| 리스트스타일 | liststyle | 참조 목록이 열거될 때 사용되는 스타일을 지정함. 목록 유형으로 정의된 유효한 CSS 값을 수락함
| 끈 | 선택적 |
| 그룹 | group | 그룹은 표시된 참조를 제한하는 식별자다. 이 매개 변수가 없으면 이 템플릿은 그룹 식별자가 없는 참조만 표시한다. 그룹 식별자를 지정하면 일치하는 그룹 식별자를 가진 참조만 처리된다. 나머지는 혼자 남겨둔다. | 끈 | 선택적 |
| 참조 목록 | refs | 문서에 사용할 명명된 참조를 정의할 수 있는 공간을 제공한다. 이 공간에 정의된 참조는 기사의 어딘가에서 사용되지 않는 한 표시되지 않는다. | 끈 | 선택적 |
제한 사항
목록이 HTML div 태그 안에 있는 경우, 번호 또는 번호가 없는 목록에서 {{#tag:reference}}를 사용하는 다른 템플릿 또는 모듈을 사용하지 마십시오. 예시 및 자세한 내용은 토크 페이지(permalink)를 참조하십시오.
아니오 —{{Reflist}}}- 아니오 — *{{Reflist}}}
- 아니오 — #{{Reflist}}}
예 — {{Reflist}}}
아니오 —{{Reflist}}}
예 — {{Reflist}}}참고 항목
- 위키백과:출처 인용 – 출처 인용에 대한 스타일 가이드
- 위키백과:인용 템플릿 – 참조용 템플릿
- 도움말:짧은 각주
- {{Notelist} 및 {{efn}} – 각주와 함께 사용할 수 있는 템플릿
- {{Refbegin} 및 {{Refend}} – 형식 참조 목록
- T53260 – 편집 지원
<references />다중 열 표시를 설정/해제하는 태그
변형
- {{템플릿 참조 목록}} – 템플릿에 사용할 수 있는 참조 목록 버전
- {{Reflist-talk} 및 {{Source-talk}} – 토크 페이지 섹션 및 기타 메인스페이스가 아닌 페이지에서 사용 가능
참조
- ^ 사용자: 참조:다양한 브라우저의 글꼴 크기 비교를 위한 Edokter/fontest; IE 문제를 해결하기 위해 글꼴 크기를 변경하는 방법에 대한 이전 논의를 참조하십시오.
- ^ "CSS3 Multi-Column Thriller". December 30, 2005. Retrieved November 24, 2006.
- ^ "CSS3 module: Multi-column layout". W3C. December 15, 2005. Retrieved November 24, 2006.
- ^ "CSS Compatibility and Internet Explorer: Multi-column Layout". Microsoft Docs. Microsoft Developer Network. Retrieved 2021-03-19.
