위키백과:스타일/인포박스 설명서

infobox는 보통 기사의 오른쪽 상단에 있는 패널로, (Wikipedia의 바탕화면 버전에서) 리드 섹션 옆이나 (모바일 버전에서) 기사의 리드 섹션 끝 부분에 페이지 제목의 주요 특징을 요약한 패널이다. 인포박스는 이미지, 지도 또는 둘 다 포함할 수 있다.

위키피디아의 인포박스는 거의 항상 템플릿 소프트웨어 기능을 사용한다. (테이블 마크업을 사용하여 인포박스를 으로 코딩할 수는 있지만, 이 방법은 표준화와 재사용 가능성의 템플릿의 장점을 가지고 있지 않다.) 템플릿에는 매개 변수가 있다. 제대로 작동하려면 템플릿이 페이지에 삽입될 때 매개 변수 값을 지정해야 한다. 이를 통해 각 인포박스는 기사 제목과 관련된 정보를 보여줄 수 있는 동시에 각 기사 내에서 최소한의 코딩만 요구할 수 있다.

목적

infobox 설계의 어떤 측면을 고려할 때, infobox의 목적에 유의하십시오: 기사에 나타나는 주요 사실들을 요약하고 대체하지 않는 것(기사는 아래에 언급된 예외를 제외하고 요약한 infobox를 무시한 채 완전한 상태로 유지되어야 함). 정보가 적게 수록될수록 그 목적에 더 효과적으로 작용해 독자들이 주요 사실을 한눈에 파악할 수 있게 된다. 물론 일부 인포박스는 단지 몇 개 이상의 분야를 포함하고 있지만, 가능한 한 정보를 짧은 형태로 제시하며 불필요한 내용은 배제한다. 기사 내의 섹션에 대한 링크를 사용하지 마십시오. 목차는 해당 기능을 제공한다.

어떤 지침과 마찬가지로, 본문 텍스트에 핵심 전문 정보의 일부를 통합하기 어렵지만, 그 정보가 infobox에 배치될 수 있는 경우는 예외로 할 것이다. 대표적인 예로는 {{Infobox 언어}}의 ISO 639 코드와 {{Chembox}}의 대부분의 파라미터가 있다.

또한 infobox를 사용하면 DBpedia와 같은 제3자 재이용자가 그 안에 있는 데이터를 세부적이고 기계 판독이 가능한 형식으로 사용할 수 있게 되며, 종종 마이크로포맷을 사용한다.

설계원리

전체적인 접근 방식

infobox 템플릿을 만드는 권장 프로세스는 단순히 시작하고 가능한 많은 요구사항을 수집하는 것이다. 새 템플릿의 기본 형식을 정적 테이블로 먼저 테스트한 다음, 합의가 완료되면 템플릿 형식으로 마이그레이션하십시오. 템플릿 또는 정의된 매개변수를 수정하여 재작업을 최소화해야 할 경우, 기사에 광범위하게 사용하기 전에 템플릿을 검토해야 한다. 새로운 필드 및 매개변수가 추가되면 새로운 요구사항을 반영하도록 기사를 업데이트해야 한다. 매개 변수의 이름을 바꾸거나 제거하면 관련 없는 매개 변수가 무시되기 때문에 많은 기사가 영향을 받지 않을 수 있다.

스타일, 색상 및 형식

일반적인 일관성은 동일한 인포박스를 사용하는 여러 기사를 대상으로 해야 한다. 좋은 지침은 타당한 이유 없이 기본 Infobox에서 그것 위에 관련 없는 스타일의 포맷을 추가하지 않는 것이다. 인포박스는 일반적으로 기사 본문에서 사용되는 것보다 더 큰 약어로 경향이 있을 수 있다. 일반 지침 WP:NBSP(비절단 공간 사용), WP:MOSNUM(숫자 및 날짜) 및 WP:COLOR(색상의 사용)는 특히 관련이 있을 가능성이 높다. 항법 템플릿과 마찬가지로 인포박스의 목적은 외관이 아닌 효용성을 위한 것이므로 인포박스는 임의로 장식해서는 안 된다.

이미지

