도움말 : 트랜스클루전

트랜스클루전이란 한 문서의 내용을 다른 문서에 참조 로 포함하는 것을 의미합니다 . Wikipedia transclusion에서 MediaWiki 소프트웨어는 다른 페이지인 대상 페이지의 콘텐츠에 포함하기 위해 템플릿 이라는 한 페이지의 콘텐츠를 참조합니다 . 페이지 이름을 이중 대괄호 안에 넣으면 페이지 이름이 링크가 되는 것과 마찬가지로 페이지 이름도 이중 중괄호 안에 넣으면 템플릿이 됩니다 . 그런 다음 템플릿에 대한 변경 사항은 해당 페이지가 포함된 모든 페이지에 자동으로 반영됩니다( 때로는 제거가 필요할 수 있음). {{Namespace:Pagename}}

템플릿의 페이지 이름이 네임스페이스로 시작하지 않으면 템플릿 네임스페이스에 있는 것으로 간주됩니다. "Main"(기사) 네임스페이스의 페이지를 참조하려면 콜론( : ) 접두사를 붙여야 합니다 . 예:

페이지에서 포함할 내용은 소스 페이지 위키텍스트에 배치된 <noinclude>, <onlyinclude> 및 <includeonly> 태그로 제어할 수 있습니다. ( 아래의 마크업 참조) 태그를 사용하면 템플릿이 부분적으로 변환될 수 있습니다. 그렇지 않으면 이중 중괄호가 항상 모든 콘텐츠를 변환합니다. 선택적 트랜스클루전을 위해 템플릿의 <includeonly> 부분에 이름이 지정되고( 파서 함수 의 도움으로) 해당 템플릿이 매개 변수 로 호출됩니다 . transcludesection=name

Transclusion 이벤트는 템플릿이 렌더링될 때 페이지가 로드 될 때마다 발생합니다. 동일한 메커니즘의 또 다른 용도는 템플릿 호출 자체를 포함된 소스 페이지로 한 번에 대체하는 것 입니다. "subst:" 접두어가 있는 템플릿 호출 은 페이지가 저장 될 때 해당 호출의 위키텍스트가 교체(대체)되기 때문에 한 번 변환되지만 다시는 변환되지 않습니다 . 일회성 템플릿 호출이었던 것은 호출 당시 템플릿의 실제 위키텍스트가 됩니다. {{fullpagename}}{{subst:fullpagename}}

트랜스클루전 작동 방식

모든 소스 페이지(en:Wikipedia와 같은 단일 MediaWiki 프로젝트 내)를 변환 하려면 대상 페이지 에서 다음 코드를 사용하십시오 .

{{SOURCEPAGE}}

{{SOURCEPAGE}}대상 페이지에 코드( )를 작성할 때마다 Wikipedia 소프트웨어에 전체 콘텐츠를 SOURCEPAGE대상 페이지에 넣도록 지시하는 것입니다.

아래 예에서 대상 페이지 A 및 SOURCEPAGE B를 살펴보십시오 .

B가 A 에 포함된 경우 Wikipedia 소프트웨어는 해당 특정 위치에 코드( ) 자체가 아니라 소스 페이지 B{{B}} 의 콘텐츠 (단지 foo 라는 단어 ) 를 포함합니다 .

맨 위 행은 대상 페이지 A , P 및 Q 가 소스 페이지 B 를 삽입하기 위해 맨 아래 행에 표시되는 코드의 변경 사항과 어떻게 보이는지 보여줍니다 . 각 예제 대상 페이지에서 코드의 위치를 ​​확인하십시오.

소스 페이지 콘텐츠 foo 는 대상 페이지에서 강조 표시되거나 상자로 표시되지 않습니다. ( 쉽게 설명하고 이해하기 위해 Foo는 밝은 파란색 상자 안에 있습니다.)

트랜스클루전-다중-foo.svg


Transclusion은 소스 페이지와 소스 페이지의 콘텐츠가 나타나는 대상 페이지 사이에 "라이브" 링크를 생성합니다. 즉, 소스 페이지를 편집하면 소스 페이지를 포함하는 모든 대상 페이지에서 콘텐츠가 업데이트됩니다. 50명의 로컬 편집자를 초대하려는 로컬 Wikimedia 이벤트의 주소, 날짜 및 시간을 사용하여 Wikipedia에서 소스 페이지를 생성한다고 가정해 보겠습니다. 다음으로 초대 소스 페이지를 자신의 토론 페이지와 다른 50명의 편집자의 토론 페이지로 변환합니다. 일주일 후 행사 장소를 옮겨야 한다는 사실을 알게 됩니다. 그런 다음 소스 페이지를 업데이트하면 다른 모든 참석자의 토론 페이지에 새 주소가 자동으로 나타납니다. 편집자에게 당신이 놓친 사람들을 초대하라고 말할 수도 있습니다.

