도움말:목록 정의 참조

Help:List-defined references

LDR(List-defined reference, LDR)은 기사의 본문에 정의되는 것과 반대로 참조 목록 마크업에서 정의되는 참조다.엘디아르(LDR)는 참조 기사를 보다 쉽고 복잡하지 않게 하기 위한 방법으로 2009년 9월에 시행되었다.

이 페이지는 도움말 섹션의 연속이다.각주.본 가이드는 귀하가 의 특징과 같이 거기서 설명하는 도구에 익숙하다고 가정한다.<ref>...</ref>태그, 그리고<ref name="REFNAME" />매개 변수

개요

LDR은 각 개별 참조가 고유한 이름을 가지며 참조 목록 마크업 내에서 정의되는 명명된 참조를 사용한다.

<<ref name="name" 참조</ref><ref name="name2" 참조2</ref></ref> </ref>
또는 {{reflist}} 사용
{{reflist refs=<ref name="name" 참조</ref><ref name="name2" 참조2</ref>}}}}

각 참조는 다음을 사용하여 텍스트 본문에서 호출된다.<ref name="name" />또는{{r name}}.

각주 및 그룹의 이름은 다음 규칙을 따라야 한다.

  • 이름은 대소문자를 구분한다.RaNdOM 대문자화를 사용하지 마십시오.
  • 이름은 순전히 숫자일 수 없다. 소프트웨어는 다음과 같은 것을 받아들일 것이다.":31337"(구문 부호 + 숫자) 그러나 무시한다."31337"(숫자 표시).
  • 이름에는 의미적 가치가 있어야 위키텍스트를 보고 있는 인간 편집자들에 의해 서로 더 쉽게 구별될 수 있다.이것은 다음과 같은 이름을 참조한다는 것을 의미한다."Nguyen 2010"다음과 같은 이름보다 선호된다.":31337".
  • 이름은 고유해야 한다.다른 그룹 또는 각주를 정의하기 위해 동일한 이름을 사용할 수 없다.다음과 같이 다른 사람이 새로운 인용을 위해 선택할 가능성이 높은 이름을 선택하지 않도록 하십시오.":0"또는"NYT".
  • 참조 이름을 단순하게 유지하고 표준 영어 알파벳과 숫자로 제한하십시오.공간을 사용할 경우 다음과 같은 기술적 제한이 관련된다.
    • 따옴표가 선호되지만 사용된 문자만 문자일 경우 선택 사항A–Z,a–z, 숫자0–9, 및 기호!$%&()*,-.:;<@[]^_`{ }~. 즉, 인쇄 가능한 모든 ASCII 문자(단, 제외)#"'/=>?\.
    • 공백을 포함한 다른 문자를 포함하려면 참조 이름을 따옴표로 묶어야 한다. 예를 들어,name="John Smith".
    • 인용 부호는 표준, 직선, 큰따옴표여야 한다."); 곱슬 또는 다른 따옴표는 참조 이름의 일부로 구문 분석된다.
    • 인용 부호가 포함된 참조 이름에는 보다 작은 부호가 포함될 수 없다.<) 또는 이중 직선 따옴표 기호("). 이러한 것들은 다음과 같이 탈출할 수 있다.&lt;그리고&quot;각각,
  • 참조 이름이 필요하지 않은 경우에도 선택적으로 참조 이름을 제공할 수 있다.이것은 나중에 소싱된 참조의 재사용을 더 쉽게 만든다.

지침

  • 모든 목록 정의 참조의 이름을 지정해야 한다.위의 기술적 제한을 준수하는 이름을 사용할 수 있지만, 다른 사용자가 편집할 수 있도록 일관성이 있어야 한다.잘 사용되는 관행은 저자 날짜, 저자 제목 또는 출판 날짜다.
  • 또한 사용되지 않는 참조는 오류를 발생시킬 것이다.모든 목록 정의 참조는 본문에 사용되어야 하며, 그 반대의 경우도 모두 사용되어야 한다.<ref name="ABC">...</ref>태그에는 정의 정보가 있어야 한다.
  • 기사 본문에 정의된 목록 정의 참조와 참조는 한 페이지에 혼합될 수 있다. 이는 템플릿의 기술적 제한이 아니다.그러나 이는 현재 진행 중인 편집자에게 혼란을 줄 수 있으며 WP에 따라 단일 스타일로 표준화되어야 한다.CITEVAR.
  • 참조 목록은 어떤 방식으로든 주문할 수 있지만(예: 참조 이름에 의한 알파벳순), 생성된 목록은 참조가 호출되는 순서가 될 것이다.

예

마크업 렌더링:
태양은 꽤 크다.<ref name="Foot01"/> 그러나 달[ref name="foot02"/>는 그렇게 크지 않다.<ref name="풋03"/> 태양도 꽤 뜨겁다.<ref name="Foot04"/> ==Notes=={reflist refs=<ref name="Foot01">Miller, "The Sun"," 2005년 옥스포드, 페이지 23.</ref> <ref name="풋02">존스, '태양계', 맥밀런, 2005년, 페이지 623.</ref> <ref name="Foot03">Brown, 'The Moon'), 2006, Penguin, 페이지 46.</ref> <ref name="Foot04">스미스, "The Universe","Random House, 2005, 페이지 334.</ref> }}

태양은 꽤 크다.[1]하지만[2] 달은 그렇게 크지 않다.[3]태양도 꽤 뜨겁다.[4]

메모들
  1. ^ 밀러, 더 선, 옥스포드, 2005년, 페이지 23.
  2. ^ Jones, The Solar System, MacMillan, 2005, p 623.
  3. ^ 브라운, 더 문, 2006, 펭귄, 페이지 46.
  4. ^ Smith, The Universe, Random House, 2005, 페이지 334.


별도의 참조 그룹을 사용하여 설명 각주가 있는 목록 정의 참조.
마크업 렌더링:
태양은 꽤 크다.<ref name="Foot01"/><ref group="Note" name="노트01"/> 그러나 달<ref 그룹="Note" 이름="노트02"/>는 그렇게 크지 않다.<ref name="Foot02"/><ref group="Note" name="노트03"/> 태양도 꽤 뜨겁다.<ref name="Foot03"/> ==Notes=={reflist group=Note refs=<ref name="노트01">그러나 밀러는 태양이 다른 별들만큼 크지 않다고 지적한다.</ref> <ref name="노트02">달은 셀레나 같은 다른 이름으로 통한다.</ref> <ref name="참고03">역사적으로 달이 항상 큰 것으로 여겨지는 것은 아니었다.</ref> }} ==참조=={reflist refs=<ref name="Foot01">Miller, "The Sun"," 2005년 옥스포드, 페이지 23.</ref> <ref name="Foot02">Brown, "The Moon", 2006, Penguin, 페이지 46.</ref> <ref name="풋03">스미스, '우주' , 2005년 랜덤 하우스, 페이지 334.</ref> }}

태양은 꽤 크다.[1][Note 1]하지만[Note 2] 달은 그렇게 크지 않다.[2][Note 3]태양도 꽤 뜨겁다.[3]

메모들
  1. ^ 그러나 밀러는 태양이 다른 별들만큼 크지 않다고 지적한다.
  2. ^ 달은 셀레나 같은 다른 이름으로 통한다.
  3. ^ 역사적으로 달은 항상 큰 것으로 여겨지지 않았다.
참조
  1. ^ 밀러, 더 선, 옥스포드, 2005년, 페이지 23.
  2. ^ 브라운, 더 문, 2006, 펭귄, 페이지 46.
  3. ^ Smith, The Universe, Random House, 2005, 페이지 334.

사용 참고 사항

리스트 정의 참조의 사용은 편집하는 동안 이러한 방식으로 포맷된 참조와 각주가 템플릿이 있는 소스 섹션에 모두 삽입됨을 의미한다.{{reflist refs= }}위치한다.이것은 주로 소스 코드의 변경이며, 독자에 대한 글의 표시에는 영향을 미치지 않는다.주요 효과는 아래에 설명된 대로 편집자를 위한 것이다.

LDR 방법은 텍스트 본문을 편집하는 동안 편집 창을 방해할 수 있는 인용 세부사항이나 메모를 제거하는데, 특히 세로줄이거나 여러 줄에 걸쳐 있는 경우에 유용하다.또한 인용문 항목 중 어느 하나라도 수정이 필요한 경우 이 중앙집중식 참조 목록 섹션을 자체적으로 열 수 있으며, 특히 여러 번 사용되는 참조를 수정하려고 시도할 경우 전체 출처를 검색할 필요가 없어 유용할 수 있다.

접근법의 단점은 이러한 참조가 텍스트와 분리되기 때문에 출처에 삽입하기가 더 어려울 수 있다는 것이다.편집자는 텍스트와 참조 목록의 출처를 보기 위해 전체 문서를 열거나, 또는 먼저 식별자를 입력하는 2단계 절차를 사용해야 한다.<ref name="name" />기본 텍스트에서 다음 참조 목록 섹션을 열어 원본 또는 각주를 다음과 같이 입력하십시오.<ref name="name">content</ref>. 이 접근방식의 또 다른 오버헤드는 글의 끝에 있는 목록을 편집자가 쉽게 찾을 수 있도록 정리해야 한다는 것이다. 텍스트의 섹션이 변경되더라도 소스 무결성과 유용성을 유지할 가능성이 가장 높기 때문에 리프레임으로 편집 창에 알파벳 순으로 배열될 가능성이 가장 높다.

원본 텍스트에서 모든 인용문을 제거하는 것이 더 깔끔하지만, 허용되는 타협안은 (특히 작은 글의 경우) 여러 번 사용되는 인용문에만 LDR을 사용하는 것일 수 있다.이미 여러 곳에 있을 수 있도록 리프네임 코드를 사용하고 있기 때문인데, 레퍼런스의 소스 코드를 처음 등장부터 리프리스트로 간단하게 이동하는 것은 사소한 변화다.또한 이러한 인용문은 기사에 더 중요하고 더 자세한 내용을 포함하고 있으며, 그것들을 찾고 수정하기 쉽게 하는 것이 매우 도움이 될 수 있기 때문에 검토나 수정을 필요로 할 가능성이 더 높다.마지막으로, 위에서 언급한 바와 같이, 참조의 첫 번째 사례가 변경되는 경우에도 이는 원천 무결성을 유지한다.

또한 사용자 작성 스크립트 사용자:PleaseStand/Reference Segregator를 사용하면 인용문을 편집 창에서 자동으로 분리하고, 별도의 "인라인 인용" 창에 임시로 수집할 수 있다.이 형식에서 인용문은 참조 목록에 수동으로 삽입될 수 있다.이는 사용이 실용적이지 않거나 합의에 반하는 영구적 LDR의 장점을 일부 가질 수 있다.그러나 페이지를 저장하기 전에 이 창의 모든 내용이 처음 일치할 때 기본 텍스트 소스로 대체된다는 점에 유의하십시오.<ref name="name" />수동으로 비워지지 않는 한 태그를 추가하십시오.페이지 등에 정리된 것처럼 기존 인용문을 스스로 참조 리스트로 처리할 수 있는 자동변환스크립트를 갖췄지만 편집 과정에서 이 마이그레이션을 할 수 있을지는 미지수다.

마지막으로, 목록 정의 각주에 대한 몇 가지 오해가 있다.

  1. 그 중 하나는 분리된 각주목록을 작성하기 위해서는 목록정의 각주를 사용해야 한다는 것이다.그러나 '그룹' 이름을 사용하여 다양한 종류의 각주를 구별할 수 있으며, 목록 정의 각주를 사용하든 인라인 각주를 사용하든 상관없이 사용할 수 있다.예를 들어, 두 경우 모두 메모를 "주"라는 그룹으로 지정하고, 인라인 레이블을 사용하여 메모를 단순한 인용문으로부터 분리할 수 있다.<ref group="Note" name="name" />(그룹명 사용에 대한 전체 설명은 바로 위의 섹션의 두 번째 예에 설명되어 있다.)
  2. 또 다른 오해는 목록으로 정의된 각주와 인라인 각주의 사용 사이에 "둘 중 하나"의 선택이 있으며, 기사의 모든 인용문은 하나의 스타일만을 따라야 한다는 것이다.실은.{{reflist refs= }}양식에서 인라인 각주를 사용하는 것과 완전히 호환됨<ref>content</ref>또는<ref name="name">content</ref>같은 기사에서 두 시스템을 사용하는 것이 혼란스럽거나 바람직하지 않은 것처럼 보일 수 있지만, 두 시스템을 템플릿과 무분별하게 혼합할 수 있다는 것은 사실이다.{{reflist refs= }}.

오류

때때로 참조하는 것은 빨간 텍스트로 나타나는 오류를 발생시킬 수 있다.도움말을 참조하십시오.이러한 오류를 진단하고 해결하는 데 도움이 되는 오류를 인용하십시오.또는 위의 예 또는 템플릿의 참조 목록 문서에 대해 코드를 확인하십시오.reflist § 목록 정의 참조.특히, LDR이 작동하려면 두 항목 모두에서 항목을 정의하고 사용해야 하기 때문에 명명된 참조 태그 또는 참조 목록 코드의 오류는 문제를 일으킬 수 있다.

변환 중

기본 페이지:도움말:참조 형식 간 변환

참조 스타일은 WP에서 인용 스타일에 대한 다른 주요 변경에 대한 동일한 규칙에 따라 목록 정의 참조에서 또는 목록 정의 참조로 변환될 수 있다.CITEVAR.사용자:PleaseStand/segregate-refs.js에는 변환을 지원하는 옵션이 있다.

참고 항목

  • 템플릿:R – 명명된 참조를 만드는 데 필요한 텍스트를 줄여주는 템플릿으로, <ref name="foo"/>가 {{r foo}이(가) 된다.
  • 참조 조직자[1](출처) – 모든 참조를 그래픽 사용자 인터페이스로 표시하는 도구로, 참조를 문서 본문 또는 참조 목록 템플릿(목록 정의 형식)에 정의해야 하는지 선택할 수 있다.선택은 모든 참조에 적용되거나, 특정 수의 사용(시민권)이 있는 모든 참조에 적용되거나, 개별적으로 참조를 체크하여 적용할 수 있다.다양한 방법으로 참조를 정렬하고(참조 목록 템플릿의 정렬 순서를 유지) 이름을 변경할 수도 있다.의견이 일치할 경우에만 사용하십시오.

참조

  1. ^ 다음 코드를 복사하고 여기를 클릭한 후 붙여넣으십시오.
    {{subst:lusc 1=User:Cumbril/RefConsolidate_start.js}}