틀:설명문서/설명문서: 두 판 사이의 차이

2019년 3월 11일 (월) 21:05 기준 최신판

틀:설명문서의 설명문서입니다.

틀 사용 방법에 대한 설명과 틀 분류 등이 들어있습니다.

여기는 {{설명문서}} 틀입니다.

이 틀을 이용해서 틀에 설명을 다는 자세한 방법은 위키백과:틀 설명문서를 참고하세요.

이 틀은 지금 보는 것과 같은 녹색 상자 안에 자동으로 "/설명문서"의 내용을 가져와서 보여줍니다.

사용법[원본 편집]

대개의 경우 이 틀은 아무런 매개 변수 없이, 틀의 아랫부분에 <noinclude> 및 </noinclude>로 둘러싸서 씁니다.

<!--작성한 원래 틀의 내용--><noinclude>

{{설명문서}}
<!-- 분류는 /설명문서 안에 넣어주세요. -->
</noinclude>

그러면 틀은 자동으로 "/설명문서" 안의 내용을 불러서 보여줍니다.

다른 틀의 설명을 불러다가 보여줄 수도 있습니다:

<!--작성한 원래 틀의 내용--><noinclude>

{{설명문서|틀:다른 틀/설명문서}}
</noinclude>

다른 틀의 설명문서를 불러들일 때는 분류 처리에 신경을 써야 합니다.

설명을 직접 달 수도 있습니다.:

<!--작성한 원래 틀의 내용--><noinclude>

{{설명문서
| 내용 = 틀에 관한 설명.
}}
</noinclude>

내용= 변수가 사용되면, 오른쪽 위의 [편집] [새로 고침] 상자는 보이지 않습니다. 만약 "/설명문서" 하위문서가 존재하면 상자 아래에 링크는 표시됩니다.

필요에 따라서 첫 변수와 내용 변수를 다음처럼 함께 사용할 수도 있습니다:

<!--작성한 원래 틀의 내용--><noinclude>

{{설명 문서
| 1 = 틀:다른 틀/설명문서
| 내용 = {{틀:다른 틀/설명문서|변수}}
}}
</noinclude>

두 변수가 함께 사용되면, 1에 주어진 문서 이름을 이용해서 [편집] [새로 고침] 링크가 나타나며, 상자 안의 내용은 "내용 ="의 내용이 표시됩니다. 위의 예에서는 내용 변수에 "{{틀:다른 틀/설명문서|변수}}"의 내용이 불러들여집니다.

좋은 습관[원본 편집]

이 틀을 부르는 코드는 원래 틀의 내용 아래에 "<noinclude>" 앞의 공백 없이 바로 붙여주면 됩니다. (공백이 있을 경우, 틀을 부르는 곳에서 원치 않는 공백이 추가됩니다.)

틀 자체를 위한 분류는 "/설명문서"의 아랫 부분에 <includeonly></includeonly> 태그로 감싼 부분에 넣으면 됩니다. 보다 복잡한 예는 위키백과:틀 설명문서#분류와 인터위키를 참고하세요.

만약 설명문서 안에서 <includeonly>나 <noinclude> 태그를 설명문 안에 표시해줄 필요가 있다면, "<"를 "<", ">"를 ">"로 바꿔주세요.

제목[원본 편집]

틀 이름공간 안에서 이 틀이 사용되면, 다음과 같은 제목이 표시됩니다:

틀 설명문서

다른 문서, 예컨대 "위키백과:"나 "사용자:" 문서에서는 다음과 같이 표시됩니다:

설명문서

파일 (그림) 문서에서는 다음과 같이 표시됩니다:

요약

제목 변수를 이용하여 제목에 표시되는 내용을 바꿀 수 있습니다:

{{설명문서| 제목 = 정보상자 설명문서 }}

만약 제목 변수가 아무 내용없이 사용되면 아무 제목도 표시되지 않고, [편집] [새로 고침]도 표시되지 않습니다:

{{설명문서| 제목 = }}

제목-모양 변수를 이용하여 CSS 값을 추가할 수 있습니다. 따옴표(" ")는 없어야 하며, 마지막 반쌍점(;)은 있어야 합니다. 예를 들면:

heading-style = color: red; font-size: 150%;

연결 상자[원본 편집]