특히 다른 소스 페이지의 삽입물이 포함된 경우 소스 페이지를 편집할 때 매우 주의해야 합니다. 소스 페이지에서 기존 트랜스클루전을 깨는 것을 파손 이라고 합니다 . 편집 중인 더 큰 소스 페이지와 이를 포함하는 모든 대상 페이지가 영향을 받으므로 파손을 피하십시오. 더 큰 소스 페이지에 콘텐츠를 추가하는 데 사용된 이미 포함된(지금은 끊어진) 소스 페이지와 포함된 소스 페이지가 포함된 모든 대상 페이지도 마찬가지입니다.

삽입 구문

Wikipedia에서 삽입 에 대한 일반적인 구문은 이며 여기서 Wikipedia 페이지의 제목을 설명합니다. {{Namespace:Pagename}}Namespace:Pagename

삽입 구문을 사용하려면 페이지 제목에 대한 약간의 지식이 필요합니다. Wikipedia에서 기사가 아닌 페이지에는 볼 수 있는 네임스페이스와 페이지 이름이 콜론으로 구분된 제목이 있습니다. 예를 들어 Wikipedia:Tips 페이지는 Wikipedia네임스페이스와 Tips페이지 이름을 가집니다 . 그러나 백과사전 기사는 제목에 눈에 보이는 페이지 이름만 있습니다. 예를 들어 Potato 기사는 Potato페이지 이름으로 있고 메인 네임스페이스라고 하는 네임 스페이스 는 보이지 않습니다.

  • 위키 텍스트는 {{Namespace:Pagename}} 제목이 있는 페이지를 변환합니다 Namespace:Pagename. 예를 들어 페이지에 위키텍스트가 있는 경우 Wikipedia:Notability{{Wikipedia:Notability}} 페이지가 포함됩니다 . 위키백과 서버에서 로 자동 변환되는 네임 스페이스 별칭 과 정확히 동일한 작업을 수행 합니다 .{{WP:Notability}}WP:Wikipedia:
  • 이름 공간이 생략되었지만 와 같이 콜론이 포함된 경우 {{:Pagename}}백과사전 기사가 Pagename삽입됩니다. 예를 들어, {{:Notability}}기사 Notability를 포함합니다 .
  • 와 같이 네임스페이스와 콜론이 모두 생략되면 {{Pagename}}이 Template:Pagename포함됩니다. 예를 들어 {{Notability}}및 also 는 둘 다 Template:Notability 를{{Template:Notability}} 변환합니다 .

따라서 요약하면 위키텍스트가 있거나 포함된 예제 페이지는 {{Pagename}}해당 예제 페이지로 {{Template:Pagename}}변환됩니다 . Template:Pagename그러나 {{:Pagename}}다른 효과가 있을 것입니다. 그것은 기사를 번역할 것입니다 Pagename. 또한 해당 형식의 제목이 있는 페이지에 대해 {{Namespace:Pagename}}페이지를 변환합니다 . 템플릿 매개변수 와 트랜스클루전 수정자를Namespace:Pagename 사용할 수도 있습니다 .

HubPages

하위 페이지 는 '상위' 페이지에서 "/"(슬래시)로 구분된 페이지입니다. 이름이 형식인 상위 페이지의 경우 Namespace:Pagename해당 하위 페이지 이름의 형식은 입니다 Namespace:Pagename/Subpagename. 이 기능은 기본, 파일 및 MediaWiki 네임스페이스 에서 비활성화되지만 해당 토크 네임스페이스에서는 비활성화됩니다.

하위 페이지를 삽입하려면:

  • 일반 구문은 입니다 {{Namespace:Pagename/Subpagename}}.
  • 하위 페이지의 상위 페이지에서는 일반 구문 또는 입니다 {{/Subpagename}}.
  • 템플릿 네임스페이스 페이지의 경우 일반 구문 또는 {{Pagename/Subpagename}}.
  • 기사 하위 페이지는 이 위키에서 비활성화되어 있지만 그렇지 않으면 입니다 {{:Pagename/Subpagename}}.
  • 템플릿 매개변수 및 트랜스클루전 수정자를 사용할 수도 있습니다.

예를 들어 Template:Like/doc 를 변환하려면 {{Template:Like/doc}}또는 입니다 {{Like/doc}}. 하위 페이지 이름은 대소문자를 구분하며 {{Like/Doc}}작동하지 않습니다.

템플릿 매개변수

