고급 문서 목록(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 대신 비슷한 기능을 하는 대체재를 사용하는 것이 좋습니다. 아래는 대표적인 대체재들입니다. 원하는 대체재를 찾기 힘드시다면 특수기능:문의를 통해 저희에게 도움을 요청하실 수도 있습니다.
분류에 속한 문서 목록 (자세히)
- 분류에 속한 문서들을 나열하고 싶을 때는 <categorytree> 태그를 사용할 수 있습니다.
- 예를 들어 “커뮤니티” 분류에 속한 모든 문서를 나열할 때는 다음 코드를 이용할 수 있습니다.
<categorytree mode="pages" hideroot=on>Community</categorytree>
랜덤 목록
- RandomSelection을 참고하세요.
달력
- SimpleCalendar를 참고하세요.
피해야할 것[]
DPL을 사용할 때 다음 행위는 피해 주세요.
- “randomcount” 조건 사용 ― 결과 캐시 불가
- 많은 곳에서 쓰이는 틀에 DPL 추가 ― 서버 부담 증가
- 너무 많은 조건 사용 ― 서버 부담 증가
- 한 페이지에 DPL 3개 이상 사용 ― 서버 부담 증가
자주 일어나는 오류[]
- DPL 결과가 이상하게 표시된다면 URL 끝에 ?action=purge 코드를 추가해 캐시를 초기화해 주세요.
도움 및 문의[]
- 도움말:콘텐츠에서 더 많은 정보를 찾을 수 있습니다.
- 도움말:팬덤 중앙 커뮤니티에서 도움을 구할 수 있습니다.
- 도움말:문의하기에서 팬덤에 문의하는 법을 찾을 수 있습니다.