설명 상자 아래에는 설명문서에 관한 메타 정보가 표시됩니다. 틀을 부를 때의 변수와 이름공간에 따라 링크 상자 안의 표시 내용은 조금씩 다를 수 있습니다. 경우에 따라서는 연결 상자가 표시되지 않을 수도 있습니다.

연결 상자를 숨기려면, 변수에 "|연결상자 = off"를 추가하세요.

연결상자 변수를 이용해서 이 틀에 추가적인 내용을 넣을 수 있습니다. 예를 들면:

|연결상자=이 설명은 [[틀:나라자료/설명문서]]를 이용해서 자동으로 만들었습니다.

자동 기능[원본 편집]

틀 설명문서가 없다면, [만들기] 링크를 눌러서 기본적인 내용이 채워진 설명문서 초안을 로드할 수 있습니다. "/연습장"과 "/시험장"도 없을 경우 [만들기] 링크를 누르면 기본적이 내용이 채워집니다.

틀이 보호되었을 경우에는 자동으로 {{보호-틀}} 틀을 불러들여 오른쪽 위에 회색 또는 붉은색 자물쇠를 보여줍니다. 따로 틀이나 틀 설명문서 안에 {{보호}} 틀을 넣을 필요가 없습니다.

이 틀이 "/연습장"에서 불릴 경우, 자동으로 {{틀 연습장 안내}} 틀의 내용을 보여줍니다.

기본정렬 값을 {{PAGENAME}}으로 설정합니다. 따라서 틀 설명문서 안에서 틀 분류에 일일이 정렬 값을 적지 않아도 됩니다.

넘겨주기[원본 편집]

같이 보기[원본 편집]

이 틀 문서는 한국어 위키백과에서 분기하였습니다.

• 현재 페이지 URL 줄이기

@@ 1번째 줄: / 1번째 줄: @@
-{{틀 설명 소개하기}}<onlyinclude><includeonly>{{틀 설명 연결하기}}</includeonly>
+{{설명문서 안내}}
 <!-- 이 줄 아래부터 틀 설명문서를 작성하십시오. -->
-이 틀은 보시고 계시는 바와 같이 "틀 설명문서" 상자(box)를 디스플레이 해줍니다.
+여기는 {{틀|설명문서}} 틀입니다.
+이 틀을 이용해서 틀에 설명을 다는 자세한 방법은 [[위키백과:틀 설명문서]]를 참고하세요.
+이 틀은 지금 보는 것과 같은 녹색 상자 안에 자동으로 "/설명문서"의 내용을 가져와서 보여줍니다.
 == 사용법 ==
