Extensión:CodeMirror
CodeMirror Estado de lanzamiento: estable |
|
---|---|
Implementación | Interfaz de usuario |
Descripción | Proporciona resaltado de sintaxis en el editor de wikitexto |
Autor(es) | Pavel Astakhov (pastakhovdiscusión) |
Última versión | 6.0.0 |
Política de compatibilidad | Lanzamientos de screenshots junto con MediaWiki. Master no es compatible con versiones anteriores. |
MediaWiki | 1.32+ |
PHP | 5.3+ |
Cambios de la base de datos | No |
Licencia | GNU Licencia Pública general 2.0 o posterior |
Descarga | |
|
|
Descargas trimestrales | 287 (Ranked 14th) |
Wikis públicos que lo utilizan | 6,549 (Ranked 62nd) |
Traduce la extensión CodeMirror si está disponible en translatewiki.net | |
Función de vagabundo | codemirror |
Asuntos | Tareas abiertas · Reportar un bug |
La extensión de CodeMirror proporciona resaltado de sintaxis en el editor de wikitexto de MediaWiki. Añade un botón con el icono a la barra de herramientas de edición que permite activar y desactivar el resaltado de sintaxis. Es compatible con la barra de herramientas de WikiEditor 2010, así como con la barra de herramientas de VisualEditor.
Por defecto está apagado. Cuando está encendido, reemplazará el área de texto estándar con el editor proporcionado por la librería CodeMirror. Cuando se apague, volverá al área de texto estándar.
Los colores utilizados en esta extensión se han optimizado para un mayor contraste, accesibilidad y mejor legibilidad y ahora cumplen con las Pautas de accesibilidad al contenido web (WCAG 1.4.3 AA). Los colores brindan un mejor acceso a las personas con visión limitada, así como a los usuarios que trabajan en condiciones de luz diurna brillante. (más información)
Características
Coincidencia de corchetes
Esta función resalta el par de corchetes más interno cuando el cursor se encuentra entre cualquier par de corchetes, y cuando el cursor se encuentra directamente al lado de un corchete, la función resalta el corchete correspondiente. La coincidencia de corchetes está activa en ambos editores cuando el resaltado de sintaxis está activado en cualquier espacio de nombres que use estos editores.
-
Coincidencia de corchetes
Numeración de línea
En el modo de edición de wikitexto, los números de línea se muestran automáticamente en ambos editores.
-
Numeración de líneas en el editor de wikitexto de 2010
-
Numeración de líneas en el editor de wikitexto de 2017
Modo daltónico
Para los usuarios que tienen dificultades para distinguir entre colores, CodeMirror ofrece un modo para daltónicos. Esta característica se puede activar en wikis con CodeMirror habilitado navegando a la página de Special:Preferences.
Con el esquema para daltónicos activo, los colores de los siguientes elementos de la página cambian:
Encabezados, símbolos, firmas, nombres de secciones, palabras mágicas | #E4A400 |
Plantillas | #9C3A00 |
Etiquetas HTML, referencias, expresiones matemáticas | #56B4E9 |
Variables | #009E73 |
Además, los resaltados y colores de fondo se eliminan de todo el texto y los objetos. El comportamiento de negrita y subrayado no se ve afectado.
Compatibilidad con navegadores
Todos los navegadores compatibles con MediaWiki son compatibles.
Instalación
- Instale la extensión de WikiEditor o la extensión de VisualEditor , como se indica en sus páginas; se requiere al menos uno de estos para que esta extensión funcione.
- Descarga y extrae los archivos en un directorio denominado «
CodeMirror
» dentro de la carpetaextensions/
.
Developers and code contributors should install the extension from Git instead, using:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CodeMirror - Añade el siguiente código en la parte final de tu archivo LocalSettings.php :
wfLoadExtension( 'CodeMirror' );
- Configure según sea necesario.
- Hecho – Navega a Special:Version en el wiki para verificar que la extensión se haya instalado correctamente.
Instalación Vagrant:
- Si se utiliza Vagrant , instala con
vagrant roles enable codemirror --provision
Parámetros de configuración
Para personalizar el color y el estilo, consulte la página de metaayuda. Puede usar sus propios estilos para resaltar wikitexto. Estilos usados disponibles aquí. Debes colocar tus propios estilos en common.css .
Agrega el código de arriba al final de tu LocalSettings.php .
# Habilita el uso de CodeMirror de forma predeterminada, pero aún permite que los usuarios lo deshabiliten
$wgDefaultUserOptions['usecodemirror'] = 1;
Para habilitar funciones adicionales:
# Restrinja la numeración de líneas a espacios de nombres específicos.
# El valor predeterminado es null, lo que lo habilita para todos los espacios de nombres.
# Establézcalo en [] para deshabilitar en todas partes.
$wgCodeMirrorLineNumberingNamespaces = [ NS_TEMPLATE ];
Integración de la extensión
Si su extensión MediaWiki agrega una nueva etiqueta y desea asegurarse de que CodeMirror resalte correctamente el contenido dentro de ella, puede agregar compatibilidad con CodeMirror a su extensión. He aquí dos ejemplos: extension Cite y extensión PhpTags.
Integración JavaScript
Los siguientes ganchos frontales son usados en esta extensión:
Gancho | Parámetros | |
---|---|---|
Tipo | Descripción | |
ext.CodeMirror.switch
|
boolean | Si ahora se muestra el editor de CodeMirror |
objeto jQuery | El "editor" actual, que es el elemento normal <textarea /> o .CodeMirror .
|
If you need to interact with the contents of a CodeMirror instance, use jQuery.plugin.textSelection.
Pendientes
- Unfortunately, right-to-left content is not supported. (task T170001)
- highlighting definition lists ( ;foo :bar ) (task T170042)
- compleción automática (task T95100)
- code folding (task T166098)
- highlighting inside gallery tag (<gallery> foo | bar </gallery>)
Véase también
- Overview of missing features and bugs: MediaWiki-extensions-CodeMirror
- User:Remember the dot/Syntax highlighter
- Extension:VisualEditor
- Extensión:WikiEditor
- Extensión:CodeEditor
- Community Tech/Wikitext editor syntax highlighting - includes information on customizing the colors
- c:Category:MediaWiki extension CodeMirror
Esta extensión está siendo usada en uno o más proyectos de Wikimedia. Esto significa probablemente que la extensión es estable y funciona lo suficientemente bien como para ser usada en sitios con gran cantidad de visitas. Puedes buscar el nombre de esta extensión en los archivos CommonSettings.php e InitialiseSettings.php de Wikimedia para ver dónde se instala. Encontrarás la lista completa de extensiones instaladas en un wiki en particular en la página Special:Version del wiki. |
Esta extensión está incluida en los siguientes anfitriones/granjas wiki y/o paquetes: No se trata de una lista oficial. Algunas granjas/hosts wiki y/o paquetes pueden tener disponible esta extensión aunque no estén listados aquí. Siempre compruébelo con su anfitrión o granja wiki para confirmarlo. |