인포박스에 이미지를 추가할 때 미리 보기를 사용하면 안 된다. Infobox 템플릿은 단순히 파일 이름을 제공하는 것이 작동하도록 이미지 포맷을 돕기 위해 InfoboxImage 모듈을 구현해야 한다. 예를 들어, 파일을 사용하려면Image PlaceHolder.png, 간단하게 사용 가능 image=Image PlaceHolder.png자막은 다음과 같이 지정되어야 한다. caption= 옵션의 모든 infobox는 다르며, 해당 infobox에 대한 설명서는 이미지와 캡션에 맞는 적절한 매개변수에 대해 참조되어야 한다. InfoboxImage가 사용 중인 Infobox에서 아직 완전히 구현되지 않은 경우 동일한 경우 alt=, upright=, title=기타, 확장 이미지 구문, 호출을 사용하여 옵션을 호출할 수 있음 frameless아닌 thumb. (누락된 파라미터를 추가하라는 요청을 infobox의 토크 페이지에 추가하고자 할 수 있다.

인포박스 간 일관성

일관성을 위해 다음 지침을 적용한다.

  • 새 Infobox 템플릿을 생성하기 전에 먼저 적절한 Infobox가 이미 있는지 확인하십시오.
  • 템플릿 이름 [[템플릿:Infobox some pubject](일부 피험자는 단수여야 하며 정상적인 사용법에 따라 자본화되어야 함)위키백과 참조:기사 제목(예: "인포박스 정산" 또는 "인포박스 NFL 플레이어")).
  • {{infobox}} 템플릿으로 손쉽게 새로운 infobox를 만들 수 있다. 어떤 이유로 {{infobox}}이(가) 적합하지 않고 테이블을 수동으로 생성하려면 템플릿 코드를 사용해야 한다. class="infobox" 주요 테이블 선언용. 이것은 자동으로 기존의 인포박스에 맞는 올바른 정렬, 글꼴 크기, 간격을 선택한다. 22 ems의 폭 (22em cSS)는 {{infobox}} 디폴트와 일치하는 추가 선언으로 제안된다.
  • 템플릿에는 크고 굵은 제목줄이 있어야 한다. 표 캡션 또는 헤더를 이에 사용할 수 있다. 기사의 주제의 공통 명칭으로 명명해야 하지만 전체 (공식) 명칭을 포함할 수 있다. 이것은 기사의 위키백과 제목과 일치할 필요는 없지만, 다시 그것을 사용하기 위해 ({PAGENAMEBASE})는 보통 괜찮다. 링크를 포함하면 안 된다.
  • infobox의 파라미터는 다음과 같아야 한다.
    • 번호를 붙이지 않고 장래에 사용할 수 있도록 명명되다
    • 고유 명사가 아닌 한 소문자를 사용하다
    • 인포박스가 일치하다 예를 들어 {{Infobox person}}을(를) 사용한다. birth_date=다른 많은 전기적 인포박스가 그렇듯이, 새로운 전기 인포박스가 사용하는 것은 혼란스러울 것이다, 라고 말한다. date of birth=기존 매개 변수 이름을 재사용하는 대신
    • 스네이크 케이스를 사용하십시오(예: birth_date=. 낙타 케이스가 아니다(예: birthDate=) 또는 제목 케이스(예: BirthDate=)
    • 예를 들어 밑줄을 사용하여 공백을 나타냄 birth_place= 아닌 birth-place=.
  • 지리적 좌표를 사용하는 Infobox를 사용해야 함 coordinates= 파라미터 이름으로, 파라미터 값에 {{coord} 템플릿 포함.
  • 매개변수가 해당되지 않거나 정보를 사용할 수 없는 경우에는 비워 두어야 하며, 정의되지 않은 매개변수에 대한 기본값을 제공하거나 정보를 선택적으로 숨기기 위해 템플리트를 코드화해야 한다.

불일치의 원인

특정 유형의 기사에 대해 사용할 수 있는 요약 정보의 불일치를 야기할 수 있는 요인은 다음과 같다.

설계 불일치
인포박스, 특히 동일한 기사 범주에 대한 인포박스 포크는 특히 레이아웃, 색상 및 구조와 관련하여 관련 인포박스와 일관된 외관을 유지해야 한다. 예를 들어, 독자들런던뉴욕 시의 기사를 볼 때 어느 정도의 유사성을 기대한다.
역사적 불완전성
원하는 어떤 정보는 시간이 지남에 따라 간단히 손실되었을 수 있다. 예를 들어, 현대 은행을 기술하는 인포박스는 중세 은행에서는 사용할 수 없는 특정 금융 정보를 제공할 수 있다.
계층 불일치
계층적 관계를 나타내는 인포박스는 기사의 주제가 있는 계층의 위치에 따라 미묘하게 다른 요건을 가질 수 있다. 예를 들어, 모회사를 설명하는 글과 그 자회사를 나타내는 글과 그 자회사를 설명하는 글과 그 자회사를 설명하는 글과 그 모회사를 나타내는 글 사이에는 기업을 위한 인포박스가 다를 것이다.
기능 불일치
단일 집합 내의 항목은 일반적으로 infobox에 나열되는 선택적 특징을 가질 수 있다. 예를 들어, 대학에 관한 기사에 대한 infobox는 모토를 포함할 수 있지만, 모든 대학이 모토를 가지고 있는 것은 아니다.
정보 부족
앨범이나 영화의 제작자와 같이, 인포박스에 있는 일부 품목들은 쉽게 구할 수 없거나 아예 구할 수 없을 수도 있다. 이 경우 정보를 사용할 수 없는 필드를 숨기면서 사용 가능한 정보를 제공하는 것이 좋다.

일반 설계 고려사항

선택적 필드의 가용성은 모든 필드가 선택적 필드로 되어야 한다는 것을 의미하지 않으며, infobox 템플릿의 레이아웃과 사용 편의성을 고려하지 않고 거의 사용되지 않는 필드가 많이 추가되어야 한다는 것을 의미하지 않는다. 필드의 마크업이 표시되지 않더라도 여전히 다운로드가 필요한 경우도 있다. 관련 없는 필드가 많은 지나치게 긴 템플릿을 만드는 것은 권장되지 않는다.

Infobox 템플릿을 설계할 때 다음 질문을 고려하십시오.

그 분야가 가치있는가?
인포박스를 사용할 기사에 필드가 얼마나 중요한가? 그것은 요약 정보인가, 아니면 기사의 본문 내에 더 잘 배치될 수 있는 더 확장된 세부사항인가?
이 분야가 인포박스를 사용할 많은 기사와 관련이 있을까?
만약 그 분야가 아주 적은 수의 기사와 관련이 있다면, 그것은 아마도 전혀 포함되지 말아야 할 것이다. 반대로, 매우 일반적인 분야는 해당 기사의 일부에 해당되지 않더라도 포함되고 선택적으로 만들어질 수 있다.
필드가 비어 있을 가능성은 얼마나 되는가?
합리적으로 비어 있을 수 있는 모든 필드는 선택사항이어야 한다. 그러나 일반적으로 비어 있는 필드는 특별히 유용하거나 관련이 없을 수 있다.
필드 이름을 다른 곳에서 다시 사용할 수 있는가?
예를 들어, 피사체가 사망한 날짜에 대한 필드를 전기적 인포박스 템플릿에 추가하는 경우 death_date= {{Infobox person}}부터, 비슷한 이름이 아닌 date_of_death= 또는 died=.
그것은 사람, 장소 또는 조직을 위한 것인가?
그렇다면 hCard 마이크로포맷을 포함하십시오. 마이크로포맷 프로젝트를 참조하십시오.
날짜가 적힌 이벤트용인가요?
(예: 레코드 릴리스 또는 스포츠 고정장치) 그렇다면 hCalendar 마이크로포맷을 포함하십시오. 마이크로포맷 프로젝트를 참조하십시오.

지리적 인포박스

명칭(예: 몬테네그로 몬테네그로 몬테네그로 공화국)의 공식 버전은 대체될 수 있지만, 지리적 항목(예: 도시 및 국가)의 인포박스는 일반적으로 기사 제목과 함께 헤딩되어야 한다. 기사 제목이 모호한 경우, 주제가 명확하다면(예: 상파울루(주)상파울루)의 상파울루(상파울루)가 일반 명칭으로 인포박스를 이끌 수 있다. 대체적인 이름이나 토착적인 이름들은 유익하다면 이것 아래에 나타날 수 있다. 아우크스부르크에서처럼 광범위한 역사적 명칭이 종종 두 번째 인포박스에서 더 낫다.

동적 템플릿

이론적으로, infobox의 분야는 그것을 사용하는 모든 기사에 걸쳐 일관되어야 한다. 그러나, 실제로, 이것은 드문 경우로, 여러 가지 이유 때문이다. Infobox 템플릿은 특정 필드의 부재 또는 존재에 동적으로 적응하도록 설계되어야 한다.

정적 인포박스와 마찬가지로, 유사한 주제가 균일한 외관과 공통적인 형식을 갖도록 기사의 주제에 대한 요약 정보를 제시하도록 설계되었다. 그러나 템플리트 기법은 템플리트 페이지인 중앙 플레이스에서 스타일과 일반 텍스트의 업데이트를 허용한다.

동적 Infobox에는 여러 개의 (포크된) 템플릿을 사용하거나 필드를 공백으로 두는 것과 같은 여러 가지 대안이 있지만, 다음과 같은 여러 가지 이유로 이러한 옵션은 피해야 한다.

독자가 편집자 수보다 훨씬 많다.
가장 중요하게 고려해야 할 그룹은 위키피디아의 일상적인 독자들인데, 그들은 결코 중요한 편집을 하지 않을 것이다. 많은 빈 필드, 물음표 또는 "알 수 없음"이 포함된 Infobox 템플릿은 전문적이지 않은 모습을 나타낸다.
아티클 편집기가 템플릿 편집기를 크게 능가함
평균 편집자는 템플릿을 변경하지 않고 사용할 뿐이다. 그들에게 더 쉽게 하기 위해, 우리는 그들이 친숙해야 하는 다른 템플릿의 수를 최소화하는데 목표를 두어야 한다. 따라서 템플릿의 여러 포크를 만드는 것은 바람직하지 않다.

요구 사항

새 인포박스를 설계하기 전에 새 인포박스의 요구 사항을 평가하십시오. 새로운 Infobox를 시작하는 동안 몇 가지 사항을 고려해야 한다.

  1. 충분하고 적절한 구별되는 매개변수
  2. 기존 인포박스로 해결할 수 없음
  3. 기존 Infobox의 래퍼를 만들어 해결할 수 없음

구현

템플릿에 새 Infobox 템플릿 기반 설정:인포박스는 디자이너가 어떤 분야를 포함시킬지 집중하게 한다. 특정 필드에 대한 가치가 없는 글의 행에 대한 기본 스타일링과 억제와 같은 기능이 자동으로 처리된다.

조건부 템플릿

파서 함수는 하나 이상의 템플릿 매개 변수의 값에 기초하여 Infobox 내에서 특정 내용(예: 테이블 행)을 선택적으로 표시하거나 숨기는 데 사용할 수 있다.

예를 들어, 매개변수는 다른 매개변수가 존재하는 경우에만 표시되도록 설계될 수 있다. 이미지가 있는 경우에만 캡션을 표시하는 간단한 테스트는 다음과 같을 수 있다.

  캡션 = {{#if:{{{{image }}}{{{message }}}}}}}} 

이름 분해된 메타 템플릿

여러 하위 템플릿(및 독립 템플릿)에는 공통 이름 접두사가 있다. 그것들은 이름 접미사 역할을 하는 특정 매개변수의 값에 기초하여 infobox에 포함된다. 예를 들어, 우리는 창조한다. {{Infobox Ship/Military}} 그리고 {{Infobox Ship/Civilian}} 사용하다 {{Infobox Ship/{{{type}}}}}. 사용 type=Military 어떤 기사에서. {{Infobox Ship/Military}} 사용할 수 있는

멀티 파트 인포박스

각 필드가 하나의 템플릿의 매개 변수에 해당하는 것이 아니라, infobox는 각 필드의 개별 하위 템플릿으로 구성된다. 예를 들어, 템플릿:택소박스.

여러 템플릿 간의 상호 작용

템플릿은 다양한 조합이 가능하도록 모듈식으로 설계할 수 있다. 조합은 심지어 페이지에 단일 인포박스로 나타날 수도 있다.

예를 들어 Wiki Project Saints 그룹이 정적 infobox를 기반으로 템플릿을 설계하려면 Template:Infobox Livengy를 사용하여 추가 정보만 있는 프로젝트별 템플릿을 설계하고, 페이지들은 두 개의 "스택된" 페이지를 함께 렌더링할 것이다.

아티클에 infobox 사용

어떤 물품에도 인포박스의 사용이 요구되거나 금지되지 않는다. 어떤 infobox를 포함시킬지, 어떤 infobox를 사용할지는 각각의 개별 기사에서 편집자들 간의 토론과 합의를 통해 결정된다.

각 infobox 부분에 주어진 의미는 해당 infobox 유형의 인스턴스 간에 동일해야 한다. 예를 들어 특정 Infobox 유형의 경우, 해당 필드 중 하나를 "체중"이라고 하는 경우, 이 필드를 사용하여 "태생시 체중" 및 다른 때 "만성시 체중"을 나타내는 것은 적절하지 않을 수 있다.

각 인포박스 형식에는 각 부품/필드 사용 방법에 대한 지침을 제공하는 문서가 있어야 한다.

내비게이션 템플릿과 마찬가지로 Infobox는 플래그 아이콘을 피해야 한다. 플래그 아이콘에 대한 자세한 내용은 MOS:FLAG를 참조하십시오.

infobox의 참조

참고문헌은 경우에 따라 허용되지만, 다른 곳에서 내용을 반복(그리고 인용)하거나 정보가 명백하다면 일반적으로 infobox에서는 필요하지 않다. 재료에 참조가 필요한 경우(WP:가이드라인에 대한 MINREF) 및 해당 정보는 기사의 본문에도 나타나지 않으며, 참고문헌은 infobox에 포함되어야 한다. 그러나 편집자들은 먼저 기사의 본문에 그 사실을 포함시키는 것을 고려해야 한다.

인포박스의 민족성

위키백과 커뮤니티는 이 RfC에서 이 언어의 사용을 허용하지 않기로 결정했다. ethnicity = infobox의 매개 변수.

국적 및 시민권

대부분의 전기 인포박스는 국적과 시민권을 가지고 있다. 일반적으로 주체가 속한 국가를 다음과 같이 지정한 출생 국가로부터 유추할 수 있는 경우에는 둘 중 하나를 사용하지 않아야 한다. birthplace=.

예를 들어, 출생 후 국적이 변경되어 필요할 때, 이중 "시민권" 또는 다른 특이한 시나리오가 사용된다. nationality= ~하지 않는 한 citizenship= 흔치 않은 법적 이유로 인해 더 적절하다. 국적과 시민권을 동시에 사용하는 것은 필요할 경우 드물어야 한다(복잡한 경우는 기사 산문에서 설명해야 한다). 어느 분야도 민족성을 규정하는 데 사용해서는 안 된다.

Infobox 및 사용자 스타일

사용자는 자신의 브라우저에 어떤 인포박스를 숨기는 사용자 CSS를 가질 수 있다.

모든 Infobox를 숨기려면 Special에 다음을 추가하십시오.MyPage/common.css(모든 스킨 또는 특수:현재 피부만을 위한 MyPage/skin.css) 자체:

.인포박스 { 전시하다: 없는; } 

또는 common.js 또는 Greasemonkey와 같은 확장에 의해 실행되는 브라우저 사용자 스크립트에 다음 코드를 추가하십시오.

$('.인포박스').숨기(); 

infobox의 모든 정보는 기사의 본문에서도 이상적으로 발견되어야 하지만, 이 가이드라인을 완벽하게 준수하지는 않는다는 점에 유의하십시오. 예를 들어, 의 전체 분류 체계 계층 구조 {{Taxobox}}, 및 OMIM 및 기타 의료 데이터베이스 코드 {{Infobox disease}} 주요 기사 내용에 없는 경우가 많다. 인포박스는 또한 종종 기사에서 가장 중요하고 고른, 유일한 이미지의 위치이기도 하다.

참고 항목

템플릿 목록

기타 infobox 정보

다른 유형의 템플릿