Jump to content

Help:Transclusion

This is a fully translated help. Click here for more information.
From DawoumWiki, the free Mathematics self-learning

전달-삽입은 일반적으로 참조로써 다른 문서에 콘텐츠를 포함시키는 것을 말합니다. 위키피디아 문맥에서는, 미디어위키의 템플릿 기능을 사용하여 여러 문서에 각각을 별도로 편집할 필요없이 동일한 내용을 포함할 수 있습니다. 템플릿 transclusion는 템플릿 메시지를 사용하는 일반적인 방법이며, 템플릿 태그를 사용하여 구현되며, 다음과 같은 형태입니다:

{{template name}}

때로는 템플릿을 사용하기를 원할 수도 있지만, 한가지 또는 다른 이유로 인해 transclusion를 사용하지 않을 수도 있습니다. 템틀릿 태그 위치에 템플릿 코드/텍스트의 일회성 자동 복사하는 것을 Template substitution 또는 subclusion (substitution + transclusion)라고 부릅니다. 템플릿의 코드/텍스트를 subclude하기 위해서는, 템플릿 태그가 표준 transclusion 태그에서 substitution 태그로 수정되어야 하는데, 단순히 subst:를 추가하여, {{subst:template name}} 형식의 태그를 만듭니다.

How transclusion works

템플릿 구문

만약 소스가 주요 기사 이름 공간에 있는 경우에는(예를 들어, "Kernel"), 이름 앞에 콜론 (:)을 반드시 넣어야 합니다, 그러므로: {{:Kernel}}

만약 소스가 템플릿 이름 공간에 있는 경우에는(예를 들어, "Template:Note"), 단독으로, 이름 그 자체를 사용하십시요, 그러므로: {{Note}}

만약 소스가 다른 이름 공간 있으면(예를 들어, "User:Utpark"), 이름 공간을 포함한, 전체 이름을 반드시 사용해야 합니다, 그러므로: {{User:Utpark}}

다른 타겟 페이지 내의 모든 소스 페이지(en:Wikipedia에서 처럼, 단일 미디어위키 프로젝트 내에서)를 transclude하려면, 다음 코드를 포함하십시오:

{{SOMEPAGE}}

이런 코드가 있는 타겟 페이지 A가 렌더링될 때마다, 엔진은 코드 자체가 아닌, 소스 페이지 B, SOMEPAGE의 전체 내용을 그 위치에 포함시킵니다.

예를 들어, 모든 신규 사용자의 토론 페이지에 환영 메시지를 남기도록 결정할 수 있습니다. Transclusion은 템플릿-페이지와 메시지가 나타날 타겟-페이지(들) 사이에 "live" 링크를 만듭니다. 템플릿이 편집될 때, 모든 타겟-페이지들도 함께 편집됩니다.

예를 들어, 우편 주소로 (템플릿) 페이지를 만들고 귀하의 페이지뿐만 아니라, 모든 친구들의 페이지에도, 해당 템플릿을 포함시키도록 결정할 수 있습니다. 텔레비전과 소파를 다른 아파트로 옮길 때, 여러분의 주소 템플릿을 바꾸면, 자동으로, 새로운 정보가 모든 친구의 페이지에 나타납니다.

Etymology

Ted Nelson은 1982년도 저술한 책, Literary Machines에서 "transclusion"과 "하이퍼 텍스트" 그리고 "하이퍼 미디어" 용어를 만들었습니다.

Partial transclusion

"noinclude", "onlyinclude" 및 "includeonly" 마크-업을 사용해서, 페이지의 전체가 아닌 일부분을 다른 페이지로 전달/포함할 수 있습니다. 이러한 부분적 transclusion은 하위 페이지와 같은 다른 페이지에서 전달/포함하여 얻을 수도 있습니다. 템플릿 문서와 같은, 일부 정보를 전달/포함하지 않는 것에 유용합니다.

