Ver el código de «Usuario:Botellín/documentación»

{{Usuario:Botellín/nav}}

[[Usuario:Botellín|Botellín]] fue en principio un clon de [[Usuario:Botones|Botones]], que a su vez está basado en [[Usuario:Orgullobot|Orgullobot]]. Ahora Botellín ha incorporado algunas mejoras y ha corregido errores. En algunas funciones deja mensajes, si encuentra problemas, en [[Usuario:Botellín/traza]]


Si no eres [[Wikipedia:Bibliotecarios|bibliotecario]], puedes  pedirle a cualquiera de [http://es.wikipedia.org/eswiki/w/index.php?title=Especial:Listusers&group=sysop&limit=500&offset=0 los muchos que hay] que veas en [[Special:Recentchanges|cambios recientes]] que edite [[User:Botellín/comandos|comandos]] con tu petición. 

'''Notas:'''
*[[User:Botellín/comandos|Comandos]] siempre debe estar protegida. No queremos que cualquier wikipedista pueda mandar al bot, esto sería peligroso. 
*Debes estar seguro de lo que haces antes de editar [[User:Botellín/comandos|Comandos]]. 
*Indica los cambios deseados '''únicamente''' en el formato descrito aquí, para no confundir al bot. 
*[[User:Botellín/comandos|Comandos]] no ha de verse bonito, no importa. 
*Pon un comando por línea. 


== Comandos disponibles ==

=== Trasladar una categoría ===
Para trasladar (renombrar) una categoría a otra, usa la plantilla {{tl|trasladar cat|cat1|cat2}}. No incluyas el nombre de espacio aquí. Para trasladar [[:Categoría:Estadounidenses]] a [[:Categoría:Gringos]], por ejemplo, usarías {{tl|trasladar cat|Estadounidenses|Gringos}}:
{{trasladar cat|Estadounidenses|Gringos}}
===Retirar una categoría ===
Para retirar una categoría de los artículos donde figure usa {{tl|retirar cat|nombre de la categoría}}, sin incluir el nombre de espacio. Para borrar [[:Categoría:Gringos]], por ejemplo, usarías {{tl|retirar cat|Gringos}}:
{{retirar cat|Gringos}}

=== Para cambiar todos los enlaces a una página===
Para modificar todos los enlaces a una página para que apunten a otra página (porque la página ha sido trasladada, etc.), usa la plantilla {{tl|cambiar|Nombre de la página vieja|Nombre de la página nueva}}. Asegúrate de que NombreDeLaPagina sea el nombre entero de la página, incluyendo el nombre de espacio. Para que todos los enlaces a la [[Wikipedia:Zona de pruebas|zona de pruebas]] apuntaran al [[Wikipedia:Café]], por ejemplo, usarías {{tl|cambiar|Wikipedia:Zona de pruebas|Wikipedia:Café}}:
{{cambiar|Wikipedia:Zona de pruebas|Wikipedia:Café}}
Nótese que de este modo, no cambiará el texto de la página, sólo cambiará la página a donde apunta el enlace. En el ejemplo anterior, un enlace que era  '''''<nowiki>[[Wikipedia:Zona de Pruebas]]</nowiki>''''' se convirtiría en uno que dijera '''''<nowiki>[[Wikipedia:Café|Wikipedia:Zona de Pruebas]]</nowiki>''''' y uno que decía '''''<nowiki>[[Wikipedia:Zona de pruebas|ZDP]]</nowiki>''''' se convirtiría en '''''<nowiki>[[Wikipedia:Café|ZDP]]</nowiki>'''''. 

=== Para cambiar una plantilla por otra ===
Para modificar todos los enlaces a una plantilla (enlazada <nowiki>{{x}}</nowiki>) para que apunten a otra plantilla, usamos {{tl|cambiarplantilla}}. Si queremos trasladar {{tl|Ejemplo userbox}} a {{tl|Usuario:Userbox/Ejemplo userbox}}, por ejemplo, mandamos el comando de la siguiente forma:
 <nowiki>{{cambiarplantilla|Ejemplo userbox|Usuario:Userbox/Ejemplo userbox}}</nowiki>
{{cambiarplantilla|Ejemplo userbox|Usuario:Userbox/Ejemplo userbox}}

Otros ejemplos válidos:
 <nowiki>{{cambiarplantilla|Plantillavieja|Plantillanueva}}</nowiki>
 <nowiki>{{cambiarplantilla|Plantillavieja|Usuario:Userbox/Ejemplo userbox}}</nowiki>

Al hacer el cambio los parámetros de la plantilla vieja quedan intactos, por tanto esto sólo funcionará si las dos plantillas tienen los mismos parámetros. 


Por ejemplo: si en un artículo aparece <code><nowiki>{{vieja|uno|dos}}</nowiki></code> al hacer el cambio quedará como <code><nowiki>{{nueva|uno|dos}}</nowiki></code>.

Ejemplo erróneos

<nowiki>{{cambiarplantilla|vieja|nueva|parametronuevo}}</nowiki>

La orden anterior cambiará <code><nowiki>{{vieja}}</nowiki></code> por <code><nowiki>{{nueva}}</nowiki></code>, no por <code><nowiki>{{nueva|parametronuevo}}</nowiki></code>

Si lo que se desea es cambiar <code><nowiki>{{vieja}}</nowiki></code> por <code><nowiki>{{nueva|uno|dos}}</nowiki></code>, puede hacerse de la siguiente manera:

*Edita la plantilla <nowiki>{{vieja}}</nowiki> y cambia su contenido por el texto <code><nowiki>{{nueva|uno|dos}}</nowiki></code>
*Pon esta orden en Botellín/comandos: <code><nowiki>{{subst plantilla|vieja}}</nowiki></code>

===Para desenlazar una imagen===
Para retirar una imagen de todos los artículos en que se usa, usa {{tl|retirar imagen|NombreDeLaImagen}}. Si quisieras retirar, por ejemplo, [[:Image:Flag of Spain.svg]]:
{{retirar imagen|Flag of Spain.svg}}
Nótese que el bot sólo editará páginas en el espacio de nombres "0". Es decir, sólo los artículos.

=== Para desenlazar una plantilla ===
Para retirar una plantilla de todos los artículos en que se usa, usa {{tl|retirar plantilla|NombreDeLaPlantilla}}. Si quisieras retirar, por ejemplo, {{tl|esbozo}}:
{{retirar plantilla|esbozo}}

===Para reemplazar una imagen por otra===
Para reemplazar una imagen por otra, usa {{tl|reemplazar imagen|Nombre de la imagen que vas a reemplazar|Nombre de la nueva imagen}}:
 <nowiki>{{reemplazar imagen|Spain flag 300.png|Flag of Spain.svg}}</nowiki>
{{reemplazar imagen|Spain flag 300.png|Flag of Spain.svg}}

=== Para arreglar categorías redundantes ===
Para eliminar categorías redundantes en un solo artículo, usa {{tl|redund|Nombre del artículo}}. Para tratar todos los artículos en una categoría, usa {{tl|redundcat|Nombre de la categoría}}. 

El bot eliminará las categorías superiores (''madres'') y dejará las subcategorías más específicas (''hijas''). Es decir, como [[:Categoría:Localidades de México]] es una subcategoría de [[:Categoría:Geografía de México]], ésta segunda sería eliminada.
 Nota: Esta función no sirve muy bien, pero tampoco hace daño.

=== Para introducir un texto fijo en todos los artículos de una categoría ===
Esto es especialmente útil para introducir plantillas, pero también se podría usar para otras cosas. Esta función no se llama con plantillas como las demás porque eso confundiría al bot. En lugar, usamos etiquetas parecidas a las de HTML. Son las siguientes: 
:* '''<texto fijo>''', '''</texto fijo>''' - Para iniciar y concluir el comando.
:* '''<cat>''', '''</cat>''' - Para definir la categoría en que trabajar.
:* '''<texto>''', '''</texto>''' - Para definir el texto para introducir en los artículos.

Si ponemos, por ejemplo ''<texto fijo><cat>Cultura de Estados Unidos</cat><texto>Hola, mundo!</texto></texto fijo>'' en [[User:Orgullobot/comandos|/comandos]], el bot editará todas las páginas en [[:Categoría:Cultura de Estados Unidos]] introduciendo el texto "Hola mundo!".

'''Nota''': Como esta función es totalmente nuevecita y no sé qué bugs posiblemente tenga, hay una espera de 60 segundos entre cada edición. También vale que haya un bibliotecario listo para bloquear al bot si se vuelve loco.

===Para mandar un mensaje a varios usuarios===
Para que el bot deje un determinado mensaje en la discusión de un número de usuarios, usa {{tl|boletín|mensaje|lista}} donde <code>mensaje</code> es el nombre de la página donde está el mensaje que quieres difundir, y <code>lista</code> es el nombre de la página donde está la lista de usuarios destinarios. <code>Mensaje</code> y <code>lista</code> no deben estar en corchetes (<nowiki>[[*]]</nowiki>) y la lista de usuarios también debe contener nombres de usuarios "crudos", '''uno por cada línea'''. Un ejemplo sigue:

 <nowiki>{{boletín|User:Orgullobot/comandos/mensaje (ejemplo)|User:Orgullobot/comandos/lista (ejemplo)}}</nowiki>
{{boletín|User:Orgullobot/comandos/mensaje (ejemplo)|User:Orgullobot/comandos/lista (ejemplo)}}

La lista '''no puede contener nombres de usuarios cuya discusion esté redirigida'''. Por ejemplo, si la lista incluyera el nombre «[[Usuario Discusión:Netito|Netito]]» el bot no dejaría el mensaje ni a Netito ni a Netito777, donde éste redirige
<code>Mensaje</code> debe incluir tu firma igual que el texto titular. [[User:Orgullobot|Orgullobot]] no firmará el mensaje.

===Para arreglar los esbozos de X===
Muchas veces, la plantilla {{tl|esbozo de}} es usada incorrectamente. Orgullobot puede ayudar en estos casos, con la plantilla {{tl|esbozode}}. El primer parámetro será el incorrecto que se usa actualmente y que quieres cambiar, y el segundo será el correcto que quieres usar. Para conseguir que Orgullobot cambie todas las instancias de <nowiki>{{esbozo|biografía}}</nowiki> por <nowiki>{{esbozo|biografías}}</nowiki>, por ejemplo, colocarías 
 <nowiki>{{esbozode|biografía|biografías}}</nowiki>

=== Sustituir una plantilla por su categoría ===
Muchas plantillas de navegación pueden ser sustituidas por una categoría, ya existente o creada ad hoc. Para hacerlo se usa {{tl|replaceplantilla|Nombre de la plantilla|<nowiki>[[Categoría:Nombre de la categoría]]</nowiki>}}. Para eliminar {{tl|Curling}} y sustituirla en todos los artículos por la [[:Categoría:Curling]], se usa {{replaceplantilla|Curling|<nowiki>[[Categoría:Curling]]}}</nowiki>


<!--===Para trasladar una userbox a una subpágina de usuario===
{|align=right
|<div style="border:solid red 1px; margin:1px; width:238px; text-align:center;">
{| cellspacing="0" cellpadding="0" style="width:100%; background:red;"
|-
| style="width:47px; height:47px; background:red;" | [[Image:Iris1.jpg|50px]]
| style="font-size:8pt;padding:4px;line-height:2.5ex;" | <big>¡Ojo!</big><br>No uses esta función para trasladar userboxes que usan parámetros, el bot no puede. Ojalá con el tiempo aprenda, pero por ahora, nop.
|}</div>

|}
De acuerdo a la política establecida por [[Wikipedia:Votaciones/2006/Trasladar las etiquetas de usuario del espacio de nombres Plantilla|esta votación]], todas las [[Wikipedia:Userbox|userboxes]] deben ser trasladadas al espacio de nombre "Usuario:". La página de la plantilla se puede trasladar fácilmente, como cualquier otra página, usando [[Especial:Movepage]], pero resulta tedioso ir cambiando cada enlace a la plantilla trasladada manualmente para por fin borrarla del espacio de nombres "Plantilla:". En esto puede ayudar Orgullobot, con la plantilla {{tl|cambiarplantilla}}. El primer parámetro será donde la plantilla se encontraba anteriormente, en el espacio de nombres "Plantilla:", de donde será finalmente borrada; no incluyas el prefijo "Plantilla:" aquí. El segundo parámetro será a donde la plantilla será trasladada, en el espacio de nombres "Usuario:"; no incluyas el prefijo "Usuario:" aquí. 

Si quisieras cambiar todos los enlaces a [[Plantilla:Aficionado Ciencia Ficción]] para que apuntaran a [[Usuario:Orgullomoore/Plantilla:Aficionado Ciencia Ficción]], colocarías lo siguiente en [[User:Orgullobot/comandos|/comandos]]: 
 <nowiki>{{cambiarplantilla|Aficionado Ciencia Ficción|Orgullomoore/Plantilla:Aficionado Ciencia Ficción}}</nowiki>
{{cambiarplantilla|Aficionado Ciencia Ficción|Orgullomoore/Plantilla:Aficionado Ciencia Ficción}}
-->

== Nuevas ideas, mejoras, comentarios, etc. ==
No dudes en ponerte en contacto con [[Usuario Discusión:Sanbec|Sanbec]] para hacer una pregunta, decir un comentario, proponer una nueva idea/función, etc. Esto es algo nuevo y necesitará mucho trabajo.