미디어위키/미디어위키 익스텐션

미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) Cite 설치와 활용

씨실과 날실 2020. 5. 1. 09:00

[익스텐션 목록]

기본 익스텐션

2019/10/29 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) Interwiki 설치와 활용

2020/04/28 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) Nuke 설치와 활용

2020/04/28 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) Renameuser 설치와 활용

2020/04/29 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) CiteThisPage 설치와 활용

2020/04/29 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) Replace Text 설치와 활용

2020/04/29 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) WikiEditor 설치와 활용

2020/04/30 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) CodeEditor 설치와 활용

2020/04/30 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) CategoryTree 설치와 활용

2020/05/01 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) Cite 설치와 활용

2020/05/01 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) ImageMap 설치와 활용

2020/05/02 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) InputBox 설치와 활용

2020/05/02 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) ParserFunctions 설치와 활용

2020/05/03 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) Poem 설치와 활용

2020/05/03 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) SyntaxHighlight 설치와 활용

2020/05/04 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) PDF Handler 설치와 활용

2020/05/04 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) ConfirmEdit 설치와 활용

2020/05/05 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) SpamBlacklist 설치와 활용

2020/05/05 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) TitleBlacklist 설치와 활용

2020/05/06 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) Gadgets 설치와 활용

2020/05/06 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) LocalisationUpdate 설치와 활용

2020/05/07 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) MultimediaViewer 설치와 활용

2020/05/07 - [미디어위키/미디어위키 익스텐션] - 미디어위키(Mediawiki) 기본 제공 익스텐션(Extension) OATHAuth 설치와 활용




[Cite 익스텐션 관련 정보]

익스텐션 공식 안내 페이지

https://www.mediawiki.org/wiki/Extension:Cite

다운로드

미디어위키 내 배포 페이지

https://www.mediawiki.org/wiki/Special:ExtensionDistributor/Cite

github 페이지

https://github.com/wikimedia/mediawiki-extensions-Cite


Cite 익스텐션 기능

출처를 밝히거나 참고 내용을 추가할 수 있는 각주를 제공하는 태그 형식의 익스텐션입니다.

MediaWiki에 <ref>와 <references /> 이 두 개의 파서 훅을 추가합니다. 이들은 페이지에 인용을 추가하기 위해 함께 작동합니다.




익스텐션 다운로드 및 설치

다운로드 안내

익스텐션 다운로드 및 설치 방법은 아래 링크를 참고하시기 바랍니다.


사용 중인 미디어위키의 버전에 맞는 배포 익스텐션 압축 파일을 다운로드받습니다.

익스텐션 공식 배포처

미디어위키 내 배포 페이지

https://www.mediawiki.org/wiki/Special:ExtensionDistributor/Cite

github 페이지

https://github.com/wikimedia/mediawiki-extensions-Cite




미디어위키 버전별 익스텐션 다운로드 주소

1.34

https://extdist.wmflabs.org/dist/extensions/Cite-REL1_34-db87fdc.tar.gz

1.33

https://extdist.wmflabs.org/dist/extensions/Cite-REL1_33-01ef641.tar.gz

1.32

https://extdist.wmflabs.org/dist/extensions/Cite-REL1_32-c9ff3c8.tar.gz

1.31

https://extdist.wmflabs.org/dist/extensions/Cite-REL1_31-20e26df.tar.gz

위 주소는 코드 수정으로 바뀔 수 있으므로 다운이 받아지지 않는다면 위 공식 루트를 통해 다운받으시기 바라비니다.

다운로드 받은 압축 파일을 서버 안 미디어위키 설치 폴더 내에 있는  extensions폴더 안에 풀어줍니다.

리눅스 서버의 경우

$ sudo tar -xzf Cite-REL1_34-db87fdc.tar.gz -C /미디어위키 설치 경로/extensions


예시 - Ubuntu

$ sudo tar -xzf Cite-REL1_34-db87fdc.tar.gz -C /var/www/html/w/extensions

위 명령은 제 블로그를 그대로 따라오신 분의 경우 적용되는 예시입니다.


git을 통해 설치하는 경우

익스텐션 디렉터리(Cite)에서 PHP 종속성을 설치하기 위래 아래의 명령을 이용해 Composer를 실행해주십시오.

composer install --no-dev

이와 관련하여 아래 링크를 참고하시기 바랍니다.


윈도 서버의 경우

탐색기로 압축 파일을 해당 위치에 풀어주시면 됩니다.


호스팅을 받는 경우

파일질라, 알FTP 등 FTP 프로그램을 이용해 미리 풀어 놓은 익스텐션 폴더(Cite)를 통째로 해당 위치에 전송해줍니다.




Cite 익스텐션 필수 설정

미디어위키의 환경 설정 파일인 LocalSettings.php 파일에 다음과 같은 코드를 추가해줍니다.

wfLoadExtension( 'Cite' );


... 전략 ...