트랜스클루전의 가장 일반적인 적용은 템플릿 의 트랜스클루전입니다 . 템플릿은 삽입 또는 대체를 통해 다른 페이지에 포함되는 것을 주된 목적으로 작성되는 페이지입니다 . 위에 표시된 대로 Template:Pagename이라는 템플릿을 변환하는 일반적인 구문은 입니다 {{Pagename}}. 그러나 일부 템플릿은 매개변수를 사용할 수도 있습니다 . 매개변수 는 다른 방식으로 작동하기 위해 특정 템플릿에 전달할 수 있는 값( 인수 라고도 함)을 지정할 수 있는 변수 입니다 . 템플릿은 매개변수를 사용하지 않거나, 고정된 수의 매개변수를 사용하거나, 가변적인 수의 매개변수를 사용할 수 있습니다. 템플릿에서 사용할 수 있는 매개변수의 수는 1부터 그 이상입니다.

템플릿과 함께 매개 변수를 사용하기 위한 정확한 구문은 사용 중인 실제 템플릿에 따라 크게 다를 수 있습니다. 그러나 세 개의 매개변수를 사용하는 Template:Pagename이라는 예제 템플릿의 경우 일반 형식은 다음과 같습니다.

{{Pagename|parameter1|parameter2|parameter3}}

바로 가기

실제로 사용될 때 각 매개변수는 a value또는 a 로 대체됩니다. 각 매개변수는 세로 막대parameter name=value 로 구분됩니다 . 형식을 취하는 매개변수를 이름 없는 매개변수 또는 위치 매개변수 라고 합니다 . 형식을 취하는 매개변수를 명명된 매개변수 라고 합니다 . 이름이 지정되지 않은 매개변수를 사용하면 첫 번째, 두 번째, 세 번째 등의 매개변수는 템플릿 문서의 매개변수 '1', '2', '3' 등과 동일합니다 . 명명되지 않은 매개변수는 올바른 순서로 있어야 하며 명명된 매개변수 앞에 배치하는 것이 가장 좋습니다. Template:Collapse top을 사용하는 구문의 예 : valueparameter name=value

{{Collapse top|This is the title text|This is a custom warning line|left=true}}

이 특정 예에서는 세 개의 매개변수가 사용되지만 Template:Collapse top은 실제로 가변 개수의 매개변수를 사용할 수 있습니다. This is the title text그리고 는 This is a custom warning line명명되지 않은 매개변수 '1'과 '2'의 값입니다. 그리고 true명명된 매개변수의 값입니다 left.

자세한 내용은 도움말:템플릿 을 참조하십시오 . 또한 사용 가능한 Main Namespace 관련 템플릿(일반적으로 백과사전 문서)에 대한 링크 목록은 Wikipedia:Template index를 참조하십시오. 및 기타 네임스페이스 관련 템플릿(일반적으로 기사가 아닌 페이지의 경우) 검색 기능도 있습니다. 템플릿 매개변수는 선택적 삽입의 매개변수화 방법 에도 사용됩니다 .

치환

대체는 유사한 이중 중괄호 구문을 가지며 그 동작은 삽입과 유사합니다. 대체 위키텍스트가 있는 페이지를 미리 볼 때 해당 작업은 삽입과 동일합니다. 그러나 대체 위키텍스트가 포함된 페이지를 저장하면 해당 위키텍스트를 템플릿의 실제 위키텍스트로 대체한다는 점에서 다릅니다.

예를 들어 가 저장되면 해당 위키텍스트를 Template:Like{{subst:Like}} 의 실제 위키텍스트로 대체합니다 . 실제로 이것이 만드는 주요 차이점은 Template:Like의 위키 텍스트에 업데이트가 발생한 경우 이미 저장된 페이지는 업데이트되지 않는다는 것입니다 .{{subst:Like}}

마법의 단어

마법의 단어는 삽입의 예가 아닙니다. 그러나 일부는 유사한 이중 중괄호 구문과 삽입 작업을 가지고 있습니다. 예를 들어 Wikipedia 페이지의 Fullpagename을{{FULLPAGENAME}} 렌더링합니다 . 템플릿과 마찬가지로 일부 매직 워드는 콜론(:)을 사용하여 구분되는 매개변수를 사용할 수도 있습니다. 예를 들어 . {{FULLPAGENAME:value}}

Template :FULLPAGENAME 과 같은 일부 마법 단어에 대한 템플릿이 존재합니다 . 그러나 이들은 세로 막대(|)를 사용하여 매개변수를 전달하는 경우 관련 마법의 단어를 호출합니다. 예를 들어 {{FULLPAGENAME|value}}. {{FULLPAGENAME:value}}그러나 마법의 단어 매개변수는 템플릿을 우회하는 와 같은 콜론을 사용하여 직접 전달하는 것이 가장 좋습니다 .