summary articles의 작성을 단순화하기 위해서 이 기술을 어떻게 적용할 수 있는지에 대한 예제는, [1]을 참조하십시오. 이 기사는 여러 주요 기사로부터 전달/포함된 주요 단락 모음으로 구성됩니다.

Transclusion markup

  • noinclude. 마크-업 <noinclude>...</noinclude>

는 태그 사이의 텍스트가 다른 페이지로 전달/포함되는 것이 아니라, 페이지 자체에만 표시된다는 것을 의미합니다. 이것은 문서화에 유용합니다.

  • includeonly. 마크-업 <includeonly>...</includeonly>

는 태그 사이의 텍스트가 페이지가 다른 페이지로 전달/포함될 때만 사용되며, 페이지 자체에는 표시되지 않음을 의미합니다. 예를 들어, 템플릿 자체를 이 분류에 추가하지 않고, 템플릿을 전달/포함하는 페이지에 분류를 추가하는 경우에 유용합니다.

  • onlyinclude. 마크-업 <onlyinclude>...</onlyinclude>

는 "onlyinclude" 마크-업으로 둘러싸인 텍스트만 다른 페이지로 전달/포함되어야 함을 나타냅니다. 이것은 종종 다른 것의 권한을 덮어쓰기 때문에, 부분적으로 transclusion 태그 중에서 가장 미묘합니다. 만약 페이지에 적어도 하나의 "onlyinclude" 태그의 쌍이 있으면, 페이지가 전달/포함될 때마다 "onlyinclude" 태그 내의 자료만이 전달/포함됩니다. 그런 섹션이 여러 개 있을 수 있으므로, 각 섹션 내에서 일부 자료는 "noinclude" 태그에 의해 더 이상 포함하지 않고 제외되며, 그리고 마찬가지로 "includeonly" 태그로 둘러싸여 원래 페이지 자체에 나타나지 않을 수도 있습니다. 그러나 페이지가 다른 페이지로 전달/포함될 때 "onlyinclude" 태그 외부의 자료는 무시됩니다. 예를 들어, 두 번째 페이지에서 첫번째 페이지의 작은 부분을 반복하는 경우에 유용할 수 있습니다: 바로 onlyinclude 태그에 의해 작은 부분만 둘러싸고, 두 번째 페이지로 그것을 전달/포함시킵니다. 주목할 것은 <noinclude> 및 <includeonly> 와는 다르게 <onlyinclude> 는 <nowiki> 

태그를 둘러싸는 것보다 우선합니다. 다른 말로, <nowiki><onlyinclude>My content</onlyinclude></nowiki>

는 전달/포함될 때 "My content"만 생성합니다.

Subpages

전달/포함될 텍스트를 잘라내어 하위 페이지로 붙여 넣은 후에, transclusion 템플릿의 하위 페이지 이름을 사용할 수 있습니다. 이런 접근은 하위 페이지가 활성화된 경우에만 사용할 수 있으며, 현재에는, 메인 페이지, 도움말, 사용자 및 토론 이름 공간에서 하위 페이지를 사용할 수 있습니다.

예제: 인텔 페이지의 "xf86-video-intel" 삭제 및 리다이렉션에 대해 논의하고 싶습니다. 먼저, "Talk:Intel/delete" 하위 페이지를 작성하고, 의견을 작성한 다음 {{Talk:Intel/delete}} 템플릿를 사용하여 Talk:Intel 및 "Talk:xf86-video-intel"로 전달/포함하십시오. 두 토론 페이지에 게시하려는 의견은 양쪽 모두에 표시될 것입니다.

Special pages

Wikipedia:Wikipedia:Special pages#Miscellaneous을 함께 참조하십시요.

Special:Specialpages의 일부 페이지는 전달/포함할 수 있습니다; 예를 들어, Special:Newpages.

샘플: {{Special:Newpages/3}}는 3개의 최근의 추가된 새로운 페이지를 제공합니다.

Templates

See also

Retrieved from "https://dawoum.duckdns.org/w/index.php?title=Help:Transclusion&oldid=51192"