Extensión:CharInsert

This page is a translated version of the page Extension:CharInsert and the translation is 81% complete.
Extensión matemática MediaWiki
OOjs UI icon advanced-invert.svg
CharInsert
Estado de lanzamiento estable
Implementación Etiqueta , Acción de página , MyWiki
Descripción Permite crear cuadros de inserción de caracteres con JavaScript.
Autor(es) Brion Vibber (Brion VIBBERdiscusión)
Última versión continuous updates
Política de compatibilidad Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki 1.25+
PHP 5.4+
Licencia GNU Licencia Pública general 2.0 o más tarde
Descarga
‎<charinsert>
Traduce el CharInsert extensión si es disponible en translatewiki.net

Verificar uso y versión de la matriz.

Asuntos Tareas abiertas · Reportar un bug

La extensión CharInsert permite crear enlaces JavaScript que cuando son presionados insertan texto predefinido en la caja de texto.

Estos enlaces son usualmente usados en el mensaje del sistema MediaWiki:Edittools (ejemplo en este wiki).

Sintaxis

Usa las etiquetas ‎<charinsert> con una lista separada por espacios de caracteres o etiquetas que se desea poder insertar.

Puedes usar el signo + dentro de una etiqueta para definir un lugar para:

  • insertar el texto seleccionado o
  • posicionar el cursor si ningún texto fue seleccionado.

Tienes que encerrar plantillas y espacios dentro de ‎<nowiki>:

<charinsert><nowiki>== + ==</nowiki> <nowiki>{{stub}}</nowiki></charinsert>

Uso y ejemplo de resultado

Caracteres individuales

Los caracteres individuales solo figuran entre etiquetas "charinsert".

<charinsert>Á á Ć ć É é Í í Ĺ ĺ Ń ń Ó ó Ŕ ŕ Ś ś Ú ú Ý ý Ź ź</charinsert>

resulta en

Á á Ć ć É é Í í Ĺ ĺ Ń ń Ó ó Ŕ ŕ Ś ś Ú ú Ý ý Ź ź

Hacer clic en el enlace no tendrá efecto pues no hay entrada o campo de edición.

Caracteres combinados

Los caracteres combinados figuran entre las etiquetas "charinsert" y son conectados por el signo "+".

<charinsert>“+” ‘+’ «+» ‹+› „+“ ‚+‘ [[+]] {{+}}</charinsert>

resulta en

“” ‘’ «» ‹› „“ ‚‘ [[]] {{}}

Hacer clic en el enlace no tendrá efecto pues no hay entrada o campo de edición.

Notas

  • Los enlaces JavaScript generados también funcionan en otras áreas alrededor de la ventana de edición, p. ej. en MediaWiki:Copyrightwarning o MediaWiki:Newarticletext, en la página precargada con Inputbox e incluso en la previsualización.
  • También pueden ser usados en MediaWiki:Uploadtext para insertar plantillas de descripción de imágenes.
  • A diferencia de los botones de la barra de herramientas arriba, esta extensión no provee una forma de especificar un "texto de ejemplo" insertado.
  • Usa &#10; para añadir nuevas líneas (\n).
  • Encierra espacios en blanco en etiquetas ‎<nowiki>...‎</nowiki> cuando sea necesario.
  • Añade etiquetas ‎<charinsert>...‎</charinsert> en MediaWiki:Edittools.

Instalación

Debido al bug T88922, la barra de herramientas provista por CharInsert no funciona en la página especial "Upload" cuando se usa en MediaWiki 1.27. Usa la versión provista para MediaWiki 1.28+ pero tenga en cuenta de que algunos accesorios pueden no funcionar como se espera sin más actualizaciones.
  • Descarga y extrae los archivos en un directorio denominado «CharInsert» dentro de la carpeta extensions/.
  • Añade el código siguiente al final de LocalSettings.php :
    wfLoadExtension( 'CharInsert' );
    
  • Si usas el accesorio Edittools , actualiza su código a la versión más reciente (≥ Mayo 27, 2016)
  •   Hecho – Navega a Special:Version en el wiki para verificar que la extensión se haya instalado correctamente.

Para quienes usan MediaWiki 1.24 o versiones anteriores:

Estas instrucciones describen la nueva forma de instalar extensiones usando wfLoadExtension(). Si necesitas instalar esta extensión en versiones anteriores (MediaWiki 1.24 y anteriores), debes usar lo siguiente en lugar de wfLoadExtension( 'CharInsert' );:

require_once "$IP/extensions/CharInsert/CharInsert.php";

Configuración avanzada

Importante: Debes tener Extensión:Accesorios para que esto funcione.

Estilo

 

Para dar a las listas charinsert un estilo adicional, ajusta el contenido de sus Edittools entre <div class="mw-charinsert-buttons"> y ‎</div> y agrégales un estilo a tu MediaWiki:Common.css. Este sitio (www.mediawiki.org) hace que los enlaces aparezcan como botones (como se muestra en la captura de pantalla al lado). La siguiente hoja de estilo se usó para eso, cópiala en su MediaWiki:Common.css para aplicar el mismo estilo.

 
/**
 * Styling for links generated by [[MediaWiki:Edittools]]
 * @source https://www.mediawiki.org/wiki/Extension:CharInsert#Styling
 * @updated 2020-03-17
 */
