본문 바로가기
미디어위키

Help Section

by 다움위키 2024. 12. 4.

원문 보기: https://dawoum.duckdns.org/wiki/Help:Section

 

섹션 헤더 구문을 사용하면 페이지를 섹션으로 나눌 수 있습니다.

Section creation and numbering

섹션을 만들기 위해, 다음과 같이 제목을 정의하십시오:

==Section==

===Subsection===

====Sub-subsection====

Guidelines for using section headers

  • 한쪽에 등호가 하나만 있는 헤더 (=text here=)는 제목의 크기를 페이지 이름만큼 크게 만듭니다.
  • 섹션 헤더는 같은 줄에 있는 다른 컨텐츠와 결합될 수 없습니다. 예를 들어, ==Section Header==<br>는 헤더가 아니라 단락으로 렌더링될 것입니다.
  • 섹션 이름은 하위 섹션 이름을 포함하여 페이지 내에서 고유해야 합니다. 중복된 섹션 이름의 단점은 다음과 같습니다:
    • 편집 충돌 - 같은 제목을 갖는 여러 섹션은 편집 혼란을 초래하여, 오류를 발생시키고 기고자가 콘텐츠를 정확하게 편집하기 어렵게 만듭니다.
    • 모호한 편집 요약 - 미디어위키는 페이지 편집에 대한 편집 요약을 생성하지만, 여러 섹션의 제목이 같으면 모호해질 수 있습니다. 예를 들어, 두 개의 '다이어트' 섹션의 편집 요약은 '나는 다이어트 섹션을 편집했습니다'가 될 수 있으며, 이는 기여자들을 혼란스럽게 하고 최근 변경 사항을 효과적으로 검토하기 어렵게 만듭니다.
  • 템플릿/페이지를 사용하여 각 페이지에 개별 편집 역사를 갖는 별도 섹션을 만들 수 있습니다. 각 템플릿/페이지를 주요 페이지에 삽입하여, 전반적인 모양을 변경하지 않고도 컨텐츠를 추가할 수 있습니다. 이 설정을 사용하면 변경 사항을 추적하고 페이지의 특정 부분을 관리하기가 더 쉬워집니다 (Help:Template#Possible uses of templates를 참조하십시오.)
  • 새 페이지에 섹션을 갖는 템플릿은 원래 순서를 유지하고, 템플릿 앞뒤에 있는 컨텐츠를 결합합니다. 이렇게 하면 주요 페이지의 섹션 번호에 영향을 주지 않고 템플릿 내의 섹션 번호가 적절하게 매겨집니다.
    이 기능은 Vector 2022 스킨처럼 문서 컨텐츠 외부에 목차를 표시하는 스킨에서는 지원되지 않습니다.
  • 미디어위키의 위키텍스트의 섹션 헤더는 정규 표현식 /(^={1,6}.*?={1,6}\s*?$)/m에 의해 지정됩니다 (m은 다중-줄 모드를 나타냅니다.)

Table of contents (TOC)

이 기능은 Vector 2022 스킨과 같이 문서 내용 외부에 목차를 표시하는 스킨에서는 지원되지 않습니다. Vector 2022 스킨에서는 섹션 제목이 하나뿐이어도 TOC가 생성됩니다.

목차(table of contents: TOC)는 3개보다 많은 섹션 제목을 포함하는 페이지에 대해 자동으로 생성됩니다. 어쨌든, 편집자는 기사의 편집 상자에 마법 단어 __NOTOC__ (두 개의 밑줄로 묶음)를 추가함으로써 TOC를 제외할 수 있습니다.

Guidelines for using table of contents

  • __FORCETOC__ 또는 __TOC__ (용어의 양쪽에 두 개의 밑줄을 가짐)를 추가할 때 __NOTOC__를 덮어쓰고, 페이지의 머릿글이 4개 미만인 경우에도 TOC가 위키텍스트에 추가됩니다.
  • __FORCETOC__를 사용하여 목차 (TOC)가 첫 번째 섹션 머릿글 앞에 표시되고, 반면에 __TOC__는 목차를 시작하려는 위치에 배치하여 오른쪽이나 테이블 셀 내부와 같이 유연한 위치 지정이 가능합니다.
  • __TOC__는 기사에서 목차 (TOC)가 나타나는 위치를 제어하는 ​​데 도움이 됩니다. __TOC__는 소개 뒤나 페이지 끝과 같이 TOC를 표시하려는 위치에 넣습니다. 이렇게 하면 추가 제목이 필요 없이 TOC가 올바른 위치에 있는지 확인할 수 있습니다.
  • __NOTOC__를 사용하면 자동 목차가 페이지에 표시되지 않습니다. 간단한 목차를 만들기를 원하면 == A ==와 같은 머릿글을 사용하여 페이지의 다른 섹션에 대한 링크를 수동으로 만들고 그런-다음 [[#A|A]]와 같은 섹션 링크를 사용하여 링크할 수 있습니다.

요약:

Moving the table of contents

아래 코드를 사용하면 목차를 화면 오른쪽에 떠 있는 테이블로 배치할 수 있습니다.

  {| align="right"
  | __TOC__
  |}

Limiting the TOC depth globally

LocalSettings.php 파일에서 $wgMaxTocLevel 설정을 조정함으로써 목차 (TOC)의 깊이를 제어할 수 있습니다. 예를 들어, 3으로 설정하면 TOC가 최대 3단계 깊이까지만 표시됩니다.

Linking to a section

섹션 헤더는 id 속성을 갖는 HTML을 자동 생성할 것이며, 이는 같은 페이지 내부나 다른 페이지에서 직접 링크될 수 있습니다.

예를 들어, 이 페이지에서 이 섹션의 시작 부분에 생성된 HTML 코드는 다음과 같습니다:

<h2><span class="mw-headline" id="Linking_to_a_section">Linking to a section</span></h2>

이것 (section)에 대한 링크는 다음과 같이 나타납니다:

[[Help:Section#Linking to a section|Section linking]]

[[#section link|displayed text]]를 사용하여 페이지 내의 섹션에 링크할 수 있고, [[page name#section name|displayed text]]를 사용하여 다른 페이지 내의 섹션에 링크할 수도 있습니다.

하위 섹션, 하위 하위 섹션, 등에 대한 링크는 앵커가 섹션의 깊이를 고려하지 않으므로 [[#subsection name]] 및 [[#sub-subsection name]], 등이 됩니다.

중복된 섹션 이름은 밑줄과 숫자를 추가하여 표시합니다. 예를 들어, "Example"이라는 이름의 섹션이 세 개 있는 경우 "Example", "Example_2", 및 "Example_3"이라는 레이블이 지정됩니다. 어쨌든, "Example_2" 또는 "Example_3" 섹션을 편집할 때, 편집 요약은 혼란스럽게도 "Example"로 안내합니다. 섹션에서 빈 머릿글은 목차 (TOC)를 왜곡합니다.

Linking sections using an arbitrary id

섹션 링크 앵커는 통지 없이 변경될 수 있으며, 특히 기사에 같은 이름의 섹션이 여러 개 있는 경우 더욱 그렇습니다. " 2", " 3", 등과 같은 추가 식별자가 이들 섹션을 구분하기 위해 추가됩니다. 만약 섹션을 추가, 삭제, 또는 이름을 변경하면, 링크의 대상이 변경될 수 있으며, 잠재적으로 잘못된 섹션이나 존재하지 않는 섹션으로 이어질 수 있습니다. 이것은 HTML 태그와 id 속성을 사용하여 방지할 수 있습니다:

<span id="anchor_name"></span>

선택한 이름이 고유한지 확인하려면 캐나다 주요 문서의 "Ontario" 섹션 내의 "Natural Features" 하위 섹션에 Ontario-Natural_features와 같이 상위 섹션의 축약된 제목을 통합하십시오. 이 방법은 특히 미디어위키 1.4.10 이전 버전의 오래된 브라우저에서는 작동하지 않을 수 있고, id에 공백이 포함되면 최신 브라우저에서도 작동하지 않을 수 있습니다. 예를 들어:

<span id="Ontario-Natural features">(optional text)</span> [will not work]
<span id="Newfoundland-Natural_features">(optional text)</span> [will work]
...
See [[#Ontario-Natural features|natural features of Ontario]] and [[#Newfoundland-Natural features|natural features of Newfoundland]]

밑줄과 공백이 있어도 링크가 원활하게 작동하도록 하려면 id의 공백을 밑줄로 바꿔야 합니다.

페이지의 임의의 섹션에 링크하려면 수동 앵커를 참조하십시오.

Linking sections and redirects

리다이렉트를 통해 페이지의 특정 섹션으로 링크하는 것은 보통 해당 섹션으로 직접 링크하는 것과 비슷하게 작동합니다.

페이지 이름을 바꾸면 리다이렉트가 생성되지만, 섹션 이름을 바꾸면 생성되지 않습니다. 추가적으로, 섹션에 대한 별도의 백링크 기능이 없습니다; 섹션에 링크하는 페이지는 전체 페이지에 링크하는 페이지와 함께 나열됩니다. 이러한 문제를 해결하기 위해:

  • 섹션에 직접 링크하는 대신, 섹션으로 리다이렉트하는 페이지를 사용하십시오. 이 접근 방식은 섹션 이름에 대한 변경 사항을 추적하는 데 도움이 되고 섹션에 대한 "what links here" 기능을 제공합니다. 섹션으로의 링크를 식별하기 위해, 페이지로 링크하는 리다이렉트를 확인하고 관련 링크를 선택하십시오.
  • 섹션 내에 앵커를 삽입하고 그에 따라 링크를 지정합니다.
  • 위키텍스트의 섹션 시작 부분에 주석을 추가하고, 해당 섹션에 링크된 페이지를 나열합니다.
  • 섹션에 대한 별도의 페이지나 템플릿을 만들고 부모 페이지로 전달-삽입하거나 링크합니다. 그런 다음, 섹션에 직접 링크하는 대신, 별도의 페이지나 템플릿에 링크합니다.

리다이렉트 페이지는 리다이렉트 명령 뒤에 카테고리 태그를 추가함으로써 카테고리에 넣을 수 있습니다. 리다이렉트가 섹션으로 이어지면, 해당 섹션도 어느 정도 카테고리화됩니다. 어쨌든, 섹션은 특별히 수행하지 않는 한 카테고리로 다시 링크되지 않습니다. 카테고리 페이지에서, 리다이렉트는 기울임꼴로 표시됩니다. 자세한 내용에 대해, w:Wikipedia:Categorizing redirects를 참조하십시오.

Editing sections

페이지의 특정 섹션을 편집하기 위해, 섹션 제목 옆에 있는 "[edit]" 링크를 클릭하면 됩니다. 이들 링크를 클릭하면 다음과 같이 구성된 URL이 있는 편집 페이지로 이동합니다:

https://www.mediawiki.org/w/index.php?title=Help:Advanced_editing&action=edit§ion=9

섹션 제목을 사용하는 대신 섹션 편집은 섹션 번호를 사용합니다. 하위 섹션은 단일 번호로 표시됩니다 (예를 들어, 위의 링크에서, 목차의 테이블에서 섹션 2는 링크에서 9로 번호가 매깁니다). 이렇게 하면 페이지의 전체 텍스트를 볼 필요 없이 집중적으로 편집할 수 있습니다. 특히 큰 페이지에 유용한데, 왜냐하면 편집 프로세스를 간소화하고 잡동사니를 줄여주기 때문입니다. 이미 있는 URL을 통해 __NOEDITSECTION__ 섹션 편집을 추가해도 여전히 작동합니다.

섹션을 삽입할 때, 이전이나 다음 섹션을 편집하고, 필요하다면 머릿글을 삭제함으로써 병합하고, 그런-다음 편집 요약도 그에 맞게 조정하십시오.

Including a section at the end

페이지 끝에 새로운 섹션을 추가하기 위해, 다음과 같은 URL을 사용할 수 있습니다:

https://www.mediawiki.org/w/index.php?title=Project:Sandbox&action=edit§ion=new

토론 페이지와 위키텍스트가 있는 페이지에서, __NEWSECTIONLINK__ 코드를 사용하여 편집 탭 옆에 "⧼skin-action-newsection⧽"이라는 제목의 특별 링크를 생성할 수 있습니다. 이 링크를 클릭하면 새 섹션의 머릿글을 입력할 수 있는 텍스트 상자가 열립니다. 편집 요약은 자동으로 생성됩니다. 생성된 편집 요약은 /* Section Name */ /* $1 */ new section이며, 이는 자동으로 오른쪽 화살표로 렌더링됩니다. 이렇게 되면 사용자 지정 편집 요약을 제공할 수 있는 옵션이 없습니다.

만약 주제 상자를 비워두면, 빈 == ==   구분 기호가 삽입되지 않고, 컨텐츠가 페이지의 마지막 섹션에 추가됩니다. 이 방법은 제목이 없는 새 섹션을 만드는 것을 지원하지 않고 편집 요약을 제공하는 것을 허용하지 않습니다. "Preloadtitle" 매개변수는 "Subject/headline" 필드에 표시되는 첫 번째 텍스트를 결정합니다.

https://www.mediawiki.org/w/index.php?title=Project:Sandbox&action=edit§ion=new&preloadtitle=pqr

사전 로드는 저장하기 전에 편집될 수 있습니다.

Editing before a first section

일반적으로 첫 번째 섹션 머릿글 앞에 있는 서론 텍스트를 편집하기 위한 지정된 링크는 없습니다 (phab:T2156). 어쨌든, 링크에서 섹션 번호로 0을 사용함으로써 이 부분에 섹션 편집 기능을 적용할 수 있으며, 다음처럼 사용됩니다:

https://www.mediawiki.org/w/index.php?title=Help:Advanced_editing&action=edit§ion=0

대안적으로, 섹션 번호를 변경함으로써 페이지의 섹션 편집 링크를 수정할 수 있습니다.

자바스크립트를 사용하여 같은 URL을 생성하기 위해, w:Wikipedia:WikiProject User scripts/Scripts/Edit Top을 참조하십시오.

Preview

만약 이전 섹션에서 이미지가 현재 섹션과 겹치면 섹션 편집 미리보기가 전체 페이지와 다를 수 있습니다.

편집 페이지에는 다른 섹션의 템플릿을 포함하여 전체 페이지에서 사용된 모든 템플릿이 표시됩니다.

Working with subsections

섹션을 편집할 때, 하위 섹션이 포함되고 편집된 부분을 기준으로 1부터 시작하여 번호가 매겨집니다. 하위 섹션은 1.1, 1.2, 등과 같은 번호로 표시됩니다. 머릿글 형식은 절대 수준을 따르며, 하위 하위 섹션은 그에 따라 번호가 매겨집니다. 예를 들어, 하위 하위 섹션 3.2는 3.2.1, 3.2.2로 번호가 매겨집니다.

Editing a page with large sections

만약 페이지에 섹션이 많거나 섹션 구분이 부족한 경우라면, 사용자는 다음에 의해 컨텐츠를 여전히 수정할 수 있습니다:

  • 새로운 섹션 머릿글 앞에 빈 줄을 두어 시작하고, 지정된 큰 섹션 번호를 갖는 섹션을 추가합니다.
  • 머릿글 없이 마지막 섹션에 컨텐츠를 추가하지만, 브라우저나 연결 제한으로 인해 새 텍스트를 되돌리거나 편집할 수 없습니다.

Editing sections of included templates

포함된 페이지나 템플릿 내에서 섹션을 편집할 수 있습니다. 섹션에 대한 편집 링크를 클릭하는 것은 별도 페이지의 편집 페이지로 이동합니다. 이 섹션 (Help:Section/Editing sections of included templates에서 전달-삽입)은 그 작동 방식을 보여줍니다.

포함된 페이지 또는 템플릿 내의 섹션의 크기는 그것이 포함된 주요 페이지의 제목에 의해 결정됩니다. 역시, 별도 페이지의 첫 번째 제목 앞에 있는 텍스트는 섹션의 일부이지만, 편집 링크를 클릭해도 텍스트가 표시되지 않을 것입니다. 마찬가지로, 템플릿 태그 뒤에 제목이 없는 텍스트가 있으면, 템플릿 앞에 있는 제목을 클릭하여 편집해야 합니다. 이 섹션에서는 그 작동 방식을 보여줍니다. 렌더링된 부모 페이지에서 명확성과 일관성을 보장하기 위해, 다음 지침을 따르십시오:

  • 템플릿 구조 - 템플릿 내의 첫 번째 제목 앞에 텍스트를 넣지 마십시오.
  • 섹션 처리 - 섹션이 있는 템플릿을 사용한 후 부모 페이지에서 새 섹션을 시작하십시오. 이렇게 하면 템플릿 섹션과 부모 페이지 섹션 사이의 충돌을 방지할 수 있습니다.

추가적으로, 템플릿을 효과적으로 관리하기 위해 다음 방법을 고려하십시오:

  • 템플릿 머릿글 - 때로는 섹션이 하나뿐이더라도 머릿글로 템플릿을 시작하는 것이 도움이 됩니다. 이렇게 하면 편집이 더 쉬워집니다.
  • 매개변수 사용 - 템플릿을 편집할 때, {{{1}}}와 같은 매개변수는 템플릿에서 직접 변경되는 것이 아니라 호출 페이지에서 변경된다는 점을 기억하십시오. 렌더링된 페이지에서 이것이 즉시 나타나지 않을 수 있지만, 설명 텍스트나 추가 편집 링크를 제공하면 사용자 이해도를 높일 수 있습니다.
  • NOEDITSECTION 태그 - __NOEDITSECTION__ 태그는 템플릿과 추가된 임의의 페이지, 그리고 같은 페이지의 다른 템플릿에 영향을 미칩니다. 대신, 미디어위키 섹션 헤더 마크업을 템플릿 내의 HTML 헤더 마크업으로 대체하여, 헤더가 시각적으로 일관되게 유지되는 동시에 편집 가능한 섹션으로 인식되는 것을 방지하는 것을 고려하십시오. 이 접근 방식은 템플릿 내에서 __NOEDITSECTION__의 필요성을 제거합니다.

예를 들어, 다음과 같이 구성된 템플릿을 생각해 보십시오:

==Template heading 1==
Content
===Template heading 2===
Content

템플릿을 전달-삽입할 때 "edit section" 링크가 나타나지 않도록 하려면 템플릿 코드 내에 NOEDITSECTION을 추가하십시오. 어쨌든, 이렇게 하면 템플릿이 사용된 페이지에서 모든 "edit section" 링크가 억제됩니다. 추가적으로, HTML 헤딩 태그 (<h2>, <h3>,등)로 템플릿을 구조화하면 전달-삽입 페이지에서 다른 섹션의 편집 링크에 영향을 미치지 않고 같은 시각적 효과를 얻을 수 있습니다.

<h2>Template heading 1</h2>
Content
<h3>Template heading 2</h3>
Content

Sections within a parser function

파서 함수를 사용하여 섹션을 갖는 템플릿을 조건부로 전달-삽입할 때, 이들 섹션에 대해 편집 링크가 잘못된 섹션으로 연결되거나 섹션이 존재하지 않는다는 오류 메시지가 표시될 수 있습니다. 이는 조건부로 포함된 템플릿의 컨텐츠가 페이지 자체의 일부로 고려되어, 확장 후 섹션이 계산되기 때문에 발생합니다.

결과로서, 포함된 템플릿 내의 섹션에 대한 편집 링크는 템플릿 대신 페이지로 연결되고, 이후의 편집 링크는 올바른 페이지를 참조하지만 잘못된 섹션 번호를 가집니다. 조건부 이름을 갖는 템플릿을 전답-삽입할 때는 이 문제가 발생하지 않으며, 이는 추가적인 이점을 제공합니다.

Editing footnotes

<references />를 사용하여 섹션의 각주를 편집하기 위해, 각주 마크가 있는 섹션을 찾아 편집합니다. 자세한 도움말에 대해 Help:Footnotes를 확인하십시오.

Viewing a section

섹션 편집 기능을 사용하면 전체 페이지를 로드하지 않고도 특정 섹션을 볼 수 있습니다.

Sections vs. separate pages vs. transclusion

각각의 장점은 다음과 같습니다:

섹션을 갖는 하나의 큰 페이지의 장점:

  • 여러 개의 작은 페이지에 접근하는 것보다 더 빠르게 접근하고 검색도 더 간단합니다.
  • 복잡한 주제에 대한 개념적 응집성을 유지합니다.

별도 페이지의 장점:

  • what links here 기능을 사용하여 별도의 링크와 기록을 통해 쉽게 탐색하고 편집할 수 있습니다.
  • 페이지 크기가 작아 로딩 시간이 빨라졌습니다.
  • 이름 변경 시 자동으로 리다이렉션됩니다.
  • 독립적인 분류 및 주석을 통해 조직 및 데이터 관리가 개선됩니다.
  • 일부 템플릿은 페이지당 적용에 제한이 있습니다.

전달-삽입에 의한 복합 문서의 장점:

  • 전달-삽입은 한 페이지의 내용을 다른 페이지에 포함시키는 것으로, 종종 템플릿을 통해 수행됩니다.
  • 사용자는 결합된 렌더링된 페이지 내에서 탐색하고 검색할 수 있어 사용성이 향상되었습니다.

Disadvantages:

  • 사용자는 결합된 위키텍스트 내에서 직접 검색할 수 없습니다.
  • 포함된 각 페이지에 제목을 붙이는 것은 번거로울 수 있습니다.
  • 확장 후 include 크기와 관련된 제한이 있어, 특히 포함되는 페이지가 크거나 많은 경우 기술적 문제가 발생할 가능성이 있습니다.

Sections and Table of Content (ToC)

Adding Non-Section Text to TOC

<h4>...</h4> 헤더 태그를 사용하여 텍스트를 TOC 항목으로 표시할 수 있습니다. 이들 태그 내부에서 평소와 같이 서식을 사용자 정의합니다. 사용 예제 (두 번째는 명확성을 위해 더 잘 서식이 지정됩니다):

{| class="collapsible collapsed" style="text-align:left; border:0px; margin-top:0.2em"
|-
! style="background-color:#f2dfce" | <h4>Stuff</h4>
|-
| Contents about stuff here
|}

{| class="collapsible collapsed" style="text-align:left; border:0px; margin-top:0.2em"
|-
! style="background-color:#f2dfce; padding-top:0; padding-bottom:0" |
 <h4 style="margin:0; padding:0;font-size:95%">More stuff</h4>
|-
| Contents about more stuff here
|}

명확히 하자면, 축소 상자 헤더를 목차 (TOC)에 포함된 섹션 머릿글로 처리하고, 페이지 자체에 형식적인 "섹션 제목"을 지정할 필요는 없습니다.

권장하지는 않지만, 텍스트에 없지만 약간 다른 문구가 있는 섹션 머릿글에 대한 링크 앵커 역할을 하는 TOC 항목을 만들 수 있습니다:

<h4 style="display:none">Your heading here</h4>

Sections for the above demo

Demo abc

이 섹션은 #Linking to a section로 연결됩니다.

See also

관련글

티스토리툴바