틀:인용/설명문서

기본 인용 틀
{{웹 인용}}	웹사이트
{{뉴스 인용}}	뉴스 기사
{{서적 인용}}	서적
{{저널 인용}}	학술지
{{백과사전 인용}}	백과사전
{{에피소드 인용}}	라디오·텔레비전 에피소드
{{영상 인용}}	소리·영상
{{영상 설명 인용}}	소리·영상 라이너 노츠
{{지도 인용}}	지도
{{arXiv 인용}}	arXiv 논문
{{인용}}	범용 인용 틀
{{기술보고서 인용}}	기타 틀
{{기술보고서 인용}}	기술 보고서
{{뉴스그룹 인용}}	온라인 뉴스그룹
{{메일링 인용}}	메일링 리스트
{{보고서 인용}}	보고서
{{보도자료 인용}}	보도 자료
{{연설 인용}}	연설
{{인터뷰 인용}}	인터뷰
{{잡지 인용}}	잡지
{{콘퍼런스 인용}}	콘퍼런스
{{팟캐스트 인용}}	팟캐스트
{{표지판 인용}}	표지판·명판
{{학위논문 인용}}	학위 논문
	---- 한국어(ko) 자료를 인용할 때에는 별도의 언어 표시(\| 언어 = )를 할 필요가 없습니다.
	v; t; e;

이 문서는 틀:인용에 대한 설명입니다.
여기에는 틀 사용법, 분류 등 원래의 틀 문서에는 포함되지 않는 내용을 담고 있습니다.

이 틀은 루아를 사용합니다.

모듈:Citation/CS1 (연습장)

이 틀은 5,200개 이상의 문서에서 사용 중인 틀입니다.
이 틀을 수정하면 많은 문서에 영향을 줄 수 있습니다. 기여할 모든 내용은 /연습장이나 /시험장 또는 자신의 사용자 하위 문서에서 사전 점검을 거쳐야 합니다. 이 틀을 수정하기 전에, 먼저 토론 문서에 의견을 구하시는 것이 좋습니다.

인용 틀입니다. 서적이나 정기 간행물, 웹 사이트 등 여러 저작물을 인용할 수 있습니다.

{{웹 인용}}, {{서적 인용}} 등 ‘** 인용’과 같은 형식의 이름을 가진 틀과의 차이점은 대략 다음과 같습니다.

각 내용이 온점(.)이 아니라 쉼표(,)로 계속 이어지며, 틀 맨 마지막에는 온점이 찍히지 않습니다.
{{harv}} 등의 틀 사용 시 {{인용}}은 |ref=가 (일반적으로) 필요 없으나, 다른 틀들은 |ref=harv를 ‘반드시’ 지정해야 합니다.

변수

구조

아래 설명 문서의 변수 구조는 다음과 같으며, 하위 속성은 상위 속성이 있어야만 나타납니다.

상위 속성
또는: 상위 속성 2 — 상위 속성 대신에 사용될 수 있음
- 하위 속성 — 상위 속성과 함께 쓰일 수 있음. 상위 속성이 없다면 무시됨.
- 또는: 하위 속성 2 — 하위 속성 대신에 사용될 수 있음. 상위 속성 2가 없다면 무시됨.

목록에 별칭이 있는 경우, 그 중 하나만을 사용해야 합니다. 여러 개를 사용한 경우 단 하나만이 인식이 되며 나머지는 무시됩니다.

기본적으로 각 항목의 마지막은 쉼표(,)로 끝납니다.

COinS

이 틀은 HTML 결과물에 COinS 메타데이터를 넣어줍니다. 자세한 사항은 (영어) COinS 및 WP:COinS를 참고하세요.

규칙에 따라 한 변수에는 한 가지 내용만이 포함되어야 합니다. (예: |날짜=2007년 9월 27일은 허용되지만 |날짜=2007년 9월 27일 (인쇄판 9월 25일)은 안 됩니다.)

