Extension:CodeEditor

This page is a translated version of the page Extension:CodeEditor and the translation is 62% complete.
Outdated translations are marked like this.
この拡張機能は MediaWiki 1.31 以降に同梱されています。 そのため再度ダウンロードする必要はありません。 しかし、提供されているその他の手順に従う必要はあります。
MediaWiki 拡張機能マニュアル
OOjs UI icon advanced-invert.svg
CodeEditor
リリースの状態: 安定
CodeEditor extension screenshot.png
説明 サイトや利用者のJavaScript、CSS、Luaページ用、構文強調コードエディターを提供します。これは高機能編集ツールバーに統合されたものです。
作者
  • Brion Vibber
  • Derk-Jan Hartman
  • authors of Ace (ace.c9.io)
互換性ポリシー Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki 1.32+
データベースの変更 いいえ
ライセンス GPL-2.0-or-later AND BSD-3-Clause
ダウンロード
  • $wgCodeEditorEnableCore
translatewiki.net で翻訳を利用できる場合は、CodeEditor 拡張機能の翻訳にご協力ください

使用状況とバージョン マトリクスを確認してください。

問題点 未解決のタスク · バグを報告

CodeEditor拡張機能はWikiEditor高機能編集ツールバーを拡張するもので、Ace エディター ウィジェットに埋め込まれています。これは利用者やサイトがJavaScript、CSSのページを編集するときに便利な機能を提供します。またModule名前空間にあるページのため、Scribunto も合わせてインストールされます: The code editor does not show on regular wiki pages, i.e. wiki pages with the "wikitext" content model. (See Extension:CodeMirror for syntax highlighting of wikitext when using the source editor.)

以下の機能を提供します:

  • JavaScript・CSS・Luaのための構文ハイライト
  • オートインデント
  • tab key produces tab indents (since 1.22), soft indents before.
  • tab / shift+tabによってインデントを下げたり戻したりできます
  • JavaScriptの構文を検査します。
  • Pair-matching for parenthesis, braces and square brackets

インストール

この拡張機能は、WikiEditor拡張機能が必要です。 任意でScribunto拡張機能もインストールしてください。
  • Vagrant を使用している場合は、vagrant roles enable codeeditor --provision でインストールしてください
手動インストール
  • ダウンロードして、ファイルを extensions/ フォルダー内の CodeEditor という名前のディレクトリ内に配置します。
  • 以下のコードを LocalSettings.php の末尾に追加します:
    wfLoadExtension( 'CodeEditor' );
    $wgDefaultUserOptions['usebetatoolbar'] = 1; // user option provided by WikiEditor extension
    
  • 必要に応じて設定します。
  •   完了 – ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。

設定

$wgCodeEditorEnableCore
MediaWiki・利用者とその他の名前空間でJavascriptとCSSのエディターを無効にするには、$wgCodeEditorEnableCore = false;を設定します(デフォルトはtrue)。
$wgScribuntoUseCodeEditor
To disable this extension for Scribunto, i.e. in the module namespace set $wgScribuntoUseCodeEditor = false; (default is "true")
このパラメータはScribuntoを使用して動くため、CodeEditor起動後に追加する必要があります。
JavaScript

It is possible to change the configuration of the ACE editor, by hooking into the MediaWiki JS hook (i.e. mw.hook( 'codeEditor.configure' ).add( ... )). The argument passed to your hook will be an ACE editor session.

WikiEditor 統合

I've been integrating CodeEditor into the pluggable portions of Extension:WikiEditor as prep for Future editor work, since we'll want to be able to extend it to edit things that aren't plain wikitext, which'll need some changes to the toolbar setup and whatnot. まだこのJavaScriot / CSSは最終的にはプレーンテキストを返すようにより簡単な中間プロジェクトとなります。--brion 00:26, 14 June 2011 (UTC)

いい例:

  • 専用の文字挿入機能が動作します。
  • 基本的な書式設定の挿入
  • 検索・置換ダイアログが動作した
    • ace's built-in search/replace UI also triggers from keyboard commands, still need to disable them! (onCommandKey)

悪い例:

  • multi-line formatting doesn't apply correctly (but really should that apply here? :)

やるべきこと:

  • アプライされないツールバーのボタンの除去(フォーマット、構文ヘルプ?)
  • より役立つツールバーを追加
    • インデントの挿入と取り消し
    • 一般的なキーワードやコードビットの挿入補助機能
    • help reference to MW JS API reference, JS & CSS specs/documentation

既知の問題点

  • accessibility: tab/shift-tab are overridden. is there a consistent alternative for keyboard-reliant users?
  • accessibility: accesskey on the original textarea needs to be moved over or otherwise handled
  • scrollbar initializes too wide; need to trigger resize check after that's filled (maybe fixed?)
  • cursor/scroll position not maintained over previews/show changes

ライセンス