27b6aaebcc
For years, users have complained that the CodeMirror toggle button is confusing and concealed. The icon looked too similar to the edit icon, when it was supposed to be a highlighter. The new icon is similar but has a highlighted line to help clarify what it is. We also now have the text 'Syntax' accompanying the icon. Translators are instructed to try to be brief to conserve space in the toolbar. "Syntax highlighting" is the full correct term, and remains the text for the button's tooltip. The new icon is ~0.3KB uncompressed, just meeting performance guidelines for using @embed <https://w.wiki/AsPW>. This is also only temporary until the icon is upstreamed in Codex/OOUI. New icon courtesy of Thiemo Kreuz (WMDE) A corresponding change for the 2017 editor will follow I15453b33e7. Bug: T174145 Change-Id: Ib6dbfc261214ed6672c1a54738e3401fa2f5d262 |
||
---|---|---|
.phan | ||
i18n | ||
includes | ||
resources | ||
tests | ||
.eslintignore | ||
.eslintrc.json | ||
.gitignore | ||
.gitreview | ||
.nvmrc | ||
.phpcs.xml | ||
.stylelintrc.json | ||
CODE_OF_CONDUCT.md | ||
composer.json | ||
COPYING | ||
extension.json | ||
jest.config.js | ||
jsdoc.json | ||
package-lock.json | ||
package.json | ||
README.md | ||
rollup.config.js |
The CodeMirror extension provides syntax highlighting in MediaWiki wikitext editors using the CodeMirror library.
CodeMirror 6 homepage: https://www.mediawiki.org/wiki/Extension:CodeMirror/6
JS documentation: https://doc.wikimedia.org/CodeMirror
Development
Preface
Extension:CodeMirror is currently in the process of being upgraded to the new major version, CodeMirror 6. See the change log for details.
Use of CodeMirror 6 is controlled by the wgCodeMirrorV6
configuration setting, or by
passing in cm6enable=1
in the URL query string.
CodeMirror 6 requires the use of NPM to bundle the dependencies. These are bundled in
resources/codemirror.bundle.js, built using Rollup,
and packaged as the ext.CodeMirror.v6.lib
ResourceLoader module. If you make changes to the
versions of the dependencies, you will need to run npm run build
to update the ResourceLoader module.
NPM commands
NOTE: Consider using Fresh to run these tasks.
npm install
to install dependencies.npm run doc
to generate the API documentation.npm test
to run the linting tools, JavaScript unit tests, and build checks.npm run test:lint
for linting of JS/LESS/CSS.npm run test:lint:js
for linting of just JavaScript.npm run test:lint:styles
for linting of just Less/CSS.npm run test:i18n
for linting of i18n messages with banana-checker.npm run test:unit
for the new Jest unit tests.npm run selenium-test
for the Selenium tests.npm run build
to rebundle the CodeMirror library. If changes are made to the@codemirror
or@lezer
dependencies in package.json, this command must be run before sending the patch or CI will fail.- Older QUnit tests are in
resources/mode/mediawiki/tests/qunit/
. These have been replaced and will be removed after the CodeMirror 6 upgrade is complete.