Extension:CharInsert/es

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



Uso y ejemplo de resultado


Caracteres individuales
Los caracteres individuales solo figuran entre etiquetas "charinsert".

resulta en



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

resulta en

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

results in

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 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  cuando sea necesario.
 * Añade etiquetas  en MediaWiki:Edittools.

Instalación


Configuración avanzada
Importante: Debes tener para que esto funcione.

Estilo


Para dar a las listas charinsert un estilo adicional, ajusta el contenido de sus Edittools entre  y  y agrégales un estilo a tu. 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 para aplicar el mismo estilo.

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

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 y asígnale una identificación descriptiva y única (por ejemplo, "mw-edittools-charinsert").:
 * 2. Envuelve cada bloque individual de charinserts en etiquetas de como esta:


 * 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 ' ': 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 :


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

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

 English Wikipedia Solution checked on: November 6, 2018