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

미디어위키(Mediawiki) 설치 권장 추가 익스텐션(Extension) MsLinks 설치와 활용

씨실과 날실 2020. 7. 7. 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 설치와 활용




추천 추가 익스텐션





익스텐션 연재 목록




[익스텐션명 익스텐션 관련 정보]

익스텐션 공식 안내 페이지

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

다운로드

미디어위키 내 배포 페이지

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

github 페이지

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


MsLinks 익스텐션 기능

MsLinks 익스텐션은 파일 유형에 적합한 아이콘을 추가하여 파일을 보거나 다운로드 할 수 있는 링크를 작성하는 버튼을 편집기에 추가합니다.




익스텐션 다운로드 및 설치

다운로드 안내

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


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

익스텐션 공식 배포처

미디어위키 내 배포 페이지

github 페이지




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

1.34

https://extdist.wmflabs.org/dist/extensions/MsLinks-REL1_34-8ef9d24.tar.gz

1.33

https://extdist.wmflabs.org/dist/extensions/MsLinks-REL1_33-03e3d07.tar.gz

1.32


1.31

https://extdist.wmflabs.org/dist/extensions/MsLinks-REL1_31-2929dfd.tar.gz

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

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

리눅스 서버의 경우

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


예시 - Ubuntu

$ sudo tar -xzf MsLinks-REL1_34-8ef9d24.tar.gz -C /var/www/html/w/extensions

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


익스텐션 다운로드

study@study-VirtualBox:~/MW_Ext$ wget https://extdist.wmflabs.org/dist/extensions/MsLinks-REL1_31-2929dfd.tar.gz
--2020-06-09 14:57:48--  https://extdist.wmflabs.org/dist/extensions/MsLinks-REL1_31-2929dfd.tar.gz
Resolving extdist.wmflabs.org (extdist.wmflabs.org)... 185.15.56.49
접속 extdist.wmflabs.org (extdist.wmflabs.org)|185.15.56.49|:443... 접속됨.
HTTP request sent, awaiting response... 200 OK
Length: 26752 (26K) [application/octet-stream]
Saving to: ‘MsLinks-REL1_31-2929dfd.tar.gz’

MsLinks-REL1_31-292 100%[===================>]  26.12K  --.-KB/s    in 0.006s  

2020-06-09 14:57:50 (4.64 MB/s) - ‘MsLinks-REL1_31-2929dfd.tar.gz’ saved [26752/26752]

study@study-VirtualBox:~/MW_Ext$ 


익스텐션 압축 풀기

study@study-VirtualBox:~/MW_Ext$ sudo tar -xzf MsLinks-REL1_31-2929dfd.tar.gz -C /var/www/html/w/extensions
study@study-VirtualBox:~/MW_Ext$ 

윈도 서버의 경우

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


호스팅을 받는 경우

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




MsLinks 익스텐션 필수 설정

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

wfLoadExtension( 'MsLinks' );


설치 확인

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




MsLinks 익스텐션 사용법

LocalSettings.php 파일에 아래의 코드를 추가해줍니다.

$wgMSL_FileTypes = [
    'no' => 'no_icon.png',
    'jpg' => 'image_icon.png',
    'gif' => 'image_icon.png',
    'bmp' => 'image_icon.png',
    'png' => 'image_icon.png',
    'tiff' => 'image_icon.png',
    'tif' => 'image_icon.png',
    'ai' => 'image_ai_icon.png',
    'psd' => 'image_ps_icon.png',
    'pdf' => 'pdf_icon.png',
    'pps' => 'pps_icon.png',
    'ppt' => 'pps_icon.png',
    'pptx' => 'pps_icon.png',
    'xls' => 'xls_icon.png',
    'xlsx' => 'xls_icon.png',
    'doc' => 'doc_icon.png',
    'docx' => 'doc_icon.png',
    'dot' => 'doc_icon.png',
    'dotx' => 'doc_icon.png',
    'rtf' => 'doc_icon.png',
    'txt' => 'txt_icon.png',
    'html' => 'code_icon.png',
    'php' => 'code_icon.png',
    'exe' => 'exe_icon.gif',
    'asc' => 'txt_icon.png',
    'dwg' => 'dwg_icon.gif',
    'zip' => 'zip_icon.png',
    'mov' => 'movie_icon.png',
    'mpeg' => 'movie_icon.png',
    'mpg' => 'movie_icon.png',
    'wmv' => 'movie_icon.png',
    'avi' => 'movie_icon.png',
    'mp4' => 'movie_icon.png',
    'flv' => 'movie_flash_icon.png',
    'wma' => 'music_icon.png',
    'mp3' => 'music_icon.png',
    'wav' => 'music_icon.png',
    'mid' => 'music_icon.png',
];