.mw-charinsert-buttons {
	border: 1px solid #aaa;
	margin-top: 10px;
	padding: 1px;
	font-size: 1.1em;
	text-align: center;
}

.mw-charinsert-buttons a {
	background-color: #cde !important;
	color: #000;
	border: thin #069 outset;
	padding: 0 1px 1px;
	font-weight: bold;
	font-size: 0.9em;
	text-decoration: none;
}

.mw-charinsert-buttons a:hover,
.mw-charinsert-buttons a:active {
	background-color: #bcd;
	border-style: inset;
}

.client-js .mw-edittools-section {
	display: inline;
}

.client-js .mw-edittools-section input[type="button"] {
	font-size: 0.9em;
	margin-left: 1px;
	padding-left: 1px;
	padding-right: 1px;
}

Alternativamente, puede elegir un estilo más cercano a la Guía de estilo de diseño de Wikimedia y el tema de WikimediaUI:

 
/**
 * Styling for links generated by [[MediaWiki:Edittools]] in WikimediaUI inspired theme.
 * @source https://www.mediawiki.org/wiki/Extension:CharInsert#Styling
 * @updated 2020-03-17
 */
.mw-charinsert-buttons {
	margin-top: 8px;
	border: 1px solid #c8ccd1;
	padding: 2px 4px 4px;
	font-size: 1.1em;
	text-align: center;
}

.mw-charinsert-buttons a {
	background-color: #f8f9fa !important;
	color: #202122;
	border: thin #36c outset;
	padding: 0 1px 2px;
	font-size: 0.9em;
	font-weight: bold;
	text-decoration: none;
}

.mw-charinsert-buttons a:hover {
	background-color: #fff;
    color: #404244;
}

.mw-charinsert-buttons a:active {
	background-color: #c8ccd1;
	border-style: inset;
}

.client-js .mw-edittools-section {
	display: inline;
}

.client-js .mw-edittools-section input[type="button"] {
	background-color: #f8f9fa;
	color: #202122;
	margin-left: 1px;
    border-radius: 2px;
	padding: 1px 6px;
	font-size: 0.9em;
    /* Apply pointer cursor to all interactive elements. */
    cursor: pointer;
}

.client-js .mw-edittools-section input[type="button"]:hover {
	background-color: #fff;
    color: #404244;
}

.client-js .mw-edittools-section input[type="button"]:active {
	background-color: #c8ccd1;
    color: #000;
}

Secuencias de comandos

Si tiene muchos enlaces CharInsert, se podría usar JavaScript para colocarlos en grupos separados y permitir el cambio dinámico con un menú desplegable. Por ejemplo para separar caracteres diacríticos del sintaxis wiki, etc. Muchos sitios (como mediawiki.org, de.wikipedia.org y en.wikipedia.org) han hecho esto. Sin embargo lo han implementado de diferentes maneras. A continuación se documenta la forma en que se hace en mediawiki.org:

1. Envuelve todas las etiquetas charinsert en MediaWiki:Edittools en un contenedor de ‎<div> y asígnale una identificación descriptiva y única (por ejemplo, "mw-edittools-charinsert").:

<div id="mw-edittools-charinsert" class="mw-charinsert-buttons" title="Click on the wanted special character.">
...
</div>
2. Envuelve cada bloque individual de charinserts en etiquetas de ‎<p> como esta:
<p class="mw-edittools-section" data-section-title="Wiki-Syntax" style="display: none;">
...
</p>
Note:
  • No cambies la palabra 'mw-edittools-section'
  • El texto detrás de "data-section-title=" identificará este grupo en el menú desplegable.
  • Asegúrate de que haya un grupo sin la directiva 'style="display: none;"': esa será la opción predeterminada en el menú desplegable. En este sitio, se llama 'Estándar' mientras que los otros grupos se nombran por el idioma para el cual los caracteres son significativos.
3. Copia el contenido de MediaWiki:Gadget-Edittools.js en una página con el mismo nombre en tu propio wiki
4. Añade el siguiente código a tu MediaWiki:Gadgets-definition:
* Edittools[ResourceLoader|default]|Edittools.js

English Wikipedia CharInsert menu

For implementing CharInsert menu like the one used on the English Wikipedia, either export gadgets: Charinsert-core, Charinsert-styles, and Charinsert and then import them on your own wiki through Special:Import or if you want to do it manually, copy the following four interface pages to your wiki:

* charinsert[ResourceLoader|default|peers=charinsert-styles]|charinsert.js
* charinsert-core[ResourceLoader|hidden|dependencies=jquery.textSelection,user,mediawiki.storage]|charinsert-core.js
* charinsert-styles[ResourceLoader|hidden|type=styles]|charinsert-styles.css
  • MediaWiki:Edittools (Wikipedia) - Only for users with JavaScript turned off or unsupported (which disables the WikiEditor extension too), therefore not really necessary or useful either. It only shows symbols/characters as simple text below the editor window, which can then be copy-pasted and thus be of some help to editors. Apparently, it does not get activated in English Wikipedia for disabled JavaScript.

Note: This particular English Wikipedia character set also contains templates, which will need to be defined separately, if they are to be used on your Wiki.

English Wikipedia Solution checked on: November 6, 2018