此页面已过时。其仅作为历史记录保留。 它可能记载废弃的和/或不再支持的扩展或功能。 不要认为这里的信息是最新的。

请勿与CodeEditor 混淆。

CodeMirror/5 Category:Stable extensions/zh
	Category:User interface extensions/zh
描述	为 wikitext 编辑器提供语法高亮
作者	Pavel Astakhov (pastakhov留言)
最新版本	5.0.0
	快照跟随MediaWiki发布。
	否
	GNU通用公眾授權條款2.0或更新版本
下載	下載 Git [?]: 浏览存储库 (GitHub) Gerrit代码 Git提交日誌 下載原始碼(tarball壓縮) Category:Extensions in Wikimedia version control/zh
$wgCodeMirrorContentModels $wgCodeMirrorV6 $wgCodeMirrorConflictingGadgets $wgCodeMirrorTitleCompletion $wgCodeMirrorDefaultPreferences $wgCodeMirrorLineNumberingNamespaces
EditPage::showEditForm:initial Category:EditPage::showEditForm:initial extensions/zh EditPage::showReadOnlyForm:initial Category:EditPage::showReadOnlyForm:initial extensions/zh GetBetaFeaturePreferences Category:GetBetaFeaturePreferences extensions/zh GetPreferences Category:GetPreferences extensions/zh UploadForm:initial Category:UploadForm:initial extensions/zh
季度下載量	205 (Ranked 11th)
正在使用的公开wiki数	6,549 (Ranked 62nd)
前往translatewiki.net翻譯CodeMirror/5
Vagrant角色	codemirror
問題	开启的任务 ·

CodeMirror扩展为MediaWiki中的wiki文本（源代码）编辑器提供语法高亮功能。 它会在编辑工具栏中添加一个图标为的按钮，点击可以切换开启和关闭语法高亮。 支持2010年WikiEditor工具栏以及可视化编辑器工具栏。

语法高亮功能默认关闭。 开启功能后，它将使用CodeMirror库提供的编辑器替换标准的多行文本框。 功能关闭后，不产生效果。

此扩展中使用的颜色已经过优化，具有更高的对比度、可访问性和更好的可读性，现在符合 Web 内容无障碍指南（WCAG 1.4.3 AA）。 这些颜色为视力受限的人以及在明亮日光条件下工作的用户提供了更好的访问。 （更多信息）

功能

色盲模式

对于难以区分颜色的用户，CodeMirror 提供了色盲友好模式。 此功能可以在启用了 CodeMirror 的 wiki 上通过导航到 Special:Preferences 页面来激活。

激活色盲友好方案后，以下页面元素的颜色会发生变化：

标题、符号、签名、章节名称、魔术字	#E4A400
模板	#9C3A00
HTML 标签、引用、数学表达式	#56B4E9
变量	#009E73

此外，还会从所有文本和对象中删除背景高亮和颜色。 加粗和下划线行为不受影响。

浏览器支持

支持所有受MediaWiki支持的浏览器。

安裝

• 安装WikiEditor 扩展或VisualEditor 扩展；本扩展需要以上两者中的至少一个。
• 下载，并将解压后的CodeMirror移动到extensions/目录中。
  开发者和代码贡献人员应从Git安装扩展，输入：cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CodeMirror
• 将下列放置在您的LocalSettings.php 的底部：

  wfLoadExtension( 'CodeMirror' );
  

• 完成 – 在您的wiki上至Special:Version，以验证已成功安装。

• 如果使用Vagrant ，请vagrant roles enable codemirror --provision安装

配置

颜色和样式的自定义见元维基帮助页面。 您可以使用自定义的wikitext语法高亮样式。 所用的样式在这里。 您的自定义样式应放入common.css 。

添加上述代码到你的LocalSettings.php 的结尾。

# 默认情况下允许使用 CodeMirror，但仍允许用户禁用它
$wgDefaultUserOptions['usecodemirror'] = true;

要启用额外功能：

$wgCodeMirrorLineNumberingNamespaces

将行编号限制为特定命名空间。 默认为 null，即在所有命名空间启用。 设为 [] 在所有页面禁用。

$wgCodeMirrorV6

Temporary feature flag to control the migration to CodeMirror 6 (phab:T259059).

$wgCodeMirrorConflictingGadgets

工具名称数组，如果启用，将阻止CodeMirror加载。 默认为wikEd

扩展集成

如果你的MediaWiki扩展添加了新的标签并且想确保CodeMirror正确高亮其中的内容，可以为你的扩展添加CodeMirror支持。两则例子：Cite扩展和PhpTags扩展。

JavaScript 集成

此扩展中使用了以下的[wmdoc:mediawiki-core/master/js/Hooks.html|前端钩子]：

如果需要与CodeMirror实例的内容交互，请使用 jQuery.plugin.textSelection。

待办事项

• 遗憾的是，不支持从右到左的内容。（TT170001）
• 自动补全（TT95100）
• 代码折叠 (TT166098)
• 高亮画廊标签中的内容 (<gallery> foo | bar </gallery>)

参见

• 缺失的功能和错误概述：MediaWiki-extensions-CodeMirror
• User:Remember the dot/Syntax highlighter
• Extension:VisualEditor
• :WikiEditor
• :代码编辑器
• 群技术/Wikitext 编辑器语法高亮 - 包括有关自定义颜色的信息
• c:Category:MediaWiki extension CodeMirror

此用于一个或多个维基媒体项目。 这可能意味着足够稳定、运作足够良好，可以用在这样的高流量的网站上。 请在维基媒体的CommonSettings.php和InitialiseSettings.php中查找此的名称以查看哪些网站安装了该。 特定wiki上的已安装的的完整列表位于Special:Version页面。

此在以下wiki农场/托管网站和/或软件包中提供： Canasta Category:Extensions included in Canasta/zh Fandom Category:Extensions included in Fandom/zh Miraheze Category:Extensions included in Miraheze/zh MyWikisCategory:Extensions included in MyWikis/zh ProWikiCategory:Extensions included in ProWiki/zh TelepediaCategory:Extensions included in Telepedia/zh wiki.gg Category:Extensions included in wiki.gg/zh WikiForgeCategory:Extensions included in WikiForge/zh 這不是一份權威名單。 即使某些wiki农场/托管网站和/或软件包未在这里列出，它们也可能提供此。 请检查你的wiki农场/托管网站或软件包以确认提供情况。