틀:Term

{{{1}}}

이 틀은 틀스타일을 사용합니다.

틀:Glossary/styles.css

틀 {{term}}은 틀 구조 용어집에서 정의할 용어를 생성하는 데 사용되며, 적절하게 구조화되어 있고, 의미론적 가치를 가지며, 독립적인 섹션처럼 링크될 수 있습니다. 이 틀은 설명 목록 용어 HTML 요소인 <dt>...</dt>의 래퍼입니다. 이 틀은 {{dt}}에서 니모닉 리디렉션됩니다.

사용법

기본 사용법:

{{term|1=<var>용어</var>}}
{{defn|1=<var>정의.</var>}}
{{glossary end}}

인라인 틀, 참조 인용, 위키 문법 스타일 등은 두 번째 매개변수(|content= 또는 |2=)에 적용될 수 있으며, 첫 번째 매개변수(|term= 또는 |1=)에는 마크업 없이 유지되어야 합니다. 기술적으로는 용어나 내용에 "=" 문자가 포함되지 않으면 명시적인 매개변수 이름은 선택 사항이지만, 편집자가 이 문자를 포함하는 틀이나 URL을 포함한 자료를 추가할 수 있으므로, 매개변수를 명시적으로 이름 지정하거나 번호를 매기는 것이 항상 가장 안전합니다.

이것은 작동합니다: 틀:Bxt
이것은 작동합니다: 틀:Bxt
이것은 작동에 실패합니다: 틀:!bxt

더 복잡한 사용법은 일반적으로 다음과 같습니다:

{{term|term=마크업 없는 용어 |content=마크업 있는 용어}}

또는

{{term|1=마크업 없는 용어 |2=마크업 있는 용어}}

또는

{{term|1=마크업 없는 용어 |content=마크업 있는 용어}}

용어의 위키 스타일 지정 및 연결

두 번째 또는 |content= 매개변수가 위키 마크업으로 스타일이 지정되거나, 연결되거나, 틀 내부에서 다르게 변경되는 경우, 해당 용어는 반드시 첫 번째 또는 |term= 매개변수로 스타일이 지정되지 않은 형태로 유지되어야 합니다. 그렇게 하지 않으면, 틀이 올바르게 작동하지 않습니다. 왜냐하면 틀은 연결 목적으로 요소의 id로 사용할 "깨끗한" 용어 이름이 필요하기 때문입니다. 순서는 의도적으로 파이프 위키 연결 ([[제목|스타일]])과 일치합니다.

올바름: {{term|1=esprit de corps|2=''esprit de corps''}}
틀림: {{term|1=''esprit de corps''}}

스타일은 틀 주위에 적용할 수 없습니다. 왜냐하면 틀은 내용(용어)의 컨테이너이지, 내용 자체가 아니기 때문입니다(이렇게 하면 유효하지 않은 마크업이 생성되어 브라우저에 따라 예측할 수 없는 결과가 발생합니다).

틀림: ''{{term|1=esprit de corps}}''

제목에 다른 페이지로의 링크가 권장되지 않는 것과 동일한 이유로, 용어집 용어에는 링크가 권장되지 않습니다:

사용 중단: ~~{{term|1=esprit de corps|2=''[[esprit de corps]]''}}~~
권장: {{term|1=esprit de corps|2=''esprit de corps''}}, 그리고 {{defn}} 정의에서 {{ghat}} 각주를 사용하여 본문 esprit de corps로 연결합니다.

다시 말해, 첫 번째 매개변수(용어) 자체와 마찬가지로, 이 두 번째 매개변수의 내용에 "=" 문자(등호)가 사용되면, 구문은 매개변수가 명시적으로 지정되어야 합니다 (그리고 참조 인용 등 많은 URL에 이 문자가 포함될 수 있으므로, 매개변수에 번호나 이름을 지정하는 것이 항상 가장 안전합니다):

번호가 매겨진:

{{term|틀:BxtE=MC²|틀:BxtE=MC<sup>2</sup>}}

또는 이름이 지정된:

{{term|틀:BxtE=MC²|틀:BxtE=MC<sup>2</sup>}}

용어로 연결

