틀:국가자료/설명문서

이 틀은 깃발 틀 시스템에서 사용되는 국가 데이터 메타 틀을 문서화하는 데 사용된다. 이 틀의 출력은 분류:나라자료 틀에 있는 틀을 직접 봄으로써 확인할 수 있다.

사용법

이 틀은 각 나라자료 틀의 표준 구문을 통해 자동으로 호출된다.

{{ {{{1<noinclude>|country showdata</noinclude>}}}
| alias = Countryname
| shortname alias = Shortcountryname  <!-- Shortcountryname ≠ Countryname인 경우에만 필요하며, 그렇지 않으면 생략 -->
| flag alias = Flag of Countryname.svg.png
| size = {{{size|}}}
| name = {{{name|}}}
| variant = {{{variant|}}}  <!-- 하나 이상의 flag alias-variant 매개변수가 있는 경우에만 필요하며, 그렇지 않으면 생략 -->
}}

나라자료 틀의 첫 번째 매개변수는 일반적으로 포맷 메타 틀의 이름이다. 예를 들어, 틀:국기는 틀:국기/구현 틀을 사용하여 실제로 국기그림과 위키링크를 렌더링한다. 나라자료 틀이 직접 볼 때처럼 첫 번째 매개변수가 누락된 경우, 틀 코드 중 {{{1<noinclude>|country showdata</noinclude>}}}는 이 틀이 기본 첫 번째 매개변수로 사용되도록 한다. 이 기술은 나라자료 틀이 표준 구문을 사용하는 경우 "자체 문서화"되도록 보장한다.

추가 매개변수

많은 나라자료 틀은 표준에서 필수적으로 들어가야 하는 alias 및 flag alias 매개변수 외에 추가 문서화가 필요하다. 이 틀은 표준 선택적 매개변수(예: shortname alias)가 있는 경우 이를 감지해 자동으로 문서화하며, 지시하는 경우 고유한 선택적 매개변수(예: 군사 관련 깃발)를 문서화할 수 있다. 후자의 방법은 나라자료 틀의 문서화 특정 매개변수를 사용하여 이 틀에서 추가로 출력할 수 있다. 이 문서화 매개변수는 나라자료 틀의 나머지 매개변수와 <noinclude> 문단으로 다음과 같이 구분한다.

<noinclude>
| var1 = ...
| redir1 = ...
| related1 = ...
</noinclude>

머리말

간략한 머리말이 필요한 경우, 기존 머리말 틀 중 하나와 함께 |hatnote= 매개변수를 포함하여 문서화 페이지 상단에 추가할 수 있다.

그 예시로 다음과 같다.

|hatnote={{Hatnote|이 틀은 주권국인 [[아일랜드 공화국]]에 관한 나라자료 틀입니다. [[아일랜드]] 섬 전체에 대한 나라자료는 [[틀:나라자료 아일랜드]]를 참고하세요.}}

출력 결과는 다음과 같다.

기 변수

기 변수는 하나 이상의 flag alias-label 매개변수를 넣어 나라자료 틀에 추가하면 된다. 여기서 각 label은 나중에 {{국기|...}}, {{국기그림|...}} 등의 입력 매개변수로 사용되는 고유 식별자이다. 이 변수를 문서화하려면 varN 문서화 매개변수를 사용하여 각 레이블을 식별할 수 있도록 이름을 붙이면 된다.

예를 들어, 틀:나라자료 세이셸은 (현재 깃발 외에) 세 가지 변수를 다음 코드를 통해 정의한다.

| flag alias-1976 = Flag of the Seychelles 1976.svg.png
| flag alias-1977 = Flag of the Seychelles 1977.svg.png
| flag alias-colonial = Government Ensign of the United Kingdom.svg.png

이 세 추가 깃발은 틀의 아래 부분에 다음 코드로 문서화된다.

<noinclude>
| var1 = 1976
| var2 = 1977
| var3 = colonial
...
</noinclude>

이 방법으로 최대 40개의 기 변수를 문서화할 수 있다(var1에서 var40까지 사용). 더 많은 변수가 있는 경우 아래 설명된 대로 별도의 문서화 하위 문서에 나열할 수 있다.

표준 선택적 변수 레이블인 naval, air force, army(각각 국가의 해군, 공군, 육군기에 사용됨)에는 varN 매개변수를 사용할 필요가 없다. 이들이 존재하면 자동으로 문서화된다.

넘겨주기 변수

많은 나라자료 틀은 일반적인 국가 이름 대신 주요 깃발 틀과 함께 사용할 수 있는 별칭 이름을 가지고 있다. 이들은 주로 ISO 3166-1 alpha-3, IOC 국가 코드 목록, FIFA 국가별 코드 목록에 지정된 표준 국가 코드 약어이지만 이에 국한되지는 않는다.

관련 틀

몇몇 국가 데이터 틀은 국가의 일반적인 국가 데이터 틀에 대한 대체 형태로 사용되며 주로 역사적인 국가에 사용되지만, 이에 국한되지는 않는다. 이러한 대체 틀에 대한 포인터는 편집자가 특정 목적에 맞는 올바른 틀을 사용할 수 있도록 틀 문서에 추가 사항으로 기재할 수 있다.

예를 들어, 틀:나라자료 세르비아 몬테네그로는 다른 세 가지 관련 국가 데이터 틀을 문서화하기 위해 다음 코드가 있다.

<noinclude>
...
| related1 = 세르비아
| related2 = 몬테네그로
| related3 = 유고슬라비아
...
</noinclude>

이 방법으로 최대 40개의 관련 깃발을 문서화할 수 있다 (related1에서 related40까지 사용).

깃발 문서 링크

이 틀은 문서 상자 오른쪽에 큰 깃발 이미지를 표시하며, 그림 설명에 깃발에 대한 문서가 있는 경우 해당 문서로 연결되는 링크가 있다. 평가하는 문서는 "의 국기"이며, 틀 코드의 |alias= 값이 를 대체한다. "의 국기"가 존재하지 않더라도 깃발에 대한 문서가 있는 경우, 후자를 올바른 페이지로 넘겨주기로 만들거나 다음 매개변수를 추가해 이어줄 수 있다.

<noinclude>
...
| flag link = 문서 이름
...
</noinclude>

"의 국기" 문서가 존재하지만 잘못된 문서로 연결되는 경우에도 자동 링크를 재정의하는 데 사용할 수 있다.

추가 문서화

자동 문서화 방법이 완전히 적절하지 않은 상황의 경우, 나라자료를 통해 추가 문서를 표시할 수 있다. 추가 자료가 포함된 문서 하위 페이지(틀:나라자료 "나라이름"/설명문서으로 명명)를 만들기만 하면 자동 문서화의 끝 부분 또는 그 근처에 "기타 정보"라는 섹션에 포함된다. 이 "추가" 문서 페이지는 국가 데이터 틀이 편집 보호되어 있어도 일반적으로 편집할 수 있다.