인용 틀 안에 또 다른 틀을 쓰거나 변수 안에  , – 등의 HTML 엔티티를 넣는 것, 또는 '', ''' 등의 위키 문법을 넣는 것 역시 메타데이터를 오염시키므로 사용해서는 안 됩니다.

COinS 메타데이터가 만들어지는 변수 목록

|작품=, |저널=, |뉴스=, |잡지=, |웹사이트=, |백과사전= 등
|장=
|제목=
|위치=, |출판장소=
|날짜=, |연도=, |출판날짜=
|총서=, |시리즈=
|권=, |호=
|쪽=, |쪽기타=
|판=
|출판사=
|url=
|장url=
|저자n=, |성n=, |이름n= 등
|isbn=, |issn=, |doi=, |pmc= 등

미사용 변수

다음 변수들은 더 이상 지원되지 않으므로 사용해서는 안 됩니다. 아래 변수를 사용할 경우 분류:인용 오류 - 오래된 변수를 사용함에 들어갑니다.

공저자, coauthor, coauthors: 성n·이름n이나 저자를 이용하세요.

설명

저자

성: 저자의 성(last name). 위키 링크를 걸려면 저자링크를 사용해야 함. 성·이름을 구분하지 않고 한국 이름과 같은 형식으로 쓰려면 저자만을 이용해야 함. 별칭: 성1, 저자, 저자1.
- 이름: 저자의 이름(first name)이나 명(given name). 위키 링크를 걸려면 저자링크를 사용해야 함. 성을 필요로 하며 성이 비어있을 경우 표시되지 않음. 별칭: 이름1.
- 또는: 여러 명의 저자를 나타내려면 성1, 이름1, … , 성n, 이름n을 이용할 수 있음. n은 무한개 사용할 수 있으며, 각각의 이름n은 성n을 필요로 함. 표기 방식을 바꾸려면 표시 선택 사항 단락을 참조.

저자링크: 위키백과에 존재하는 저자의 문서 이름. 위키 링크를 하지 말 것. 별칭: 저자링크1, 저자1링크.
또는: 여러 명의 저자를 나타내려면 저자링크1부터 저자링크n을 이용할 수 있음.

인물: 저자 여러 명을 자유롭게 기재하는 경우 사용. 저자의 별칭이 아님.
기타: 작품에 기여한 다른 인물을 표기할 때 사용. 예: 홍길동 그림

만약 {{Sfn}}과 같은 틀을 이용할 때 한 변수에 여러 이름을 기재하면 틀이 정상적으로 작동하지 않을 수 있습니다.

편집자

편집자-성: 편집자의 성(last name). 위키 링크를 걸려면 편집자-링크를 사용해야 함. 성·이름을 구분하지 않고 한국 이름과 같은 형식으로 쓰려면 편집자를 이용해야 함. 별칭: 편집자1성, 편집자1-성, 편집자-성1, 편집자.
- 편집자-이름: 저자의 이름(first name)이나 명(given name). 위키 링크를 걸려면 편집자-링크를 사용해야 함. 별칭: 편집자1이름, 편집자1-이름, 편집자-이름1, 편집자이름
- 또는: 여러 명의 편집자를 나타내려면 편집자n-성, 편집자n-이름을 이용할 수 있음. n은 무한개 사용할 수 있으며, 각각의 편집자-이름n은 편집자-성n을 필요로 함.

편집자-링크: 위키백과에 존재하는 편집자의 문서 이름. 위키 링크를 하지 말 것. 별칭: 편집자1-링크
또는: 여러 명의 편집자를 나타내려면 편집자1-링크부터 편집자n-링크를 이용할 수 있음.

번역자 또한 편집자와 동일하게 쓸 수 있습니다.

제목

제목: 위키백과에 존재하는 문서로 위키 링크를 걸거나 url을 추가하여 외부 링크를 만들 수 있음. 단, 두 가지 방법을 동시에 사용해서는 안 됨. 겹화살괄호(《》) 안에 표기됨.
- 번역제목: 출처가 외국어인 경우 한국어로 번역된 제목. 제목 뒤 대괄호([]) 안에 표기되며 url이 있는 경우 제목과 함께 링크 안에 포함됨. 만약 번역제목을 쓸 경우 언어도 같이 쓰는 것이 좋음.

제목에 다음 특정 문자가 포함되면 정상적으로 링크가 생기지 않으므로 표를 참고하여 적절하게 인코딩을 해야합니다.

새 줄	[	]	\|
공백 문자( )	[	]	\|

장: 장(chapter)의 제목. 위키 링크를 직접 걸거나 따로 장url를 쓸 수 있음. 그러나 둘을 동시에 쓸 수는 없음. 따옴표(“”) 사이에 표기됨.
- 번역장: 해당 출처가 외국어인 경우 장 제목의 한국어 번역. 장 다음에 대괄호([]) 안에 표기됨. 장url이 지정된 경우 번역장은 링크에 포함이 됨. 언어를 같이 쓰는 것이 좋음.

종류: 출처의 미디어 종류에 대한 추가적인 정보. 제목 다음 괄호 안에 표기됨. 예: 논문, 소책자, CD 속표지, 보도자료 등. 별칭: 매체

언어: 출처의 언어. 한국어인 경우 쓰지 말 것. 언어의 전체 이름이나 ISO 639 코드를 입력해야 함. 틀을 쓰지 말 것. 여러 언어를 지정해야 하는 경우 |언어=프랑스어, 독일어와 같이 기재함.

날짜

날짜: 출처의 날짜. 전체 날짜(연·월·일) 쓰거나 일부(연, 연·월, 연·계절)를 쓸 수 있음. 같은 연도가 {{sfn}} 등에서 구별되어야 하는 경우(예: 1990a, 1990b) 별도로 날짜를 지정해야 함. 위키 링크를 하지 말 것. 저자 뒤 괄호 안에 표기됨. 저자가 없으면 출판사 뒤에 표기됨.

추정치의 경우 "c. "를 이용하여 |날짜=c. 1900과 같이 표기함. 날짜가 없는 경우 |날짜=n.d.와 같이 표기함.

연도: 출처의 연도.
원본연도: 원래 출판 연도. 연도나 날짜 뒤에 표기됨. 명확한 표현을 위해 다른 표현을 덧붙일 수 있음. 예: |원본연도=1985년 초판, |원본연도=1904년 작곡.

작품

작품: 정기 간행물의 이름. 위키 링크를 걸 수 있음. 겹화살괄호(《》) 안에 표기됨. 표기 방식을 바꾸려면 표시 선택 사항 단락을 참조. 별칭: 저널, 뉴스, 신문, 잡지, 웹사이트
- 호: 간행물이 정기적으로 나오는 시리즈인 경우. 권 바로 다음 괄호 안에 표기됨.

작품작품이 지정된 경우, 아래 변수의 형식이 바뀝니다.

제목이 따옴표 안에 표기됨.

장이 표시되지 않으며 오류 메시지가 나옴.

위치와 출판사가 괄호 안에 표기됨.

쪽에서 ‘쪽’ 표시 없이 숫자만 나옴.

판이 표시되지 않음.

종류가 표시되지 않음.

출판사

출판사: 출판사의 이름. 위키 링크를 걸 수 있음. 출판사란 현재 인용하고 있는 출처를 ‘출판’한 곳을 의미하므로, 해당 작품의 이름을 써서는 안 됨. ‘Ltd’, ‘Inc’,‘GmbH’나 ‘주식회사’, ‘(주)’, ‘㈜’ 등의 표기는 되도록 하지 말아야 함. 작품의 이름을 통해서 출판사의 이름을 바로 알 수 있는 경우에는 쓰지 않는 것이 좋음(예: 《조선일보》를 운영하는 주식회사 조선일보사의 경우 출판사를 별도로 기재할 필요가 없음). 제목 뒤에 표기됨. 만약 작품이 있는 경우 괄호 안에 표기됨.
위치: 해당 항목이 지리적으로 출판된 위치. 되도록 위키 링크를 하지 말 것. 작품에 이미 위치가 포함되어 있을 경우 사용하지 말 것. (예: 《뉴욕 타임스》 등) 제목 뒤에 표기되며, 작품이 있는 경우 괄호 안에 표기됨. 별칭: 장소
출판장소: 위치 또는 출판장소 중 어느 것이라도 값이 있으면 그 값은 제목 뒤에 표기됨. 만약 두 개가 동시에 쓰일 경우 위치는 제목 앞에 ‘...에서 작성’으로 표기되며 출판장소는 제목 뒤에 표기됨.
출판날짜: 출판된 날짜로 작품이 쓰인 날짜와는 다름. 연도 또는 날짜가 지정되어 있고, 그 값과 다를 경우에만 표기됨. 출판날짜가 날짜 없이 쓰인 경우 출판날짜가 날짜를 대신함. 위키 링크를 하지 말 것. 출판사 뒤에 표기되며, 작품이 없는 경우 괄호 안에 ‘...에서 출판됨’으로 표기됨.
경유: 콘텐츠 경유사의 이름. 출판사와는 다름. 원본과는 다른 형식으로 내용을 전달하거나 URL로부터 해당 내용의 원 출판사가 어디인지 확실히 알 수 없는 경우 등에 쓰임. 등록 또는 구독 필요 참고.

판, 총서, 권

판: 출판물이 여러 판을 가지고 있을 경우 사용(예: 초판, 2판, 수정판). |판=수정이라고 입력하면 ‘수정판’이라고 표기됨.

총서: 출처가 책이나 저널의 총서의 부분인 경우. 별칭: 시리즈

권: 하나의 출판물이 여러 권으로 나온 경우. 제목과 총서 뒤에 표기됨. 4 이하의 값이 지정되면 굵은 글씨로 표시됨.

출처 내 위치

쪽: 출처가 위치한 쪽수. ‘n쪽’과 같이 표기되며, |쪽숨김=예을 설정하면 숫자만 표기됨. 여러 쪽인 경우 엔 대시(–)나 대시(-), 물결표(~)를 쓰거나, 연속된 쪽이 아닌 경우 쉼표(,)를 이용함(예: |쪽=108, 110) 출처의 전체 쪽수를 적지 말 것. 대시를 입력하면 자동으로 엔 대쉬로 바뀜. 대시를 써야하는 경우 |쪽기타=를 쓸 것.
- 쪽숨김: |쪽숨김=예로 설정하면 ‘쪽’ 표시를 숨겨줌.
또는: 쪽기타: 쪽수를 쓰는 것이 부적절한 경우 쪽을 대신하여 사용.
영어판의 틀에서는 하나의 쪽을 나타내는 page와 두 쪽 이상을 나타내는 pages가 따로 있습니다. 그러나 한국어판에서는 쪽=page이며, pages에 대응하는 한국어 이름은 없습니다. 둘 중 어느 것을 쓰더라도 똑같이 표시되나 둘을 동시에 쓸 수는 없습니다.

URL

url: 출처의 URL. 제목에 위키 링크가 있는 경우 사용할 수 없음. URL에서는 불필요한 변수들을 지우는 것이 좋음(예: #ixzz2rBr3aO94, ?utm_source=google&utm_medium=...&utm_term=...&utm_campaign=...).
- 확인날짜: 해당 URL에 필요한 내용이 있음을 확인한 날짜. 위키 링크를 하지 말 것. url을 필요로 함. 단, 변하지 않는 문서에는 필요로 하지 않음. 예를 들어 디지털 객체 식별자나 출판된 책에는 필요로 하지 않지만, 내용이 시시각각 변하는 뉴스 사이트나 상업 사이트 등에는 필요함. 또한, 확인날짜는 단순히 해당 URL이 작동된 것을 확인한 날짜가 아니라, ‘인용된 사실이 있음을 확인한 날짜’임을 나타냄.
- 보존url: URL의 웹 보존 문서. 보존날짜와 url을 필요로 함. 자세한 사항은 백:웹보존 참고.
  - 보존날짜: 문서가 보존된 날짜. 위키 링크를 하지 말 것.
  - url-status: URL이 현재도 접속할 수 있지만, 미리 웹 보존을 한 경우 |url-status=dead 또는 |url-status=live와 같이 설정함. 원본 URL이 스팸 광고나 기타 여러 이유로 인해 위키백과 내에서 사용할 수 없게 된 경우 |url-status=unfit과 같이 설정함.

URL은 반드시 지원되는 URI 스킴을 포함해야 합니다. http://와 https://는 모든 브라우저가 지원합니다. 하지만 ftp://, gopher://, irc://, ircs://, mailto:, news: 등은 플러그인이나 외부 프로그램을 필요로 하기 때문에 되도록 사용하지 말아야 합니다. IPv6 역시 현재는 지원되지 않습니다.

만약 인용 틀에 쓰인 URL에 다음과 같은 특정 문자가 있으면 정상적으로 링크가 만들어지지 않습니다. 그러므로 반드시 퍼센트 인코딩되어야 합니다. 인코드를 위해서 문자를 다음 표에 맞게 다시 바꿔야 합니다.

공백	"	'	<	>	[	]	{	\|	}
%20	%22	%27	%3c	%3e	%5b	%5d	%7b	%7c	%7d

하나의 아포스트로피(')는 인코드 할 필요가 없습니다. 그러나 이를 여러개 쓸 경우 위키 문법에 의해 이탤릭체나 굵은 글씨로 인식하므로 바꾸어야 합니다. 하나의 닫는 중괄호(})도 인코드 할 필요가 없지만, 이를 두 개 쓸 경우 틀로 인식하므로 바꾸어야 합니다.

형식: url의 형식. 예: PDF, XLS, HWP. HTML인 경우 기재하지 말 것. 제목 뒤에 괄호로 표기됨.

장 URL

장url: 각 장의 URL 주소. url과 함께 쓰인다면 둘은 서로 같은 사이트여야 함. 그러나 url과 페이지 자체가 같다면 사용해서는 안 됨.장에는 위키 링크를 걸 수 있으며, 장url이 쓰인 경우 해당 주소가 연결이 되므로 둘을 동시에 쓸 수 없음.
장형식: 장url의 형식. 예: PDF, XLS, HWP. HTML인 경우 기재하지 말 것. 장 다음 괄호 안에 표기됨.

앵커

ref: 앵커의 ID. 기본적으로 앵커는 항상 자동으로 만들어집니다. |ref=ID라고 쓰면 ID라는 이름의 앵커를 만들어줍니다.

식별자

id: 고유 식별자로 아래에 있는 식별자 외에 경우에 사용함. 위키 링크를 걸 수 있으며 틀도 쓸 수 있음.

아래의 식별자는 하나의 값에 대해 이름에 맞는 링크를 만들어줍니다. 하나의 식별자에 대해 여러 값을 이용하면 정상적으로 작동되지 않을 수 있습니다. 일반적으로 변수들은 식별자의 변수 부분만을 포함해야 합니다. (예: rfc=822, pmc=345678)

arxiv: arXiv. 예: hep-th/9205027(2007년 4월 이전) 또는 0706.0001(그 이후). ‘.pdf’, ‘.html’ 등의 불필요한 파일 확장자는 넣지 말 것.
asin: 아마존 표준 식별 번호. 만약 이 값의 첫 글자가 숫자인 경우 isbn을 쓸 것.
- asin-tld: 미국 외 다른 국가의 아마존 사이트의 최상위 도메인. 가능한 값: au, br, ca, cn, co.jp, co.uk, de, es, fr, it, mx
bibcode: 비브코드. 예: 1974AJ.....79..819H
doi: 디지털 객체 식별자. 예: 10.1038/news070508-7. 반드시 10.으로 시작해야 함.
- doi_깨진날짜: DOI가 사이트에서 작동하지 않은 것이 확인된 날짜.
isbn: 국제 표준 도서 번호. 예: 978-0-8126-9593-9. ISBN의 줄표(-)는 선택이나 쓰는 것이 좋음. 책에 실제로 적혀있는 ISBN을 써야 함. 가능한 경우 978 또는 979로 시작하는 13자리 ISBN을 쓰고, 책에 10자리만 있는 경우에는 10자리를 사용함. 9자리로 이루어진 표준 도서 번호(SBN)은 숫자 앞에 0을 붙여야 함(예: SBN 902888-45-5를 |isbn=0-902888-45-5로 입력). 10자리 ISBN 맨 앞에 978을 단순히 붙인다고 해서 정상적인 13자리 ISBN이 되는 것이 아니므로 해서는 안 됨. 숫자나 공백, 줄표 또는 X 외에 다른 문자가 들어있거나 길이가 정상적이지 않은 경우 오류가 생김.
ismn: 국제 표준 음악 번호. 예: 979-0-9016791-7-7. 줄표나 공백 문자는 선택임.
issn: 국제 표준 일련 번호. 8자리 문자는 줄표를 이용하여 두 개, 혹은 네 개로 나뉠 수 있으나, 공백이나 엔 대시(–)를 쓰면 안 됨.
jfm: 수학 진보 연보.
jstor: JSTOR.
lccn: 미국 의회도서관 제어 번호. 알파벳 문자는 소문자로 입력해야 함.
mr: 수학 리뷰.
oclc: 온라인 컴퓨터 도서관 센터.
ol: 오픈 라이브러리 식별자. 값에 있는 ‘OL’은 포함하지 말 것.
osti: 미국 과학기술정보국.
pmc: 펍메드 센트럴. 예: 345678. 값에 있는 ‘PMC’는 포함하지 말 것. 아래 있는 pmid와는 다름.
- 엠바고: pmc가 정상적으로 작동되는 날짜. 날짜가 미래인 경우 그 날짜가 되기 이전에는 연결되지 않음.
pmid: 펍메드. 위에 있는 pmc와는 다름.
rfc: RFC.
ssrn: 사회 과학 연구 네트워크.
zbl: 첸트랄블라트 마트.

인용문

인용문: 직접 인용할 내용. 따옴표 안에 표기됨. 별칭: 인용

요약문

요약문: 해당 출처에 대한 비전문적인 요약이나 논평의 URL 주소. 제목은 ‘요약문’으로 고정됨. 별칭: 요약문url
- 요약문출처: 요약문의 출처.
- 요약문날짜: 요약문의 날짜.

표시 선택 사항

이탤릭체: ‘예’ 또는 ‘참’ 등을 지정하면 영어판과 유사하게 틀에 이탤릭체가 사용됨.
모드: 구별자와 각종 구두점 등을 바꿀 수 있음. |모드=cs1은 요소 구별자는 쌍반점(;), 마지막 구두점은 마침표(.)로 바뀜. |모드=cs2로 설정하면 요소 구별자는 쉼표(,), 마지막 구두점은 생략됨.
이름형식: |이름형식=vanc로 설정하면 이름 목록의 형식이 벤쿠버 양식으로 바뀝니다. 단, 이름이 성·이름으로 이루어져 있어야 합니다.
저자숨김: 특정한 순서의 저자의 이름와 성을 숨기고 다른 문구 또는 엠 대시(—)를 넣어줌. ‘저자숨김1’과 같이 숫자를 붙여서 사용함. 엠 대시를 넣기 위해서는 원하는 엠 대시의 개수를 기재하면 개수에 맞춰서 추가됨. 저자를 숨기더라도 메타데이터를 위해 모든 저자의 이름을 지정해야만 함. {{각주}}, <references />가 만드는 목록에서는 사용하지 말 것. 마찬가지로 편집자숨김과 번역자숨김 또한 사용할 수 있음.
저자표시: 표시되는 저자의 수를 조절함. 예를 들어 2명의 저자만 표시되길 원하는 경우 |저자표시=2라고 지정함. 지정하지 않는 경우, 기본적으로 모든 저자가 표시됨. 마찬가지로 편집자표시 또한 사용할 수 있음.
저자앰퍼샌드: ‘예’, ‘참’, ‘yes’ 등을 지정하면 마지막 저자 앞의 기호를 앰퍼샌드(&)로 바꿔줌.
추신: 인용 틀의 맨 마지막에 사용되는 기호. 기본 값은 없음. 인용문이 설정된 경우 무시됨.

등록 또는 구독 필요

이 매개변수는 인용 틀 맨 마지막에 문구를 붙입니다.

등록: ‘예’, ‘참’, ‘yes’ 등을 지정하면, 해당 출처를 확인하기 위해 회원 등록 등이 필요하다는 점을 알려줌.
구독: ‘예’, ‘참’, ‘yes’ 등을 지정하면, 해당 출처를 확인하기 위해 유료 구독 등이 필요하다는 점을 알려줌.

두 개가 동시에 지정된 경우 구독만 표시됩니다.

틀데이터

틀 변수
이 틀은 한 줄로 쓰는 것이 권장됩니다.
변수		설명	형식	상태
설정된 변수가 없음