CodeMirror 확장은 미디어위키에서 기본적으로 제공하는 wikitext 편집기에 구문 강조(syntax highlighting)를 제공해 줍니다. 도구 모음에 연필 모양 아이콘이 있는 단추를 추가하여 구문 강조 표시를 켜거나/끌 수 있습니다. 클래식 편집 도구 모음과 WikiEditor 확장 및 VisualEditor 확장을 지원합니다.
기본적으로, 스위치는 꺼져 있습니다. 스위치를 켰을 때, 표준 텍스트 영역이 CodeMirror 라이브러리에서 제공하는 편집기로 바뀝니다. 스위치를 끝을 때, 반대의 효과가 나타납니다.
wikitext 강조 표시에 자신만의 스타일을 사용할 수 있습니다. 사용 가능한 스타일은 여기에 있습니다. 자신의 스타일을 common.css에 배치해야 합니다. 더 나은 스타일을 발견한 경우에는 알려 주시기 바랍니다.
Installation
미디어위키 확장 내려받기 지면에서 해당 판을 내려받아서 정해진 위치로 이동시킵니다.
미디어위키 설정 LocalSettings.php 파일에 다음을 추가합니다:
wfLoadExtension( 'CodeMirror' );
데이터베이스의 변경이 필요하기 때문에 아래 명령을 수행해야 합니다.
- cd /var/www/html/w
- php maintenance/update.php
Special:Version에 접근해서 확장이 정상적으로 설치가 되었는지 확인을 합니다.
Configuration
CodrMirror를 기본적으로 활성화하기 위해서는 다음을 CodeMirror 확장을 활성화한 줄 다음에 추가하십시요.
$wgDefaultUserOptions['usecodemirror'] = 1;
색상 및 스타일 사용자 정의에 대해서는, metawikimedia:Community Tech/Wikitext editor syntax highlighting#Color and style customization를 참조하십시오.
Extension integration
만약 MediaWiki 확장이 새로운 태그를 추가하고 CodeMirror가 그 안에 내용을 적절하게 강조 표시하려면, 확장에 CodeMirror 지원을 추가할 수 있습니다. 다음은 두 가지 예제입니다: Cite extension and PhpTags extension.
Troubleshooting
최근 mediawiki-1.35.-wmf.23에서 이 확장을 사용하면, 파이어폭스 브라우저에서 한글 입력이 정상적으로 동작하지 않습니다. 이것은 파이어폭스에서 스펠체크를 활성화하는 패치로 인해서 생기는 문제로 영문은 영향을 받지 않습니다. 이전 코드를 사용하시던지 이 패치를 제거하십시오.
See also
- User:Remember the dot/Syntax highlighter
- Extension:VisualEditor
- Extension:WikiEditor
- CodeEditor Extension
- Community Tech/Wikitext editor syntax highlighting (includes information on customizing the colors)