트랜스클루전 수정자

위에서 설명한 것처럼 예제에서 {{subst:Like}}코드 subst:는 삽입을 대체로 변경합니다. 이것은 transclusion modifier 로 어떤 식으로든 transclusion을 변경하기 위한 전문 마법의 단어입니다. 또 다른 예는 입니다 {{:Notability}}. 여기서 :(콜론 문자)는 메인 네임스페이스로 강제 변환됩니다. safesubst:, int:, msg:, msgnw:및 와 같은 추가 트랜스클루전 수정자가 있습니다 raw:. 사용법에 대한 자세한 내용은 mw:Help:Magic words § Transclusion modifiers 를 참조하십시오 . 또한 수정된 명령을 참조 #section:하고 레이블 #section-x:이 지정된 섹션 삽입#section-h: 에 사용됩니다 .

트랜스클루전의 적용

트랜스클루전의 가장 일반적인 적용은 템플릿을 사용하는 것입니다 . 그러나 주로 프로젝트 공간 내에서 다른 페이지도 간혹 포함됩니다.

복합 페이지

복합 페이지는 전체적으로 또는 부분적으로 포함된 구성 요소 페이지로 구성됩니다. 그러한 페이지의 위키텍스트는 구성 요소 페이지를 포함하기 위해 부분적으로 또는 전체적으로 태그로 구성될 수 있습니다. 구성 요소 페이지는 일반적으로 템플릿 네임스페이스에 없으며 자체적으로 전체 페이지인 경우가 많습니다. 복합 페이지는 이를 중앙 위치로 모으기 위한 것입니다.

복합 페이지의 예:

이렇게 하면 구성 요소 페이지를 개별적으로 볼 것인지 함께 볼 것인지 선택할 수 있습니다. 복합 페이지를 보는 것은 수많은 링크를 따라가는 노력 없이 모든 구성 요소의 개요를 허용한다는 점에서 작은 관련 구성 요소 페이지가 많을 때 편리합니다.

일반적으로 각 구성 요소 페이지와 복합 페이지는 별도로 처리됩니다. 구성 요소 페이지의 실제 변경 사항은 복합 페이지에 변환되지만 편집 기록, 최근 변경 사항, 페이지 감시 설정, 페이지 보호, 목차, "여기에 링크된 항목" 링크 및 복합 페이지의 기타 기능은 반영되지 않습니다. , 또는 영향, 기록, 감시 설정, 보호 수준, 여기에 구성 요소 페이지 목록이 있는 링크 . 복합 페이지는 그 자체로 페이지입니다. 복합 페이지의 토론 페이지는 구성 요소 페이지가 아니라 일반적으로 구성 및 페이지에 대해 이야기하는 데 사용됩니다. 구성 요소 페이지의 토론 페이지를 합성한 것일 수도 있습니다.

구성 요소 페이지의 섹션 편집은 복합 페이지에서 직접 수행할 수 있습니다. 포함된 템플릿의 섹션 편집을 참조하십시오 . 저장 후 섹션이 속한 구성 요소 페이지를 편집하게 됩니다.

언어 간 링크 기능이 있는 프로젝트에서 복합 페이지는 모든 구성 요소 페이지의 결합된 언어 간 링크를 표시하므로 한 언어 또는 한 페이지에 대한 여러 링크가 가능합니다.

Wikipedia talk:Template namespace/Archive 1#transclude prose 도 참조하십시오 .

공통 섹션이 있는 페이지

지름길

두 페이지가 동일한 자료를 동일한 방식으로 논의해야 하는 경우 섹션을 공유할 수 있습니다. 여기에는 세 번째 페이지를 만들고 해당 페이지를 두 페이지에 삽입하는 작업이 포함됩니다. 이 세 번째 페이지는 그 자체로 페이지이거나 다른 두 페이지 중 하나의 하위 페이지일 수 있으며 첫 번째 페이지인 경우 다른 페이지와 동일한 네임스페이스 또는 템플릿 네임스페이스에 배치될 수 있습니다. 이와 같은 공통 섹션은 설명 헤더로 표시하거나 특수 레이아웃을 지정하여 페이지의 이 섹션이 다른 위치에 있음을 독자에게 알려야 합니다. 표시되지 않은 채로 두었습니다.

이것은 두 개의 명확성 페이지가 콘텐츠를 공유할 때, [ 분쟁 – 토론 ] 또는 목록 페이지와 명확성 페이지가 콘텐츠를 공유할 때 매우 유용할 수 있습니다 (아래 세 번째 예 참조).

