Extensión:CharInsert

Manual de extensiones de MediaWiki

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 (Brooke Vibberdiscusión)
Última versión	continuous updates
Política de compatibilidad	Lanzamientos de screenshots junto con MediaWiki. Master no es compatible con versiones anteriores.
Licencia	GNU Licencia Pública general 2.0 o posterior
Descarga	Descargar la extensión. Git [?]: Descargar desde master de Git Explorar el repositorio (Phabricator · GitHub) historial de cambios Colaboradores de repositorio (GitHub) revisión de código
Etiquetas ‎<charinsert>
Hooks que usa BeforePageDisplay ParserFirstCallInit
Descargas trimestrales	76 (Ranked 65th)
Wikis públicos que lo utilizan	9,224 (Ranked 15th)
Traduce la extensión CharInsert si está disponible en translatewiki.net
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.

Overriding display text

Versión de MediaWiki:

≥ 1.38 Gerrit change 748823

A different display text can be specified in the label attribute (if you use this, you should use separate <charinsert> tags for each character in order to specify different display texts).

<charinsert label="Latin A">A</charinsert> <charinsert label="Cyrillic А">А</charinsert> <charinsert label="Greek Alpha">Α</charinsert>

results in

Latin A Cyrillic А Greek Alpha

Clicking the links will have no effect since there is no input or edit field.

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 
 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

• Descarga y extrae los archivos en un directorio denominado «CharInsert» dentro de la carpeta extensions/.
  Developers and code contributors should install the extension from Git instead, using:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CharInsert
• Añade el siguiente código en la parte final de tu archivo 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.

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>

 Nota:

• 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:

• MediaWiki:Gadget-charinsert-core.js (Wikipedia) - Main JavaScript file.
• MediaWiki:Gadget-charinsert-styles.css (Wikipedia) - Creates surrounding boxes around the symbols/characters giving them the look of buttons.
• MediaWiki:Gadget-charinsert.js (Wikipedia) - CharInsert loader.
• MediaWiki:Gadget-charinsert (Wikipedia) - For the text shown in user preferences' gadgets section.

• In your MediaWiki:Gadgets-definition, add the following definitions:

  * 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.

 Nota: 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