기본 제공 익스텐션인 WikiEditor 익스텐션이 활성화된 상태에서 MsLinks 익스텐션을 설치한 후 위키 문서 편집 화면입니다.

각주 버튼 옆에 MsLinks 버튼이 추가된 것을 확인할 수 있습니다.


위 그림은 MsWikiEditor와 MsLinks 두 익스텐션이 같이 적용된 상태의 모습입니다.


MsWikiEditor 익스텐션의 MsLinks 관련 설정을 제거한 후 모습입니다.



{{#l:Nh_001_0010.pdf}}


{{#l:Nh_001_0010.pdf|해당 파일에 대한 설명}}


{{#l:Nh_001_0010.pdf|해당 파일에 대한 설명|right}}


{{#l:dlink|Nh_001_0010.pdf|클릭하면 해당 파일이 다운로드됩니다.}}

위키 문서 편집 화면에 위상자와 같이 입력하고 문서를 저장 후 읽어보면 아래 그림과 같이 표시됩니다.


MsLinks 기본 설정 적용 후 화면입니다

위 세 링크를 누르면 아래와 같이 해당 파일 정보 문서로 이동합니다.



마지막 링크를 누르면 파일을 직접 다운받을 수 있습니다.

그러나 어떤 이유에선지 직접 다운로드가 되지 않고 위와 마찬가지로 파일 정보 문서로 이동하게 되는 경우가 있습니다.

이는 미디어위키 또는 해당 익스텐션의 버그로 발생할 수 있습니다.


확장자별 이미지 예시

== MsLinks 익스텐션 ==
{{#l:Nh_001_0010.pdf}}


{{#l:Nh_001_0010.pdf|해당 파일에 대한 설명}}


{{#l:Nh_001_0010.pdf|해당 파일에 대한 설명|right}}


{{#l:dlink|Nh_001_0010.pdf|클릭하면 해당 파일이 다운로드됩니다.}}


{{#l:파일명.jpg|jpg 이미지 파일}}{{#l:파일명.gif|gif 이미지 파일}}{{#l:파일명.bmp|bmp 이미지 파일}}{{#l:파일명.png|png 이미지 파일}}{{#l:파일명.tif|tif 이미지 파일}}{{#l:파일명.tiff|tiff 이미지 파일}}

{{#l:파일명.ai|ai 어도비 일러스트레이터 파일}} {{#l:파일명.psd|psd 어도비 포토샵 파일}}

{{#l:파일명.pps|MS 파워포인트 pps 파일}} {{#l:파일명.ppt|MS 파워포인트 ppt 파일}} {{#l:파일명.pptx|MS 파워포인트 pptx 파일}}

{{#l:파일명.xls|MS 엑셀 xls 파일}} {{#l:파일명.xlsx|MS 엑셀 xlsx 파일}}

{{#l:파일명.doc|MS 워드 doc 파일}} {{#l:파일명.docx|MS 워드 docx 파일}} {{#l:파일명.dot|MS 워드 dot 파일}} {{#l:파일명.dotx|MS 워드 dotx 파일}} {{#l:파일명.rtf|MS 워드 rtf 파일}}

{{#l:파일명.dwg|dwg 오토캐드 파일}}

{{#l:파일명.txt|txt 일반 텍스트 파일}}{{#l:파일명.asc|asc ASCII 텍스트 파일}}

{{#l:파일명.pdf|PDF 파일}}

{{#l:파일명.exe|exe 실행 가능 파일}}

{{#l:파일명.zip|zip 압축 파일}}

{{#l:파일명.mov|mov 동영상 파일}} {{#l:파일명.mpeg|mpeg 동영상 파일}} {{#l:파일명.mpg|mpg 동영상 파일}} {{#l:파일명.wmv|wmv 동영상 파일}} {{#l:파일명.avi|avi 동영상 파일}} {{#l:파일명.mp4|mp4 동영상 파일}} {{#l:파일명.flv|flv 동영상 파일}}

{{#l:파일명.wma|wma 오디오 파일}} {{#l:파일명.mp3|mp3 오디오 파일}} {{#l:파일명.wav|wav 오디오 파일}}{{#l:파일명.mid|mid 오디오 파일}}

{{#l:파일명.html|html 파일}} {{#l:파일명.php|php 파일}}


확장자별 이미지가 적용된 화면입니다.

여기에 사용된 이미지들은 익스텐션 디렉터리의 하위 디렉터리인  images 디렉터리에서 확인할 수 있습니다.


이미지 추가

만약 다른 확장자를 추가하고 싶다면 가로 세로 16픽셀의 png 이미지 파일을 만들어 익스텐션 디렉터리의 하위 디렉터리인  images 디렉터리에 저장한 다음 LocalSettings.php 파일에 아래의 코드를 추가해주시면 됩니다.

    '확장자명' => '이미지 파일명.png',