Extensión: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 | 4.0.0 |
| Política de compatibilidad | Lanzamientos de screenshots junto con MediaWiki. Master is not backward compatible. |
| MediaWiki | 1.32+ |
| PHP | 5.3+ |
| Cambios de la base de datos | No |
| Licencia | GNU Licencia Pública general 2.0 o posterior |
| Descarga | |
|
|
| Quarterly downloads | 355 (Ranked 31st) |
| Public wikis using | 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.
Todos los navegadores compatibles con MediaWiki son compatibles.
Instalación
- Instale la extensión de Extensión: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/. - Añade el siguiente código en la parte final de tu
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
|
booleano | 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
- Desafortunadamente, el contenido de derecha a izquierda no es compatible. (task T170001)
- Resaltando listas de definición ( ;foo :bar ) (task T170042)
- compleción automática (task T95100)
- plegado de código (task T166098)
- resaltando dentro de la etiqueta de la galería (<gallery> foo | bar </gallery>)
Véase también
- Descripción general de características y errores que faltan: MediaWiki-extensions-CodeMirror
- Usuario:Remember the dot/Syntax highlighter
- Extension:VisualEditor
- Extensión:WikiEditor
- Extensión:CodeEditor
- Tecnología comunitaria/Resaltado de sintaxis del editor de wikitexto - incluye información sobre la personalización de los colores
- 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 paquetes y/o granjas wiki: This is not an authoritative list. Some wiki farms/hosts may contain this extension even if they are not listed here. Always check with your wiki farms/hosts or bundle to confirm. |