예:

페이지 내 반복

반복되는 정보가 많은 페이지(일반적으로 다양한 종류의 목록)에서는 반복되는 텍스트를 포함하는 템플릿을 만든 다음 해당 템플릿을 여러 번 호출하는 것이 때때로 유용합니다. 예를 들어 Template:EH에 나열된 건물 행은 많은 기사에서 테이블을 구성하는 데 반복적으로 사용됩니다.

동일한 텍스트의 단순 반복은 단일 템플릿에서 매개변수를 반복하여 처리할 수 있습니다. 예: {{ 3x }}, 여기서 {{3x| howdy!}}produce howdy! howdy! howdy!.

반복에 대한 자세한 내용은 m:Help:위키텍스트의 재귀 변환 을 참조하세요 .

현재 템플릿 시스템에 대한 자세한 내용은 Wikipedia:Template namespace 를 참조하십시오 .

부분 삽입

지름길

<noinclude>및 마크업을 사용하여 페이지 전체 가 아닌 일부를 트랜스 <includeonly>클루 <onlyinclude>드할 수 있습니다 . 이러한 부분 삽입은 하위 페이지를 포함하여 모든 페이지에서 삽입하여 수행할 수 있습니다. 템플릿 문서의 경우와 같이 삽입에서 페이지의 일부를 제외하는 것이 종종 유용합니다.

요약 기사 작성을 단순화하기 위해 이 기술을 적용할 수 있는 방법에 대한 예는 마크업을 사용하여 병리학의 역사 ( 여기 에서 diff 참조 ) 의 일부가 병리학 ( 여기에서 diff 참조 ) 으로 변환된 방법을 참조하십시오 {{:History of pathology}}. 그 당시 병리학 기사( 여기 참조 )는 주로 여러 기사의 삽입된 리드 단락 과 기타 섹션으로 구성되었습니다. 이것이 어떻게 수행되었는지 보려면 소스를보십시오. 그 이후로 병리학 기사는 다시 작성되었으며 이러한 모든 포함을 포함하지 않습니다.

Joseph Gordon-Levitt 의 동일한 이름의 요약 섹션으로 HitRecord 의 일부(소개 단락만)를 트랜스클루션한 것에서 또 다른 예를 찾을 수 있습니다 .

마크업

삽입에서 소스 페이지는 대상 페이지로 삽입됩니다. 그러나 부분 삽입을 사용하면 해당 소스 페이지의 일부만 대상 페이지로 삽입됩니다. 그러나 추가로 대상 페이지에 삽입된 내용이 소스 페이지에 표시될 필요는 없습니다.

소스 페이지의 페이지 렌더링은 저장 시 해당 소스 페이지의 렌더링으로 정의할 수 있으며 미리보기와 동일 합니다 . 여기서는 이 렌더링을 호출할 수 있습니다 .

소스 페이지의 삽입 렌더링은 소스 페이지가 삽입된 대상 페이지의 렌더링으로 정의할 수 있습니다. 그러나 소스 페이지에서 포함된 대상 페이지의 해당 부분만. 트랜스클루전 렌더링의 미리보기는 다시 동일합니다. 우리는 이 렌더링을 거기서 호출할 수 있습니다 .

여기에 있는 페이지 렌더링이 저기 있는 트랜스클루전 렌더링과 달라야 하는 경우에는 세 쌍의 태그가 관련되어 있습니다 . 앞에서 설명한 것처럼 , <noinclude>및 <includeonly>입니다 <onlyinclude>. 이러한 태그는 보이지 않지만 여기의 페이지 렌더링과 저기의 트랜스클루전 렌더링 모두에 영향을 미칩니다 . 이러한 태그는 쌍을 이루어 차이를 만드는 섹션을 구분합니다. 각 태그는 명명된 전체 페이지를 포함하는 예외를 설명합니다. 

<noinclude> 이 섹션은 여기에서 볼 수 있습니다. 그러나이 섹션은 거기에 표시되지 않습니다. 이러한 태그 외부의 섹션은 여기 저기 모두 표시됩니다. </noinclude>

<onlyinclude> 이 섹션은 여기에서 볼 수 있습니다. 이 섹션도 볼 수 있습니다. 이러한 태그 외부의 섹션은 여기에 표시되지만 거기에는 표시되지 않습니다. </onlyinclude>

<includeonly> 이 섹션은 여기에 표시되지 않습니다. 그러나 그것은 거기에서 볼 수 있습니다. 이러한 태그 외부의 섹션은 여기 저기 모두 표시됩니다. </포함 전용>
위키텍스트 여기서 렌더링되는 내용 (소스 페이지) 거기에 끼워져 있는 것 (목적지 페이지)
<noinclude>text1</noinclude>텍스트2 text1 text2 text2
<onlyinclude>text1</onlyinclude>텍스트2 text1 text2 text1
<includeonly>text1</includeonly>텍스트2 text2 text1 text2