-# 틀에 <code>&#123;{틀 설명문서}&#125;</code>를 추가해 줍니다.
+대개의 경우 이 틀은 아무런 매개 변수 없이, 틀의 아랫부분에 <code>&lt;noinclude></code> 및 <code>&lt;/noinclude></code>로 둘러싸서 씁니다.
-# "편집" 버튼을 누릅니다. <tt>/설명문서</tt>라는 하위 문서로 연결됩니다. 그 문서에 설명을 적습니다.
-# 뿐만 아니라 분류 및 인터위키도 <tt>/설명문서</tt> 하위 문서에 적습니다. 이 때<code>&lt;includeonly&gt;&lt;/includeonly&gt;</code> 안에 분류 및 인터위키를 적습니다.
+<source lang="xml+smarty">
+<!--작성한 원래 틀의 내용--><noinclude>
+{{설명문서}}
+<!-- 분류는 /설명문서 안에 넣어주세요. -->
+</noinclude>
+</source>
+그러면 틀은 자동으로 "/설명문서" 안의 내용을 불러서 보여줍니다.
+다른 틀의 설명을 불러다가 보여줄 수도 있습니다:
+<source lang="xml+smarty">
+<!--작성한 원래 틀의 내용--><noinclude>
+{{설명문서|틀:다른 틀/설명문서}}
+</noinclude>
+</source>
+다른 틀의 설명문서를 불러들일 때는 분류 처리에 신경을 써야 합니다.
+설명을 직접 달 수도 있습니다.:
+<source lang="xml+smarty">
+<!--작성한 원래 틀의 내용--><noinclude>
+{{설명문서
+| 내용 = 틀에 관한 설명.
+}}
+</noinclude>
+</source>
+'''내용=''' 변수가 사용되면, 오른쪽 위의 [편집] [새로 고침] 상자는 보이지 않습니다. 만약 "/설명문서" 하위문서가 존재하면 상자 아래에 링크는 표시됩니다.
+필요에 따라서 첫 변수와 '''내용''' 변수를 다음처럼 함께 사용할 수도 있습니다:
+<source lang="xml+smarty">
+<!--작성한 원래 틀의 내용--><noinclude>
-== 더 자세히! ==
+{{설명 문서
-만드신 틀의 끝에다가 다음 내용을 추가해 줍니다:
+| 1 = 틀:다른 틀/설명문서
-<pre><nowiki>
+| 내용 = {{틀:다른 틀/설명문서|변수}}
-&lt;onlyinclude>[틀의 모든 내용]</onlyinclude>
+}}
- {{틀 설명문서}}
+</noinclude>
-</nowiki></pre>
+</source>
-틀이 "보호"된 상태라면 [[위키백과:관리자|관리자]]에게 이 작업을 요청해 주십시오. 혹은 토론란에 글을 남겨 주십시오. 만약 문서화된 틀 설명문서, 분류, 인터위키가 기존 틀 <code><nowiki><nowiki></nowiki></code>에 들어가 있었다면, 새로 만드시는 틀 설명문서에 그것들을 옮겨 주십시오. 문서화된 틀 설명문서가 두 군데 모두에 있을 필요는 없으니까요.
+두 변수가 함께 사용되면, '''1'''에 주어진 문서 이름을 이용해서 [편집] [새로 고침] 링크가 나타나며, 상자 안의 내용은 "내용 ="의 내용이 표시됩니다. 위의 예에서는 '''내용''' 변수에 "<code><nowiki>{{틀:다른 틀/설명문서|변수}}</nowiki></code>"의 내용이 불러들여집니다.
-"/설명문서" 하위 문서를 가리키는 "편집" 고리를 눌러, 틀 설명문서를 편집해 주십시오. /설명문서 문서가 아직 존재하지 않을 경우 {{tl|틀 설명문서/미리싣기}} 문서가 {{언어고리|en}}[[mw:Extension:Inputbox#Preload|미리싣기]]됩니다.
+== 좋은 습관 ==
+이 틀을 부르는 코드는 원래 틀의 내용 아래에 "<code>&lt;noinclude></code>" 앞의 공백 없이 바로 붙여주면 됩니다. (공백이 있을 경우, 틀을 부르는 곳에서 원치 않는 공백이 추가됩니다.)
-분류나 인터위키는 <tt>/설명문서</tt> 안의 <code>&lt;includeonly&gt;&lt;/includeonly&gt;</code>로 둘러싸인 곳에 추가해 주십시오.
+틀 자체를 위한 분류는 "/설명문서"의 아랫 부분에 <code>&lt;includeonly>&lt;/includeonly></code> 태그로 감싼 부분에 넣으면 됩니다. 보다 복잡한 예는 [[위키백과:틀 설명문서#분류와 인터위키]]를 참고하세요.
-== 주의! ==
+만약 설명문서 안에서 &lt;includeonly>나 &lt;noinclude> 태그를 설명문 안에 표시해줄 필요가 있다면, "<code>&lt;</code>"를 "<code>&amp;lt;</code>", "<code>&gt;</code>"를 "<code>&amp;gt;</code>"로 바꿔주세요.
-설명문서의 파이프 문자가 이중 혹은 삼중 물결표로 감싸지지 않거나 이중 꺾쇠표로 감싸지지 않았다면 이 틀은 제대로 작동하지 않습니다. 설명문서 전체가 틀에 포함되기 때문입니다. 이럴 경우에는 파이프 문자 대신 &amp;#124; 를 사용하십시오.
-만약 틀 설명문서가 nowiki 태그 안에 includeonly 혹은 noinclude를 포함하고 있을 경우에는, 그 부분의 "<"와 같은 것들을 "&amp;lt;"로 바꾸어 주십시오.
+== 제목 ==
+틀 이름공간 안에서 이 틀이 사용되면, 다음과 같은 제목이 표시됩니다:
+:[[파일:Template-info.svg|32px]] '''틀 설명문서'''
-== 같이 보기 ==
+다른 문서, 예컨대 "위키백과:"나 "사용자:" 문서에서는 다음과 같이 표시됩니다:
-* {{tl|틀 설명 연결하기}}
+:'''설명문서'''
-* {{tl|틀 설명 소개하기}}
-* {{tl|틀 설명문서/미리싣기}}
+파일 (그림) 문서에서는 다음과 같이 표시됩니다:
+:'''요약'''
+'''제목''' 변수를 이용하여 제목에 표시되는 내용을 바꿀 수 있습니다:
+:<code><nowiki>{{설명문서| 제목 = 정보상자 설명문서 }}</nowiki></code>
+만약 '''제목''' 변수가 아무 내용없이 사용되면 아무 제목도 표시되지 않고, [편집] [새로 고침]도 표시되지 않습니다:
+:<code><nowiki>{{설명문서| 제목 = }}</nowiki></code>
+'''제목-모양''' 변수를 이용하여 [[CSS]] 값을 추가할 수 있습니다. 따옴표(<code>" "</code>)는 없어야 하며, 마지막 반쌍점(<code>;</code>)은 있어야 합니다. 예를 들면:
+:<code>heading-style = color: red; font-size: 150%;</code>
+== 연결 상자 ==
+설명 상자 아래에는 설명문서에 관한 메타 정보가 표시됩니다. 틀을 부를 때의 변수와 이름공간에 따라 링크 상자 안의 표시 내용은 조금씩 다를 수 있습니다. 경우에 따라서는 연결 상자가 표시되지 않을 수도 있습니다.
+연결 상자를 숨기려면, 변수에 "<code>|연결상자 = off</code>"를 추가하세요.
+'''연결상자''' 변수를 이용해서 이 틀에 추가적인 내용을 넣을 수 있습니다. 예를 들면:
+<pre>|연결상자=이 설명은 [[틀:나라자료/설명문서]]를 이용해서 자동으로 만들었습니다.</pre>
+== 자동 기능 ==
+틀 설명문서가 없다면, [만들기] 링크를 눌러서 기본적인 내용이 채워진 설명문서 초안을 로드할 수 있습니다. "/연습장"과 "/시험장"도 없을 경우 [만들기] 링크를 누르면 기본적이 내용이 채워집니다.
+틀이 보호되었을 경우에는 자동으로 {{틀|보호-틀}} 틀을 불러들여 오른쪽 위에 회색 또는 붉은색 자물쇠를 보여줍니다. 따로 틀이나 틀 설명문서 안에 {{틀|보호}} 틀을 넣을 필요가 없습니다.
+이 틀이 "/연습장"에서 불릴 경우, 자동으로 {{틀|틀 연습장 안내}} 틀의 내용을 보여줍니다.
+기본정렬 값을 {{<nowiki></nowiki>PAGENAME}}으로 설정합니다. 따라서 틀 설명문서 안에서 틀 분류에 일일이 정렬 값을 적지 않아도 됩니다.
-<includeonly>
+== 넘겨주기 ==
-<!-- 이 줄 아래부터 추가로 분류를 작성하십시오. -->
+*{{틀|Documentation}}
-[[분류:내부 고리용 틀|틀 설명문서]]
+*{{틀|Template doc}}
-[[분류:틀 이름공간 틀|틀 설명문서]]
+*{{틀|Documentation, template}}
+*{{틀|Doc}}
+*{{틀|틀 설명문서}}
-<!-- 이 줄 아래부터 인터위키를 작성하십시오. -->
+== 같이 보기 ==
+* {{틀|설명문서 안내}}
+* [[위키백과:틀 설명문서]]
+* {{틀|틀 연습장}}
-[[de:Vorlage:Dokumentation]]
+<noinclude>
-[[en:Template:Documentation]][[eo:Ŝablono:Dok]]
+{{분기}}
-[[es:Plantilla:Uso de plantilla]]
+</noinclude>
-[[fr:Modèle:Documentation modèle]]
-[[hsb:Předłoha:Doc]]
-[[hu:Sablon:Sablondokumentáció]]
-[[ja:Template:Documentation]]
-[[nl:Sjabloon:Sjabdoc]]
-[[pt:Predefinição:Instruções da predefinição]]
-[[ru:Шаблон:Doc]]
-[[sl:Predloga:Dokumentacija]]
-[[uk:Шаблон:Doc]]
-[[zh:Template:Template doc]]
+<includeonly>
+[[분류:틀 설명문서용 틀| ]]
 </includeonly>
-</onlyinclude>