扩展:CodeMirror
Jump to navigation
Jump to search
CodeMirror 发布状态: 稳定版 |
|
---|---|
![]() |
|
实现 | 用户界面 |
描述 | 为wiki文本编辑器提供语法高亮 |
作者 | Pavel Astakhov (pastakhov讨论) |
最新版本 | 4.0.0 |
兼容性方针 | Snapshots releases along with MediaWiki. Master is not backwards compatible. |
MediaWiki | 1.32+ |
PHP | 5.3+ |
数据庫更改 | 否 |
许可协议 | GNU通用公眾授權條款2.0或更新版本 |
下载 | |
|
|
翻譯CodeMirror擴充功能如在translatewiki.net可用 | |
Vagrant角色 | codemirror |
问题 | 尚未完成的工作 · 回報錯誤 |
CodeMirror扩展为MediaWiki中的wiki文本(源代码)编辑器提供语法高亮功能。
它会在编辑工具栏中添加一个图标为的按钮,点击可以切换开启和关闭语法高亮。
支持2010年WikiEditor工具栏以及可视化编辑器工具栏。
语法高亮功能默认关闭。 开启功能后,它将使用CodeMirror库提供的编辑器替换标准的多行文本框。 功能关闭后,不产生效果。
您可以使用自定义的wikitext语法高亮样式。 所用的样式在这里。 您的自定义样式应放入common.css。 如果你发现了更好的样式,来告诉我。
浏览器支持
目前尚未完全测试!
支持所有受MediaWiki支持的浏览器。 现代的移动端浏览器是部分能用。
截图
安装
- 如果使用Vagrant ,请通过
vagrant roles enable codemirror --provision
安装
- 手动安装
- 根据对应说明页面安装WikiEditor扩展 或VisualEditor扩展 ;本扩展需要以上两者中的至少一个。
- 下载文件,并将其放置在您
extensions/
文件夹中的CodeMirror
目录内。 - 将下列代码放置在您的LocalSettings.php的底部:
wfLoadExtension( 'CodeMirror' );
- 按需求配置。
完成 – 在您的wiki上导航至Special:Version,以验证扩展已成功安装。
配置
# Enables use of CodeMirror by default but still allow users to disable it
$wgDefaultUserOptions['usecodemirror'] = 1;
添加上述代码到你的LocalSettings.php 的结尾。
颜色和样式的自定义见元维基帮助页面。
扩展集成
如果你的MediaWiki扩展添加了新的标签并且想确保CodeMirror正确高亮其中的内容,可以为你的扩展添加CodeMirror支持。两则例子:Cite扩展和PhpTags扩展。
有待完成
- 高亮定义列表( ;foo :bar ) (phab:T170042)
- 自动完成(phab:T95100)
- 大括号匹配(phab:T15302)
- 代码折叠 T166098
- 高亮gallery标签中的内容(<gallery> foo | bar </gallery>)
参见
- User:Remember the dot/Syntax highlighter
- Extension:VisualEditor
- 扩展:Wiki编辑器
- 扩展:代码编辑器
- Community Tech/Wikitext editor syntax highlighting (includes information on customizing the colors)
- c:Category:MediaWiki extension CodeMirror
![]() | 此扩展被用于一个或多个维基媒体项目上。 这可能意味着扩展稳定且工作良好,足以用在同等高流量的网站上。 请在维基媒体的CommonSettings.php和InitialiseSettings.php配置文件中寻找此扩展名称以查看安装它的网站。 详细的已安装扩展的完整列表可在wiki的Special:Version页面找到。 |