주목해야 할 중요한 점은 <noinclude>와 달리 여기에서<onlyinclude> 렌더링되는 페이지에 전혀 영향을 미치지 않는다는 것입니다 . 태그 는 거기에 포함되는 태그 내부의 텍스트를 중지 하지만 반대의 효과가 있습니다. 태그 외부의 텍스트가 거기에 포함되는 것을 중지합니다 . <includeonly><noinclude><onlyinclude>

텍스트가 여기에서<includeonly> 렌더링되는 페이지 만 중지합니다 . 그러나 자연스럽게 충분히 거기에 포함됩니다 . 태그 외부의 텍스트는 여기에서 렌더링되고 거기에서 삽입 됩니다 .

이러한 섹션이 여러 개 있을 수 있습니다. 또한 중첩될 수 있습니다. 여기 와 저기 사이의 모든 가능한 차이점을 달성할 수 있습니다.

<onlyinclude>한 가지 예는 섹션을 선택한 다음 <noinclude>해당 섹션에서 섹션을 가져오는 콘텐츠 편집자입니다 . 그러나 거기<onlyinclude> 에 추가할 또 다른 섹션을 선택합니다 . 그러나 이것들 중 어느 것도 그들의 기사에 어떤 식으로든 영향을 미치지 않습니다.

또 다른 예는 페이지의 <includeonly>코드 섹션과 문서 섹션을 담당하는 템플릿 프로그래머입니다 .<noinclude>

선택적 트랜스클루전

바로 가기

선택적 포함은 포함 할 수 있는 섹션이 둘 이상인 문서에서 선택한 섹션 하나를 부분적으로 포함하는 프로세스입니다 . <onlyinclude> … </onlyinclude>위에서 언급한 것처럼 문서의 한 섹션만 트랜스클루브해야 하는 경우 관심 있는 섹션을 태그로 둘러싸서 전체 페이지를 트랜스클루션 하면 됩니다 . 그러나 템플릿 또는 문서의 한 섹션을 한 페이지로 선택적으로 변환하고 동일한 템플릿 또는 문서의 다른 섹션을 두 번째 페이지 및/또는 동일한 페이지의 다른 섹션으로 선택적으로 변환하려면 다음과 같은 방법이 필요합니다.

a) 원본 문서의 각 변환 가능한 섹션을 고유하게 표시합니다. 그리고
b) 대상 문서(포함된 섹션을 표시하는 문서)에서 어떤 섹션을 포함할지 지정하는 방법.

이 섹션에서는 이를 수행하는 방법에 대해 설명합니다. 이를 수행하는 세 가지 방법이 있습니다: (1) 섹션 헤더 기반 트랜스클루션, (2) 레이블이 지정된 섹션 트랜스클루션 및 (3) 매개변수화 방법.

표준 섹션 삽입(특수 소스 문서 마크업이 필요하지 않습니다!)

