Usuario:Axxgreazz/Monobook-Suite/Configuración

En esta sección describiremos como puedes fácilmente adaptar tu Monobook-Suite a tus necesidades.

Antes de empezar

Recuerda que sólo puedes configurar las versiones personalizables del monobook. Si cuentas con una versión no personalizable y ahora quieres personalizarla lo mejor es que realices los siguientes pasos:

Accede al Panel de control, a la sección «Paso 1: Cambia la versión de tu monobook».
Haz clic en cualquiera de las versiones personalizables del monobook (js o css).
Accede a tu monobook.js o tu monobook.css.
Dependiendo de lo que quieras personalizar sigue los pasos indicados a continuación.

Entendiendo el monobook.js

Las secciones

Revisa el monobook.js que abriste en el paso 3 anterior, y podrás comprobar que este cuenta con cuatro secciones:

Sección 1: En esta sección se ejecutan las funciones de inicialización, por lo que no es recomendable modificar esta sección.
Sección 2: Aquí es donde se cargan los objetos personalizables del monobook. Por ejemplo los botones de la barra de herramientas, los buscadores, los enlaces wiki. Aquí es donde podrás personalizar los objetos a mostrar en tu propio monobook.
Sección 3: Se cargan los módulos del monobook.js. Es en esta sección donde puede activar y desactivar los módulos con los que deseas (o no) contar.
Sección 4: Aquí se encuentra la base para que todo lo demás funcione correctamente. No modifiques esta sección.

La función «incluir»

Como podrás ver en casi todo el monobook se utiliza la función incluir con el siguiente formato:

incluir ("dominio del modulo","nombre de usuario","Ubicación y nombre de la página js");

dominio del módulo: dirección web del servidor donde se ubica la página js a utilizar.
nombre de usuario: se indica el nombre del usuario bajo el cual se aloja la subpágina js .
Ubicación y nombre de la página js: nombre de la página js.

Por defecto, los dos primeros campos vienen vacíos. Cuando estos campos están vacíos se utilizan los valores por defecto: el dominio es.wiki.x.io y el nombre de usuario Axxgreazz/Monobook-Suite. Esto significa que las páginas js que conforman los módulos y la configuración del monobook.js se encuentran en la wiki en español y en el espacio de nombres del usuario Axxgreazz/Monobook-Suite. Sin embargo si quieres usar una página js en otro proyecto wiki y perteneciente a otro usuario, lo único que tendrás que hacer es cambiar los valores: dominio y/o usuario.

¿Qué quieres personalizar?

Pues bien, antes que inicies todo el proceso de configurar/personalizar tu monobook, es indispensable que realices lo siguiente:

1. Accede a tu tu monobook.js, sección 2: «Personalización de Modulos» y modifica la siguiente línea:

incluir ("","","misparametros-full.js");

reemplazándola por esta, donde incluyas tu nombre de usuario:

incluir ("","TuNombredeUsuario","misparametros.js");

Nota: La página misparametros contiene los parámetros de configuración para activar o desactivar módulos y configurar algunos módulo del monobook. Al cambiar esta línea lo que estás haciendo es relacionar tu monobook con tu página propia de configuración del monobook, y que crearás en el siguiente paso.

2. Luego de hacer lo indicado en el paso anterior, accede al Panel de control y en la sección: «Paso 2: Crea la página que deseas personalizar» haz clic en alguna de las páginas misparametros disponibles (lite, suite o full). Al hacer esto estarás creando/reemplazando tu página misparametros.js por la última versión de la página de parámetros del monobook-suite.

Recuerda que realizar estos dos pasos previos son indispensables para personalizar el monobook-suite.

Desactivar temporalmente un módulo del monobook.js

Accede al Panel de control, sección: «Paso 3: Modifica los parámetros generales de configuración», subsección: «Selecciona los módulos del Monobook-Suite que deseas utilizar» y retira los checks de los módulos del monobook que no deseas utilizar. Luego presiona el botón «Guardar configuación». La página se actualizará automáticamente reflejándose los cambios realizados.

Activar un módulo del monobook.js

Accede al Panel de control, sección: «Paso 3: Modifica los parámetros generales de configuración», subsección: «Selecciona los módulos del Monobook-Suite que deseas utilizar» y marca los módulos del monobook que deseas utilizar. Luego presiona el botón «Guardar configuación». La página se actualizará automáticamente reflejándose los cambios realizados.

Personalizar botones de la barra de herramientas

Pasos previos

Pues bien, antes que personalizar los botones de la barra de herramientas, es indispensable que realices lo siguiente:

1. Accede a tu monobook.js, sección 2: «Personalización de Modulos» y modifica la siguiente línea:

incluir ("","","misbotones-full.js");

reemplazándola por esta, donde incluyas tu nombre de usuario:

incluir ("","TuNombredeUsuario","misbotones.js");

