FANDOM


importArticles() 코드를 이용하면 스크립트나 스타일을 포함하고 있는 문서를 다른 곳에 불러올 수 있습니다.

기능 자체는 importScriptPage 코드나 importStylesheetPage 코드와 비슷하지만, importArticles() 코드는 외부 위키에서 문서를 불러올 수 있고, 한 코드 안에 여러 문서를 넣어 길이를 최소화할 수 있다는 장점이 있습니다. 또 파일 크기와 웹 트래픽을 줄여줘 한 번에 많은 파일을 빠르게 불러올 수 있도록 해줍니다.

사용법편집

importArticles() 코드로 문서를 불러오려면 먼저 모듈을 정의해야 합니다. 모듈은 키/값과 함께 기본적인 자바 스크립트 요소입니다. 각 모듈에는 다음과 같은 요소가 요구됩니다:

  • type (유형) - 모듈이 포함할 문서의 종류. 다음과 같은 종류가 있습니다.
  • articles (문서) - 불러오고 싶은 문서. 자세한 사항은 "문서 위치" 항목을 참고하세요.

importArticles() 코드 안에 들어갈 수 있는 모듈 수의 제약은 없습니다. 단, 한 모듈에 들어간 문서들의 종류는 모두 동일해야 합니다.

Bulb 캐시

importArticles() 코드의 캐시는 최대 10분 간격으로 업데이트됩니다. 그러므로 importArticles() 코드가 사용되었다면 대략 10분 정도 후에, 변경된 자바 스크립트나 CSS 파일이 모든 사용자들에게 보여집니다.

문서 위치편집

문서의 위치를 정할 때는 인터위키를 생각하시면 됩니다.

(접두사:<위키이름>:)<문서>

소괄호 안에 있는 내용은 꼭 필요하지는 않은 부분입니다. 꺾쇠 괄호 안에 있는 내용은 사용자가 임의로 채워 넣어야 하는 부분입니다. 쌍점은 각 부분을 개별적 요소로 인식할 수 있도록 해줍니다. 접두사는 문서를 어떤 식으로 불러올지 정하는 부분입니다. 주로 위키 이름 앞에 (내부 커뮤니티에서 불러올 때는 제외) 위치합니다.

내부 문서편집

내부 문서는 단순히 링크를 연결하듯이 입력하면 됩니다. 기본적으로 위키 이름이나 접두사를 붙일 필요는 없습니다. 예를 들어 미디어위키:Common.js 문서를 불러오고 싶다면 다음과 같이 할 수 있습니다.

미디어위키:Common.js

외부 문서편집

외부 문서 또한 단순히 링크를 연결하듯이 입력하면 됩니다. 단 이때는 위키 이름과 접두사를 붙여서 어디서 문서를 가져오고, 어떤 식으로 인식해야 할지 명시해야 합니다. 외부 문서가 있는 장소는 URL로 정의할 수 있습니다. URL을 사용할 때는 u 접두사를 붙일 수 있습니다. 예를 들어 {{#NewWindowLink:http://dev.wikia.com%7C개발자 위키}}의 {{#NewWindowLink:http://dev.wikia.com/index.php?title=Highlight/code.css%7CHighlight/code.css}} 문서를 불러오고 싶다면 다음과 같이 할 수 있습니다.

u:dev:Highlight/code.css

다른 언어에서 문서를 불러올 수도 있습니다. 예를 들어 이탈리아어판 {{#NewWindowLink:http://it.onepiece.wikia.com%7C원피스 위키}}에서 {{#NewWindowLink:http://it.onepiece.wikia.com/index.php?title=MediaWiki:Common.js%7C미디어위키:Common.js}} 문서를 불러오고 싶다면 다음과 같이 할 수 있습니다.

u:it.onepiece:MediaWiki:Common.js

고급 사용편집

importArticles() 코드는 세 가지 작업을 수행합니다.

  1. 리소스로더를 위해 적절히 정리된 URL을 생성
  2. 모듈이 제대로 정리되었는지 확인
  3. 오류 발생 시 사용자에게 알림

하지만 이러한 방식으로는 완벽히 여러 문서를 하나의 요청으로 처리하고, 코드를 최소화할 수 없습니다. 필요하다면 직접 URL을 생성하고 CSS에서는 @import 선언을 통해, 자바 스크립트에서는 jQuery.getScript를 통해 문서를 불러올 수 있습니다.

다음과 같은 매개 변수들이 자주 쓰입니다.

매개 변수 설명
mode 리소스로더에게 문서를 불러온다는 사실을 알림. "articles"로 설정.
articles 문서 목록. 한 번에 많은 문서를 불러올 때는 "|"로 구분.
only 불러올 문서 종류. "scripts" 혹은 "styles"로 설정.
debug "true"로 설정하면 최소화 기능을 비활성화하고, 오류가 발생했을 때 더 쉽게 디버그할 수 있도록 해줌.

작성이 완료되면 대략 다음과 같은 결과물을 얻습니다.

/load.php?mode=articles&articles=One.css|Two.css&only=styles

@import 코드와 함께 쓰인다면 다음과 같이 됩니다.

@import url("/load.php?mode=articles&articles=One.css|Two.css&only=styles");

예제편집

한 번에 여러 스크립트 문서 불러오기. 하나는 내부에서, 하나는 외부에서.

importArticles({
    type: "script",
    articles: [
        "MediaWiki:MyCustomJavaScript.js",
        "external:dev:MediaWiki:External_include.js"
    ]
});

한 번에 여러 스타일 문서 불러오기. 하나는 내부에서, 하나는 외부에서.

importArticles({
    type: "style",
    articles: [
        "MediaWiki:Common.css",
        "external:starwars:MediaWiki:External_include.css"
    ]
});

한 번에 여러 유형 문서 불러오기.

importArticles({
    type: "script",
    articles: [
        "MediaWiki:MyCustomJavaScript.js",
        "external:dev:MediaWiki:External_include.js"
    ]
}, {
    type: "style",
    article: "MediaWiki:Common.css"
});

대체용 코드 예제편집

importArticles() 코드는 더 간단한 버전도 지원합니다. 내부에서 문서 하나를 불러올 때는 다음과 같이 됩니다.

importArticle({
    type: "style",
    article: "MediaWiki:Common.css"
});

함께 보기편집

도움 및 문의편집

Community content is available under CC-BY-SA unless otherwise noted.