를 사용하면 {{#section-h:PAGENAME|SECTIONNAME}}Wikipedia 전체에서 사용되는 표준 유비쿼터스 헤드라인 기반 섹션 헤더를 참조하여 한 페이지의 섹션 내 콘텐츠를 다른 페이지로 쉽게 변환할 수 있습니다. 이 방법으로 기사의 리드를 트랜스클루드하려면 를 사용할 수 있습니다 {{#section-h:PAGENAME}}. 이것은 특수 소스 문서 마크업이 필요한 아래 섹션의 이미 널리 사용되는 선택적 트랜스클루전 방법보다 간단합니다.

&nbsp;이 선택적 삽입 방법은 종종 소스 및 대상 문서 마크업에 따라 섹션 삽입 위 및/또는 아래에 줄 바꿈을 추가합니다. 이 문제를 방지하려면 선택적 트랜스클루전 템플릿을 템플릿으로 래핑합니다 . {{trim}}즉, 바로 위에 나열된 트랜스클루전 코드에 다음 수정 사항을 사용합니다.

  • 기사 본문의 섹션을 번역하기 위한 코드:{{trim|{{#section-h:PAGENAME|SECTIONNAME}}}}
  • 기사의 리드를 번역하기 위한 코드:{{trim|{{#section-h:PAGENAME}}}}

Transcluded 섹션 hatnote

선택적으로 포함된 기사 콘텐츠가 있는 위치를 표시하기 위해 기사의 해당 섹션 상단에 모자 노트를 포함하는 것이 좋습니다. 즉, 포함된 콘텐츠가 대상 페이지의 전체 섹션을 구성하는지 여부에 따라 또는 를 사용합니다. 이러한 템플릿은 다음과 같이 렌더링됩니다. {{Transcluded section}}{{transcluded section|source=PAGENAME}}{{transcluded section|source=PAGENAME|part=yes}}

  • {{transcluded section|source=PAGENAME}}다음과 같이 렌더링됩니다.
  • {{transcluded section|source=PAGENAME|part=yes}}다음과 같이 렌더링됩니다.

레이블 섹션 방법 사용

레이블 섹션 선택적 삽입은 콘텐츠를 선택적으로 삽입하기 위해 모든 위키미디어 위키에서 사용 가능한 mw:Extension:Labeled Section Transclusion 에 나열된 구문 분석기 기능을 사용합니다. 레이블이 지정된 섹션 삽입이 작동하는 방식에 대해서는 도움말: 레이블이 있는 섹션 삽입을 참조하십시오 .

매개변수화 방법

소스 문서 마크업

변환할 각 섹션의 첫 번째 행 바로 앞에 있는 "소스" 문서(텍스트가 변환되는 문서)에 다음 행을 삽입하고 SECTIONNAME(두 번)을 해당 섹션의 고유한 이름으로 대체합니다. 섹션 이름은 모든 식별자가 될 수 있으며 해당 문서 내에서 고유해야 합니다.

<onlyinclude>{{#ifeq:{{{transcludesection|SECTIONNAME}}}|SECTIONNAME|

다음과 같이 변환 가능한 각 섹션을 종료합니다.

}}</onlyinclude>
대상 문서 마크업

위와 같이 표시된 섹션을 다른 페이지("대상 페이지")로 트랜스클루드하려면 해당 페이지에서 다음 행을 사용하여 텍스트를 트랜스클루드할 "소스" 문서를 PAGENAME으로 바꾸고 SECTIONNAME을 섹션 이름으로 대체하십시오. 포함하고 싶은 것:

{{PAGENAME|transcludesection=SECTIONNAME}}

따라서 태그로 묶인 각 섹션은 매개변수가 설정되지 않은 경우(일반적으로 문서를 볼 때 또는 아래와 같이 매개변수를 설정하지 않고 문서를 트랜스클루드한 경우) <onlyinclude> … </onlyinclude> 항상 렌더링되며 태그가 설정되지 않은 페이지에서는 트랜스클루션으로 렌더링됩니다. 섹션 이름으로 설정합니다 . 매개변수를 사용하는 트랜스클루션에 의해 렌더링되지 않지만 섹션 이름 이외의 것으로 설정 됩니다 .transcludesectiontranscludesectiontranscludesectiontranscludesection

또한 PAGENAME을 제공할 때 Namespace를 제공하지 않고 Wiki는 PAGENAME이 Template Namespace 에 속한다고 가정합니다 . Mainspace 기사 에서 번역하려면 :PAGENAME을 사용하십시오.

{{:PAGENAME|transcludesection=SECTIONNAME}}
예

WP:TITLE 의 "주요 기준" 및 "일반 이름" 섹션을 독립적으로 변환할 수 있도록 하려면 WP:TITLE 페이지를 편집하고 다음과 같이 "주요 기준" 섹션을 포함합니다. 

<onlyinclude> {{ # ifeq : {{{ transcludesection | 주요 기준 }}} | 주요 기준 | 
... 
'' ( "주요 기준" 섹션 의 텍스트  ) '' ... }} </onlyinclude>

마찬가지로 "일반 이름" 섹션을 다음과 같이 묶습니다. 

<onlyinclude> {{ # ifeq : {{{ transcludesection | 공통 이름 }}} | 통칭 | 
... 
'' ( "일반 이름" 섹션 의 텍스트  ) '' ... }} </onlyinclude>

그런 다음 "Principal Criteria" 섹션을 다른 페이지로 변환하기 위해 해당 페이지에 다음을 삽입합니다.

{{WP:TITLE|transcludesection=principalcriteria}}

"Common Name" 섹션을 다른 페이지로 옮기려면 해당 페이지에 다음을 삽입합니다.

{{WP:TITLE|transcludesection=commonname}}

물론 같은 페이지에 이러한 행을 여러 개 포함하여 이러한 방식으로 두 개 이상의 섹션을 포함할 수 있습니다.

문서에 삽입할 수 있는 선택 가능한 섹션 수에는 제한이 없습니다. 유일한 요구 사항은 각각 transcludesection해당 페이지 내에서 고유한 값을 부여받는 것입니다.

선택적으로 포함된 하위 문서 리드에 대한 추가 마크업

MOS :LEAD#Format of the first sentence 에 따라 하위 기사 제목의 첫 번째 인스턴스는 해당 기사의 첫 번째 리드 문장에서 굵게 표시되어야 합니다. 이는 종종 상위 문서의 섹션으로의 트랜스클루션에 바람직하지 않습니다. 또한 상위 문서는 종종 하위 문서의 선두에 위키링크로 연결됩니다. 상위 문서로 변환될 때 이 위키링크는 굵은 텍스트로 표시됩니다. 아래 나열된 wikitext 마크업을 사용하여 이 두 가지 문제를 모두 해결할 수 있습니다.

기사 제목이 하위 기사의 첫 번째 문장에서는 굵게 표시되지만 상위 기사로의 트랜스클루션에서는 굵게 표시되지 않고 위키링크로 표시되도록 하려면 하위 기사의 첫 번째 리드 문장에서 다음과 같이 바꾸십시오.

바꾸다
SUB-ARTICLE_PAGENAME
~와 함께
<noinclude>'''</noinclude>{{No selflink|SUB-ARTICLE_PAGENAME}}<noinclude>'''</noinclude>

하위 문서의 시작 섹션에 상위 문서에 대한 위키링크가 있는 경우 상위 문서에 대한 위키링크를 템플릿으로 바꾸면 상위 문서로의 트랜스클루전이 아니라 하위 문서의 시작 부분에 위키링크가 연결됩니다. . 다시 말해서: {{no selflink}}

  1. 상위 기사에 대한 위키링크가 WP:Piped 링크가 아닌 경우 하위 기사의 리드에서 로 교체하십시오.[[PARENT_ARTICLE]]{{no selflink|PARENT_ARTICLE}}
  2. 상위 기사에 대한 위키링크에 파이프(예: 이 링크)가 포함된 경우 하위 기사의 리드에서 로 교체하십시오.[[PARENT_ARTICLE|Piped link wikitext]]{{No selflink|PARENT_ARTICLE|Piped link wikitext}}

단점

지름길

많은 소프트웨어 기술과 마찬가지로 트랜스클루전에는 여러 가지 단점이 있습니다. 가장 분명한 것은 필요한 기계 자원 증가 측면에서 비용입니다. 이를 어느 정도 완화하기 위해 페이지의 복잡성을 줄이기 위해 소프트웨어에서 템플릿 제한을 적용합니다. 몇 가지 추가 단점이 아래에 나열되어 있습니다.

특별 페이지

Special :Allpages , Special:Prefixindex , Special: Newfiles , Special:Newpages , Special:Recentchanges 및 Special:Recentchangeslinked 와 같은 Special: Specialpages 의 일부 페이지는 변환될 수 있습니다 . 견본:

  • {{Special:Allpages/General}}– "일반"에서 시작하는 페이지 목록.
  • {{Special:Prefixindex/General}}– 접두사가 "일반"인 페이지 목록.
  • {{Special:Newfiles/4}}– 가장 최근에 업로드된 4개의 파일 갤러리.
  • {{Special:Newpages/5}}– 가장 최근에 생성된 5개의 페이지 목록.
  • {{Special:Recentchanges/5}}– 가장 최근 변경 사항 5개.
  • {{Special:Recentchangeslinked/General}}– "일반"에서 링크된 페이지의 최근 변경 사항.

포함을 시도하면 {{Special:Categories}}실제 범주 목록이 생성되지 않지만 {{Special:Prefixindex/Category:}}이러한 용도로 사용할 수 있습니다.

를 제외하고 Special:Recentchangeslinked슬래시 및 슬래시 뒤의 단어 또는 숫자는 생략할 수 있으며 특정 시작 지점이 없는 페이지 목록 또는 기본 길이 목록을 제공합니다.

URL 매개변수는 템플릿 매개변수처럼 지정할 수 있습니다.

  • {{Special:Recentchanges|namespace=10|limit=5}}– "Template" 네임스페이스의 가장 최근 변경 사항 5개.
  • {{Special:Prefixindex/Jimbo Wales/|namespace=2|stripprefix=1}}– User:Jimbo Wales 의 하위 페이지 이지만 사용자 페이지 접두사는 없습니다.

참고: 특정 특수 페이지(예: Special:Newpages ) 를 포함하면 페이지의 표시된 제목이 변경될 수 있습니다.

또한보십시오

미디어위키 번역

템플릿

다른

이 페이지는 Wikipedia Glossary 에서 참조됩니다 .
위키 문자 w.svg
" https://en.wikipedia.org/w/index.php?title=Help:Transclusion&oldid=1124434643 " 에서 가져옴
0.097441911697388