# Enabled extensions. Most of the extensions are enabled by adding
# wfLoadExtensions('ExtensionName');
# to LocalSettings.php. Check specific extension documentation for more details.
# The following extensions were automatically enabled:
wfLoadExtension( 'CategoryTree' );
wfLoadExtension( 'Cite' );
wfLoadExtension( 'CiteThisPage' );
wfLoadExtension( 'CodeEditor' );
wfLoadExtension( 'ConfirmEdit' );
wfLoadExtension( 'Gadgets' );
wfLoadExtension( 'ImageMap' );
wfLoadExtension( 'InputBox' );
wfLoadExtension( 'Interwiki' );
wfLoadExtension( 'LocalisationUpdate' );
wfLoadExtension( 'MultimediaViewer' );
wfLoadExtension( 'Nuke' );
wfLoadExtension( 'OATHAuth' );
wfLoadExtension( 'ParserFunctions' );
wfLoadExtension( 'PdfHandler' );
wfLoadExtension( 'Poem' );
wfLoadExtension( 'Renameuser' );
wfLoadExtension( 'ReplaceText' );
wfLoadExtension( 'SpamBlacklist' );
wfLoadExtension( 'SyntaxHighlight_GeSHi' );
wfLoadExtension( 'TitleBlacklist' );
wfLoadExtension( 'WikiEditor' );

# End of automatically generated settings.
# Add more configuration options below.

... 후략 ...

미디어위키 설치시 기본 제공 익스텐션을 함께 설치하도록 설정한다면 코드는 보통 위 예시와 같은 위치에 추가됩니다.


설치 확인

미디어위키의 특수:버전(= Special:Version) 문서를 확인하면 위 익스텐션이 추가된 것을 확인할 수 있습니다.




Cite 익스텐션 추가 구성 설정

$wgCiteBookReferencing

// 기본값 : false

하위 참조에 대한 실험적인 기능을 활성화하려면  true로 설정해줍니다.

관련 도움말은 위 링크를 참고하시기 바랍니다.


$wgCiteResponsiveReferences

// 기본값 : true

반응형 참조 표시를 위한 기본 설정입니다.

true로 설정하면 참조 섹션이 여러 열로 표시됩니다.

위 링크를 참조하시기 바랍니다.


$wgCiteVisualEditorOtherGroup

// 기본값 : false

 true로 설정하면 인용 도구 모음 버튼을 삽입 메뉴 아래로 이동할 수 있습니다. Wikivoyage 사이트에서 사용됩니다.

추가 정보는 위 링크를 참조하시기 바랍니다.



Cite 익스텐션 사용법

기본 사용법

<ref>와 </ref> 태그로 둘러싸인 텍스트에 대한 각주를 둘 곳을  각주 자리 표시 태그인 <references /> 로 지정하여 해당 자리에 각주를 표시합니다.



조선왕조실록<ref>조선 태조 때부터 철종 때까지 25대 427년간의 역사적 사실을 연대순으로 적은 사서</ref>은 대한민국의 국보이자, 유네스코 세계기록유산이다.

== 각주 ==
<references />


고급 사용법

보다 다양한 인용법은 아래 링크를 참고하시기 바랍니다.



김상옥<ref  name = "presidential_medal" >이들은 건국훈장 대통령장 수훈자입니다.</ref>, 김익상<ref  name = "presidential_medal"  />, 김지섭<ref  name = "presidential_medal"  />,  윤세주은 의열단원입니다.

== 각주 ==
<references ​/>



고려국사, 동국사략<ref  group = "사서 형식" >편년체</ref>, 고려사<ref  group = "사서 형식" >기전체</ref>, 고려사절요<ref  group = "사서 형식" >편년체</ref>, 국조보감<ref  group = "사서 형식" >편년체</ref>, 동국통감<ref  group = "사서 형식" >편년체</ref>, 동국사략<ref  group = "사서 형식" >강목체</ref>, 여사제강<ref  group = "사서 형식" >편년체</ref>, 동몽선습, 동국통감제강, 동사회강<ref  group = "사서 형식" >편년체</ref>, 동사강목<ref  group = "사서 형식" >강목체</ref>, 열조통기<ref  group = "사서 형식" >편년체</ref>, 발해고, 동사<ref  group = "사서 형식" >기전체</ref>, 연려실기술<ref  group = "사서 형식" >기사본말체</ref>, 해동역사<ref  group = "사서 형식" >편년체</ref>, 동국통지<ref  group = "사서 형식" >기전체</ref><ref> 조선시대 사서 </ref>

== 사서 형식 ==
<references group = "사서 형식" />

== 각주 ==
<references />



<big>태조실록 1권, 태조 1년 7월 18일 정유 3번째기사</big>

의흥친군위(義興親軍衛)를 설치하고 도총 중외 제군사부(都摠中外諸軍事府)를 폐지하였다.<ref name="정유" />


<big>태조실록 1권, 태조 1년 7월 28일 정미 3번째기사</big>

사대(四代)의 존호(尊號)를 사후(死後)에 올렸으니, 고조고(高祖考)는 목왕(穆王)이라 하고, 비(妣) 이씨(李氏)는 효비(孝妃)라 하였으며, 증조고(曾祖考)는 익왕(翼王)이라 하고, 비(妣) 최씨(崔氏)는 정비(貞妃)라 하였으며, 조고(祖考)는 도왕(度王)이라 하고, 비(妣) 박씨(朴氏)는 경비(敬妃)라 하였으며, 황고(皇考)는 환왕(桓王)이라 하고, 비(妣) 최씨(崔氏)는 의비(懿妃)라 하였다.<ref name="정미" />


== 각주 ==
<references>
<ref name="정유">【태백산사고본】 1책 1권 40장 A면【국편영인본】 1책 20면</ref>
<ref name="정미">【태백산사고본】 1책 1권 42장 B면【국편영인본】 1책 21면</ref>
</references>