2. Luego de hacer lo indicado en el paso anterior, accede al Panel de control y en la sección: «Paso 2: Crea la página que deseas personalizar» haz clic en alguna de las páginas misbotones disponibles (lite, suite o full). Al hacer esto estarás creando/reemplazando tu página misbotones.js por la última versión de la página de botones del monobook-suite.

Retira un botón

Ahora que cuentas con tu propia página de botones misbotones.js puedes desactivar temporalmente un botón. Para hacerlo accede a esa página y cambia el valor «true» por «false» en la fila del botón que deseas desactivar. +

Agrega un nuevo botón

Agregar un botón si requiere un mínimo de conocimientos de programación javascript por lo que recomiendo que si tienes una idea para un nuevo botón, comentalo en la página Usuario Discusión:Axxgreazz/Monobook-Suite para que pueda evaluar su factibilidad de implementación.

Si tú mismo quieres crear el botón, debes dirigirte a tu página: misbotones.js y allí debes agregar una nueva línea con el siguiente formato:

otroboton ("nombre descriptivo", "tooltip", "url de la imagen del botón", "", true);

Puedes ubicar el nuevo botón donde mejor te parezca. Además, cada campo significa:

nombre descriptivo: nombre que identifique al botón de manera única en la página «misbotones.js»
tooltip, es el texto descriptivo que aparece cuando el ratón se ubica encima del botón.
url de la imagen, dirección web de la imagen a mostrar en el botón. Ejemplo: http://up.wiki.x.io/wikipedia/commons/8/8e/Button_stub.png. En commons:Category:ButtonToolbar puedes encontrar varias imágenes para botones. Si no encuentras la imagen que necesitas, súbela a Commons y categorízala en la misma categoría.
true, este valor hará que el botón se muestre. Si no quieres que se muestre, cambia este valor por false.

Crea una nueva función para tu botón

Sigue los pasos indicados a continuación:

1. Accede a tu tu monobook.js, sección 2: «Personalización de Modulos» y modifica la siguiente línea:

incluir ("","","misfunciones.js");

reemplazándola por esta, donde incluyas tu nombre de usuario:

incluir ("","TuNombredeUsuario","misfunciones.js");

2. Luego de hacer lo indicado en el paso anterior, accede al Panel de control y en la sección: «Paso 2: Crea la página que deseas personalizar» haz clic en Crear página propia de misfunciones.js.

3. Ahora, accede a tu página misfunciones.js e incluye el código javascript de la función que ejecutará tu botón. El formato es el siguiente:

function nombredefunción
{
   ...
   código javascript 
   ...
}

Nota: El nombre de la función debe coincidir con el «nombre descriptivo» que colocaste al botón recién creado.

A continuación muestro un ejemplo simplificado de una función para insertar texto en modo edición:

function nombredefunción ()
{  
   insertTags("","","texto que quieres insertar");
}

Incluir un nuevo módulo

Digamos que en esta wiki o en otra encuentras un script con el que quieres contar y que NO forma parte del monobook-suite. Para incluir este módulo accede a la sección 3 de tu monobook.js y usa el siguiente formato:

incluir ("dominio del modulo","nombre de usuario","Ubicación y nombre del archivo js");

Aunque parece complicado, no lo es. Digamos que encuentras el script en la wiki inglesa. Si quieres probarlo junto a tu monobook-suite tendrías que agregar en la sección 3 lo siguiente:

incluir ("en.wiki.x.io","Ais523","catwatch.js");

Si en cambio el módulo se encuentra en tu wiki local, no es necesario especificar el primer parámetro pudiendo quedar de la siguiente manera:

incluir ("","Ais523","catwatch.js");

Códigos de proyectos wiki

Código	Nombre de proyecto	Dirección web
1	Wikipedia en español	es.wiki.x.io
2	Wikimedia Commons	commons.wikimedia.org
3	Wikipedia en inglés	en.wiki.x.io
4	Wiktionary en español	es.wiktionary.org
5	Wikisource en español	es.wikisource.org
6	Wikiquote en español	es.wikiquote.org
7	Wikibooks en español	es.wikibooks.org
8	Wikinews en español	es.wikinews.org
9	Meta Wikimedia	meta.wikimedia.org
10	MediaWiki	www.mediawiki.org
11	Wikiversity en español	es.wikiversity.org
12	Wikipedia en portugués	pt.wiki.x.io
13	Wikipedia en catalán	ca.wiki.x.io
14	WikiSpecies	species.wikimedia.org
15	Wikipedia en rumano	ro.wiki.x.io
16	Wikipedia en alemán	de.wiki.x.io
17	Wiktionary en portugués	pt.wiktionary.org
18	Wikipedia en francés	fr.wiki.x.io

Véase también

Lecturas obligatorias

Mantente informado

Otros temas relacionados
- Otras Botoneras
- Repositorio de botones en Commons