{{term}}은 원본 용어(|term= 또는 |1=) 또는 |id=를 모두 소문자로 변환하여 링크 앵커 포인트(HTML id)를 자동으로 생성합니다. 용어집 항목으로의 링크 중 약 90%는 문장 중간에 위치하며, 고유 명사를 제외하고는 소문자로 시작합니다. {{glossary link}} 틀(및 {{cuegloss}}와 같은 파생 틀)은 링크 대상으로 주어진 입력을 자동으로 소문자로 변환합니다. 따라서 유일한 주의사항은 [[미국 정치 용어집#민주당|민주당]]와 같이 수동으로 링크를 만들고 #민주당 부분을 소문자로 변환하지 않는 경우입니다. 따라서 {{glossary link}}를 사용해야 합니다.

용어집에 한 항목과 다른 항목이 대소문자만 다르고 정확히 동일한 이름을 공유하는 특이한 경우가 있어 동일한 소문자 HTML id를 얻는다면, 대문자 항목에는 고유한 |id= 값을 지정해야 하며, 그리고 소문자 항목의 HTML id와 충돌하지 않도록 해야 합니다. 이는 |id=를 다른 값(예: 숫자 포함)으로 변경한 다음, |content= 매개변수와 앵커 틀을 사용하여 두 번째 HTML id(대문자)를 수동으로 삽입함으로써 수행할 수 있습니다:

  {{Term|term=foo}}
  {{Defn|여기에 소문자 버전의 정의 ...
  {{term|term=Foo |id=Foo_2 |content={{vanchor|Foo}} }}
  {{Defn|여기에 고유 이름 버전의 정의 ...

그러면 각각 #foo와 #Foo로 링크할 수 있습니다. (기술적으로 두 번째 항목은 템플릿 코드에 의해 소문자로 변환된 #foo_2로도 주소 지정할 수 있지만, 이것은 직관적이지 않으며 단순히 우회책의 부산물입니다.)

{{anchor}} 틀은 |content= (또는 |2=) 매개변수에서도 사용할 수 있으며, 예를 들어 용어의 복수형(가장 일반적인 사용), 대체 철자, 링크되었지만 변경된 항목의 이전 이름 또는 단축 링크 앵커 이름을 제공할 수 있습니다.

스타일이 지정된 용어와 마찬가지로, 첫 번째 매개변수는 "기본" 용어를 제공하는 데 사용되어야 하고, 두 번째 매개변수는 이 추가 마크업을 제공하는 데 사용되어야 합니다. {{term}}을 사용할 때 {{anchor}} 틀에 용어 자체를 추가할 필요는 없습니다:

{{term|1=shortstop }}

대조적으로, 구조화되지 않은 용어집에서 세미콜론으로 구분된 용어를 사용할 때, 링크 앵커가 필요한 경우(거의 항상 그렇습니다) 용어를 명시적으로 앵커로 추가해야 합니다:

;shortstop{{anchor|틀:Bxt|shortstops|short-stop|short stop}}

또는 {{vanchor}}를 사용합니다.

;{{vanchor|틀:Bxt|shortstops|short-stop|short stop}}

(엄밀히 말해, 이 사실은 이 틀과 아무 관련이 없지만, 하나의 용어집 스타일에서 다른 스타일로 변환하는 편집자에게 유용할 수 있습니다.)

정의를 공유하는 여러 용어

두 개 이상의 {{term}}은 공유된 정의를 가진 동의어에 사용될 수 있지만, 알파벳순으로 정렬될 것으로 예상되는 위치에서 찾지 못하는 사람들은 교차 참조 항목을 만들지 않으면 누락되었다고 가정할 수 있다는 점을 명심하십시오. 틀:Dc2

|multi=y는 더 이상 사용되지 않습니다. 틀스타일을 사용하면 연속적인 {{term}}은 자동으로 시각적으로 가깝게 그룹화됩니다. 이는 용어집 틀 {{term}}과 {{defn}}이 HTML <dt> 및 <dd> 태그의 의미론을 더 밀접하게 따르도록 돕습니다.

다음 예시는 |multi=y 매개변수 사용이 더 이상 렌더링된 출력에 영향을 미치지 않음을 보여줍니다(이제 기본 동작이기 때문):

{{Term|1=aspirin}}
{{Defn|1=A mild analgesic of the non-steroidal anti-inflammatory drug (NSAID) family...}}
틀:Bxt
틀:Bxt
틀:Bxt
{{Defn|1=A synthetic narcotic drug of the opiate family...}}
{{Term|1=ranitidine}}
{{Defn|1=An antacid of the proton pump inhibitor family...}}

결과:	대조적으로 `\|multi=y` 없음
aspirin A mild analgesic of the non-steroidal anti-inflammatory drug (NSAID) family... heroin diacetylmorphine diamorpine A synthetic narcotic drug of the opiate family... ranitidine An antacid of the proton pump inhibitor family...	aspirin A mild analgesic of the non-steroidal anti-inflammatory drug (NSAID) family... heroin diacetylmorphine diamorpine A synthetic narcotic drug of the opiate family... ranitidine An antacid of the proton pump inhibitor family...

언어

영어가 아닌 용어의 언어를 나타내려면 {{lang}} 틀과 해당 틀에 문서화된 ISO 639 언어 코드를 사용하십시오:

{{term|1=esprit de corps }}

이는 대부분의 언어에서 시각적 변화를 보이지 않습니다:

esprit de corps

모든 비영어권 언어에 대해 이 기능은 많은 메타데이터 기능을 제공하지만, 라틴 알파벳을 사용하지 않는 언어의 경우 콘텐츠가 다양한 브라우저에서 올바르게 표시되도록 필수적입니다.

언어 이름을 나타내는 것이 유용할 경우, ISO 코드를 기반으로 이름을 가진 대부분의 언어에 대한 개별 틀이 있으며, 이는 외국 콘텐츠를 자동으로 이탤릭체로 표시합니다:

{{term|1=esprit de corps }}

다음과 같이 렌더링됩니다:

프랑스어: esprit de corps

두 개 이상의 언어 변형 용어가 동일한 정의를 공유하는 경우:

위에서 설명한 바와 같이, 두 개 이상의 용어가 변형 또는 대안으로 정의를 공유할 수 있습니다. 가장 일반적인 사용 사례는 용어를 두 가지 영어 변형으로 제시하는 것입니다. 예시:

{{term|1=tyre|content=틀:Bxt }}
{{Term|1=tire|content=틀:Bxt}}
{{Defn|1=A resilient wheel covering, usually made of vulcanized rubber.}}

결과:

영국 영어: tyre
미국 영어: tire: A resilient wheel covering, usually made of vulcanized rubber.

다른 형식으로, 알파벳순 용어집에 더 적합한:

{{term|1=tire|content=틀:Bxt }}
{{Term|1=tyre|content=틀:Bxt }}
{{Defn|1=A resilient wheel covering, usually made of vulcanized rubber.}}

결과:

tire (미국 영어)
tyre (영국 영어): A resilient wheel covering, usually made of vulcanized rubber.

이 예시는 첫 번째 매개변수로 언어 코드를 사용하는 {{Lang}} 틀을 사용하며, {{lang-xx}} 틀을 사용하지 않습니다.

{{Term}} 틀에는 자체 ~~|lang=~~ 매개변수가 없습니다 (그리고 있어서도 안 됩니다 – 너무 많은 함정이 있습니다).

용어에 CSS 스타일 적용

|style= 매개변수는 CSS 스타일을 <dt> 요소로 전달합니다. 예: |style=font-family:serif;. 즉, 이 기능은 용어 자체의 스타일을 지정하며, 해당 정의, 다른 용어 항목 또는 전체 용어집의 스타일을 지정하지 않습니다. 이 기능은 기사에서 드물지만 때로는 중요하게 필요합니다(보통 특정 항목의 모양을 어떤 이유로든, 예를 들어 항상 세리프 글꼴로 주어지는 특정 수학 상수 등을 서식 지정하기 위해). 또한 기사 외부에서도 사용자 정의 프로젝트 페이지 또는 사용자 페이지 스타일을 일치시키는 것과 같은 용도로 유용할 수 있습니다.

기타 매개변수

HTML5 업데이트:

id 내용에 대한 대부분의 제한이 제거되어 id 값이 더 이상 [a-z][A-Z] 알파벳 문자로 시작하거나 대부분의 문장 부호를 피하거나 다른 제한을 받을 필요가 없습니다. 위키백과의 미디어위키 엔진은 문제성 문자를 즉석에서 자동으로 이스케이프할 만큼 충분히 똑똑합니다.

|id= 매개변수는 용어에 한 단어로 된 대소문자를 구분하는 ID 이름을 할당하는 데 사용할 수 있습니다. 이 이름은 페이지에서 고유해야 합니다. 이는 다른 #링크 대상 및 기타 메타데이터 용도로 사용될 수 있습니다. 기본적으로 |term= (또는 |1=) 매개변수는 이미 ID로 설정되어 있으며, 동일한 페이지에 두 개의 동일한 용어가 있어 ID 충돌을 일으키는 경우가 아니라면 거의 재정의해서는 안 됩니다. 일반적으로 {{anchor}} 틀은 항목에 더 많은 링크 대상을 추가하는 데 사용됩니다. 오류: no text specified (help).. 빈 id(예: HTML 과 같은)를 제공하면 태그에 빈 id 매개변수가 방출되어 유효하지 않은 HTML이 생성됩니다.

|noid= 매개변수가 true / y / yes로 지정되면, id 필드 생성을 완전히 억제합니다. 이는 일반적으로 바람직하지 않지만, 생성된 |term=의 앵커 |text=가 문서에 정의된 다른 {{Term}}으로 향하는 경우에는 예외입니다.

|class= 매개변수는 하나 이상의 공백으로 구분된 CSS 클래스를 <dt> 요소로 전달합니다. 특히 본문 이름공간에서는 이렇게 할 이유가 거의 없습니다.

참고: 포함하는 {{glossary}}(HTML <dl> 태그를 생성함)에서 틀 스타일을 사용하면, 이 틀은 더 이상 기본적으로 glossary 클래스를 포함하지 않습니다.

예시

다음은 매우 간단한 예시와 다소 복잡한 예시를 모두 보여줍니다:

마크업

==A&ndash;M==

{{glossary}}

{{Term|1=applesnorkel}}
{{Defn|1=Term 1의 정의.}}

{{Term|term=arglefarst |content={{lang|xx|arglefarst}}{{앵커|argle-farst|argle farst}} }}
{{Defn|no=1 |defn=
Term 2의 첫 번째 정의 시작
{{quote|1=Term 2의 첫 번째 정의에 있는 블록 인용.}}
Term 2의 첫 번째 정의 끝.
}}
{{Defn|no=2 |defn=Term 2의 두 번째 정의.}}

{{Glossary end}}

렌더링 결과

A–M

applesnorkel: Term 1의 정의.
arglefarst: 1. Term 2의 첫 번째 정의 시작
Term 2의 첫 번째 정의에 있는 블록 인용.
Term 2의 첫 번째 정의 끝.; 2. Term 2의 두 번째 정의.

이미지, 각주 및 기타 내용

{{term}} 바로 뒤에 올 이미지, 각주 및 기타 "추가" 내용은 반드시 해당 {{term}}의 첫 번째 {{defn}} 상단(내부)에 사용되어야 합니다. {{term}}과 {{defn}} 사이에 배치될 경우 용어집 마크업을 손상시키므로 안 됩니다. 이미지는 물론 {{defn}} 내 다른 곳에 배치할 수 있으며, {{more}}와 같은 하단 각주는 {{defn}}의 끝에 배치할 수 있지만 내부에 있어야 합니다. 여러 정의가 있는 용어와 함께 사용될 경우, {{ghat}}이 나타나는 정의는 수동으로 번호를 매겨야 합니다(아래 예시와 같이 보통 1  ...).

마크업

{{glossary}}
{{Term|1=colour ball |content=colour ball {{anchor|coloured ball|coloured balls|colour|colours|color ball}} }}
{{Defn|1= [[파일:Set of Snookerballs.png|thumb|right|150px|스누커 공 세트, 여섯 개의 '''컬러 공''']]
{{ghat|또한 '''coloured ball(s)''', '''colour(s)'''; 미국식 철자 '''color'''도 때때로 사용된다.}}
1.&amp;nbsp; [[스누커]]에서 {{cuegloss|오브젝트 공|오브젝트 공}} 중 {{cuegloss|빨간 공|빨간색}}이 아닌 모든 공.
}}
{{Defn|no=2 |1= [[블랙볼 (당구)|블랙볼]]에서 빨간색과 노란색 {{cuegloss|그룹|그룹}}의 오브젝트 공을 통칭하는 일반적인 용어.
}}
{{Glossary end}}

렌더링 결과

colour ball: 스누커 공 세트, 여섯 개의 컬러 공

또한 coloured ball(s), colour(s); 미국식 철자 color도 때때로 사용된다.
1. 스누커에서 오브젝트 공 중 빨간색이 아닌 모든 공.; 2. 블랙볼에서 빨간색과 노란색 그룹의 오브젝트 공을 통칭하는 일반적인 용어.

기술적 세부 사항

이 틀이 기술적으로 하는 일은 term을 <dfn>...</dfn> HTML 요소로 래핑하여 정의된 용어의 페이지에서 정의 인스턴스로 의미적으로 표시하고, 이 마크업된 내용을 <dl>...</dl> 설명 목록(일명 정의 목록, 연관 목록; 목록은 {{glossary}} 및 {{glossary end}} 틀에 의해 생성됨)의 <dt>...</dt> 용어 요소 안에 넣고, <dt> 요소에 CSS class="glossary"를 부여하는 것입니다. 이 클래스는 아직 아무것도 하지 않지만, 나중에 약간의 글꼴 크기 증가와 같이 사용될 수 있습니다.

null ID(예: id=)를 지정하지 마십시오. 비어 있거나 null id HTML 매개변수는 유효하지 않은 HTML5 출력을 생성합니다.

같이 보기

틀:용어집 틀 참조

위 설명은 틀:Term/설명문서의 내용을 가져와 보여주고 있습니다.
이 틀에 대한 수정 연습과 시험은 연습장과 시험장에서 할 수 있습니다.
분류는 /설명문서에 넣어주세요. 이 틀에 딸린 문서.