도움말:고급 문서 목록

고급 문서 목록(Dynamic Page List, DPL)은 특정 조건에 맞는 문서들을 목록으로 나열해주는 미디어위키 확장 기능입니다.

특징편집

• 특정 조건에 맞는 문서들을 목록으로 나열해서 보여줍니다. 특정 조건은 임의로 정할 수 있습니다.
  • 예: A 분류에 속한 문서들, A 틀을 포함하는 문서들
• 한 목록에 여러 개의 조건을 넣을 수 있습니다.
  • 예: A 분류에 속하면서 동시에 B 분류에 속하는 문서들
• DPL을 사용하면 로딩 속도가 매우 저하될 수 있습니다. 이를 방지하기 위해선 DPL을 효율적으로 사용하는 법을 참고하세요.
• 다양한 스타일(표, 점 목록, 숫자 목록, 분류 문서 스타일, 일렬)로 목록을 표시할 수 있습니다.

사용법편집

사용할 수 있는 모든 조건은 이곳(영어)에서 확인하실 수 있습니다.

• DPL 태그는 <dpl>로 시작해서 </dpl>로 끝납니다.
• 목록 조건에 대한 정보는 DPL 태그 안에 넣으면 됩니다.
• 상황에 따라 태그 대신 {{#dpl: .... }} 코드를 사용할 수도 있습니다.

다음은 기초적인 DPL 태그 예제입니다.

<DPL>
category=등장인물
</DPL>

이 태그는 “등장인물”이라는 분류에 속한 모든 문서를 목록으로 보여줍니다.

조건을 추가해서 다음과 같이 할 수도 있습니다.

<DPL>
category=주인공
namespace=등장인물
notcategory=1기 등장인물
mode=ordered
</DPL>

이 태그의 조건을 정리하면 다음과 같습니다.

• “주인공” 분류에 속하면서...
• “등장인물” 이름 공간에도 속한 문서.
• 단, “1기 등장인물” 분류에 속했을 경우 제외.

최적화 방법편집

DPL은 많은 서버 로딩을 요구하기 때문에 사이트 전체의 속도를 저하시킬 수 있습니다. 아래를 참고해 속도 저하를 최소화시키는 것이 좋습니다.

DPL이 정말 필요한지 생각하세요.

단순히 멋져 보이기 위해 DPL을 추가하는 것이라면 대체재로 설문조사나 달력, RSS 피드, 동영상 같이 다른 멋진 요소들도 많습니다.

결과를 캐시로 저장하세요.

아래 조건을 DPL에 추가하면 결과를 캐시로 저장해서 보여주기 때문에 서버 부담을 줄일 수 있습니다.

allowcachedresults=true

대체재편집

될 수 있으면 DPL 대신 비슷한 기능을 하는 대체재를 사용하는 것이 좋습니다. 아래는 대표적인 대체재들입니다. 원하는 대체재를 찾기 힘드시다면 특수기능:문의를 통해 저희에게 도움을 요청하실 수도 있습니다.

분류에 속한 문서 목록 (자세히)

랜덤 목록

달력

피해야할 것편집

DPL을 사용할 때 다음 행위는 피해 주세요.

• “randomcount” 조건 사용 ― 결과 캐시 불가
• 많은 곳에서 쓰이는 틀에 DPL 추가 ― 서버 부담 증가
• 너무 많은 조건 사용 ― 서버 부담 증가
• 한 페이지에 DPL 3개 이상 사용 ― 서버 부담 증가

자주 일어나는 오류편집

• DPL 결과가 이상하게 표시된다면 URL 끝에 ?action=purge 코드를 추가해 캐시를 초기화해 주세요.

도움 및 문의편집

• 도움말:콘텐츠에서 더 많은 정보를 찾을 수 있습니다.
• 도움말:팬덤 중앙 커뮤니티에서 도움을 구할 수 있습니다.
• 도움말:문의하기에서 팬덤에 문의하는 법을 찾을 수 있습니다.