Usuario:Orejotas/Manual
Aquí vamos a revelar toda la verdad sobre los últimos cambios efectuados para el comportamiento del bot más rebelde de freenode.
Novedades[editar]
características únicas[editar]
- Se ha implementado una manera singular para reconocer la cuenta asociada a un nick.
- El bot tiene su propio canal de control.
- El código es multilingüe traducido del inglés al castellano y catalán, con posibilidad de adaptarlo a cualquier otra lengua.
- El bot reconoce si un usuario está identificado mediante la cuenta asociada a su nick. Esto permite reconocer a un usuario sea cual sea el nick que esté usando, siempre y cuando esté identificado. Esta característica es posible gracias al IRCD de freenode, se desconoce la efectividad y compatibilidad en otras redes.
- Las órdenes aceptan más de un parámetros.
general[editar]
- El bot almacena algunos datos de interés para el propio usuario como su nombre de usuario en la Wikipedia, su proyecto y lengua predefinidos.
- A cada cuenta de usuario se le asigna una puntuación inicial. Esto permitirá determinar el comportamiento del usuario y realizar las pertinentes acciones.
- Por cada comando usado se resta un determinado número de puntos, generalmente uno.
- Un usuario con puntuación negativa será ignorado por el bot.
- Se distinguen diferentes tipos de comandos según su utilidad. Los comandos de entretenimiento necesitarán una puntuación mínima.
- Una sucesión de un mismo comando en menos de un minuto supondrá una sustracción significativa de puntos.
- Se acepta dos maneras de enviar una orden, la primera, la tradicional, prefijando un carácter especial al comando, la segunda, anteponiendo el nick del bot.
- Los errores del usuario, es decir, en caso que el usuario se equivoque al introducir una orden, se devuelven en formato de private notices.
enlaces[editar]
Los enlaces aceptan una serie de prefijos que ofrecen la posibilidad de devolver la dirección del historial de una página, o la página renderizada.
También en el interior del enlace se puede añadir todo tipo de parámetros (parsers) aceptados para la petición al servidor.
ámbito técnico[editar]
- El bot se ha conseguido mezclando los módulos de ircbot.py y irclib.py con los de phenny.py y irc.py.
- Con este bot híbrido se ha conseguido separar las órdenes por módulos.
- Además para actualizar y realizar cambios o añadir otros comandos bastará recargar los módulos afectados sin necesidad de reiniciar el bot.
- Cuando ocurre un error el bot envía un mensaje de error en el canal de control y evita que se desconecte.
otros[editar]
- Se han eliminado los comandos "@pi" y "@e", que devolvían una aproximación al número pi y de euler respectivamente.
Introducción[editar]
Las órdenes se pueden formular de dos maneras distintas, de forma que el resultado será diferente.
La primera manera es aquella en la que se prefija un carácter especial a la orden. Tradicionalmente el carácter especial utilizado era la arroba (@). Ahora, además, se pueden usar otros carácteres como el punto (.) y los cierres de interrogación (?) y de exclamación (!).
En cuanto a la seguna forma, el bot también acepta una orden si anteponemos su nick seguido de dos puntos (:) y un espacio.
La diferencia entre enviar una orden precedida de un carácter especial o del nick del propio bot, es que en el segundo caso se incluirá el nick del ordenante en el resultado. Esto permite asegurarnos de monitorizar el resultado solicitado al bot, sobre todo, para aquellos comandos que suelen tardar en devolver una respuesta.
A la primera la denominaremos orden sin remite y para la segunda formulación nos referiremos a ella como orden con remite. Mientras que al elemento que precede a la orden, es decir tanto a los carácteres especiales ("@", "!", "?" y ".") como al propio nombre del bot seguido de de dos puntos y un espacio (generalmente "orejotas: "), lo denominaremos marcador de comandos, o simplemente marcador.
Órdenes[editar]
general[editar]
| orden | parámetros | devuelve | comentarios |
|---|---|---|---|
| help | Ninguno. | Ayuda. | Devuelve la URL de este manual. |
| all | Ninguno. | Lista de comandos disponibles. | Es una lista de los comandos disponibes. |
| sug | Ninguno. | Palabras de agradecimiento. | Permite enviar a Pasqual sugerencias sobre su bot. |
wikipedia[editar]
| orden | parámetros | devuelve | comentarios |
|---|---|---|---|
| artículos | |||
| tam | Nombre (en wikipedia) del artículo. | Devuelve el tamaño de un artículo. | Útil por ejemplo para los wikiconcursos. |
| fetch | Nombre de una página en wikipedia. | Primeras palabras del artículo. | Devuelve las primeras palabras del artículo a modo de referencia y leyendo del código fuente. Se pueden usar interwikis. |
| estadísticas | |||
| art | Abreviatura de la wikipedia p.ej es (opcional). | Devuelve el número de ediciones de la wikipedia en ese momento y la diferencia respecto a es. | Si no se escribe el comando se sobrentiende es (español). Útil para las apuestas. |
| stats | código de un proyecto | Contenido de la página [[Special:Statistics]]. Es el método abreviado de @fetch Special:Statistics. | Si se omite el código del proyecto, devuelve el contenido de es:Special:Statistics. |
| ad | Ninguno. | devuelve el número de artículos destacados. | |
| ab | Ninguno. | devuelve el número de artículos buenos. | |
| cad | Ninguno. | devuelve el número de artículos candidatos a artículo destacado. | |
| usuarios | |||
| info | Nick (en wikipedia) del wikipedista. | Ofrece bastante información sobre dicho wikipedista. | No está disponible en privado. Se pueden usar interwikis i.e. commons:klondike. |
| count | usuario | Devuelve el número de contribuciones en tiempo real. | método abreviado @c. |
| status | usuario | Devuelve el número de contribuciones, el valor de la página de estado, o en su defecto calcula su estado, y el momento de su última edición | también @estado |
| enlaces | |||
| [[t]] | t es el título de un artículo. | Devuelve la dirección en wikipedia en español del artículo con dicho título. | Se puede usar en las conversaciones al principio final o en medio para que orejotas devuelva el enlace a dicho artículo. Aquí no es necesaria la arroba. Por ejemplo: "Hola echad un ojo a [[Usuario:orejotas]], que es un buen artículo". *Ampliar información |
| {{n}} | n es el nombre de una plantilla. | Devuelve la dirección en wikipedia en español de la plantilla con dicho nombre | Se puede usar en las conversaciones al principio final o en medio para que orejotas devuelva el enlace a dicha plantilla. Aquí no es necesaria la arroba. Por ejemplo: "Hola echad un ojo a {{Año}}, tiene un fallo grave". *Ampliar información |
| {{u|usr}} | usr es el nombre de un usuario. | Devuelve la dirección en wikipedia en español de la página de usuario con dicho nombre. | *Ampliar información |
| {{ud|usr}} | usr es el nombre de un usuario. | Devuelve la dirección en wikipedia en español de la página de discusión del usuario con dicho nombre. | *Ampliar información |
| vec | Ninguno. | Devuelve el enlace a Vandalismo en Curso. | Únicamente tiene sentido usarlo si quieres denunciar el vandalismo debido a un usuario/ip. |
| mant | Ninguno. | Devuelve los enlaces para el mantenimiento del día. | Únicamente tiene sentido usarlo si eres bibliotecario, tienes ganas de borrar artículos y son cerca de las 00:00. Equivale a @mantenimiento. |
| dest | Ninguno. | Devuelve el enlace con los artículos a borrar. | Únicamente tiene sentido usarlo si eres bibliotecario y tienes ganas de borrar artículos. |
| block | usuario | Devuelve una dirección para que un administrador bloquee el usuario indicado. | |
| bc | usuario | Devuelve dos direcciones una con el bloqueo, la otra con las contribuciones. | también @cb |
| otros | |||
| wname | Letras de la local de una wikipedia i.e. es. | Devuelve el nombre de esa wikipedia. | Útil para saber en que idioma está escrita una determinada wiki. |
obras de consulta[editar]
| orden | parámetros | devuelve | comentarios |
|---|---|---|---|
| en-es | Palabra en inglés. | 3 Palabras iguales o aproximadas en español. | Sirve cómo referencia rápida para conocer la traducción a inglés algunas palabras, pero siempre es más fiable un diccionario. Si no la encuentra buscará palabras parecidas en inglés. |
| es-en | Palabra en español. | 3 Palabras iguales o aproximadas en inglés. | Sirve cómo referencia rápida para conocer la traducción a inglés algunas palabras, pero siempre es más fiable un diccionario. Si no la encuentra buscará palabras parecidas en inglés. |
| orto | Palabra en español. | Palabra revisada ortográficamente. | Sirve como referencia rápida. Si la palabra no tiene fallos puede devolver "*". |
| drae | Palabra en español. | Dirección web a dicha palabra en en el DRAE. | Útil para buscar la definición de cierta palabra. |
| sino | Palabra en español. | Dirección web a dicha palabra en en el buscador de equivalentes sinonimos.org. | Útil para buscar palabras homólogas con las que escribir artículos ¿se nota que lo he usado para este?. |
| dpd | Palabra en español. | Dirección web a dicha palabra en en el Diccionario Panhispánico de Dudas. | Útil para buscar comprobar datos sobre ciertas palabras que causan dudas frecuentes. |
| el | Nombre de artículo. | Dirección web a dicho artículo en la enciclopedia libre. | Útil para ampliar artículos y buscar más información sobre algún tema. |
| flickr | Palabra | Dirección web a la búsqueda de esa palabra en flickr. | Útil para encontrar fotos para los artículos. Recuerda que no siempre podrás subirlos aunque siempre. podrán enlazar con ellas. |
| busca-xx | una cadena de búsqueda. | Devuelve el enlace de búsqueda en la wikipedia en xx mediante google de dichas palabras. | Útil para realizar búsquedas rápidas desde el chat.xx deben ser las letras de localización de una wikipedia, co para commons y me para meta. |
| wikipedia | una cadena de búsqueda. | Devuelve en elace de búsqueda en toda la wikipedia mediante google de dichas palabras. | Útil para realizar búsquedas rápidas desde el chat. |
| busca-go | una cadena de búsqueda. | Devuelve el enlace de búsqueda mediante google de dichas palabras. | Útil para realizar búsquedas rápidas desde el chat; equivale a @google. |
| wtf | Abreviatura habitual en Internet. | Devuelve su significado. | Este comando es muy útil para entender que significan todas esas palabras raras como lol o brb. |
utilidades[editar]
| orden | parámetros | devuelve | comentarios |
|---|---|---|---|
| = | Una operación. | Devuelve el resultado de esa operación. | Una pequeña calculadora útil para hacer cálculos sencillos; puedes usar los siguientes carácteres: ( ) * / - + ^ . y los espacios. Por ejemplo "@= 2 - (5 + (3 / 4) * 6)" devuelve -7.5. |
| whois | IP. | Devuelve la URL para conocer el whois de una IP. | |
| ping | Ninguno. | Responde a con el nombre del usuario solicitante. | Útil para saber si los mensajes están llegando al chat. En ciertos momentos y con cierto tipo de clientes resulta difícil saberlo. También se puede usar "PING" (sin ningún marcador de comando). |
entretenimiento[editar]
| orden | parámetros | devuelve | comentarios |
|---|---|---|---|
| galletita | Ninguno. | Devuelve una frase. | Siempre te inspira; lo digo por experiencia. |
| hora | Ninguno | Devuelve la hora actual. | Simplemente es útil si no tienes un reloj a mano. |
| mes | Ninguno | Devuelve el mes actual. | el comando anterior mostraba un calendario, pero se eliminó esta función por floodear. |
| random | Ninguno. | Sin parámetros, devuele pares o nones. | |
| x, y | Con dos parámetros numéricos separados por comas, devuelve un número aleatorio entre x e y, ambos incluídos. | Evidentemente x e y se sustituyen por números. | |
| cad1, cad2, cad3, ... | Con más de dos parámetros, o con dos parámetros no numéricos, separados por comas devolverá uno de ellos. |
Órdenes restringidas[editar]
Algunas órdenes sólo son efectivas cuando las envía un usuario con algún permiso. Este permiso se le concede a todos los operadores del canal que dispongan de cloak. En su defecto deberan opearse.
| orden | parámetros | devuelve | comentarios |
|---|---|---|---|
| join | #canal | Entra en un nuevo canal. | |
| part | #canal [mensaje] | Sale de un canal. | |
| botops | Ninguno. | Devuelve una lista de los operadores del bot. | |
| ign | usuario | Permite que el bot ignore los mensaje de un usuario impidiendo que ejecute comandos | se pueden utilizar los comodines ? (cualquier carácter) y * (uno o más caràcteres). No és válido "@ign *" |
| unign | usuario | Readmite al usuario | |
| igns | usuario | Devuelve una lista de usuarios ignorados por el bot. | |
| addop | cloak | añade un usuario a la lista de operadores del bot. | debe introducirse el cloak del usuario |
| removeop | cloak | elimina un usuario de la lista de operadores del bot. |
Mejoras[editar]
enlaces a páginas[editar]
prefijos: h, l, n, p, r, t, w.
| prefijo | referido a | ejemplo | devuelve | comentario |
|---|---|---|---|---|
| h | historial | h[[A]] | http://es.wikipedia.org/wiki/A?action=history. | |
| l | whatlinkshere | l[[A]] | http://es.wikipedia.org/wiki/Special:Whatlinkshere/A | |
| n | noredirects | n[[A]] | http://es.wikipedia.org/wiki/A?redirect=no | |
| p | prefixindex | p[[A]] | http://es.wikipedia.org/wiki/Special:Prefixindex/A | |
| r | render | r[[A]] | http://es.wikipedia.org/wiki/A?action=render | |
| t | test | t[[A]] | http://es.wikipedia.org/wiki/A 234 KB. Servido en 0.6802 seg. | |
| w | raw | w[[A]] | http://es.wikipedia.org/w/index.php?title=A&action=raw&ctype=text/javascript |
enlaces a plantillas[editar]
Se ha implementado un nuevo formato, no acorde con la sintaxis wiki, pero que nos permite recibir un enlace a una página de otro proyecto.
- {{u|ca:Pasqual}} devuelve http://ca.wikipedia.org/wiki/User:Pasqual
- que cambiará {{ca:u|Pasqual}} para guardar más relación con la sintaxis de los corchetes ([[ca:User:Pasqual]]).
Nota: para evitar que el bot devuelva un enlace puede usarse como prefijo el signo de cierre de exclamación. También se puede iniciar la línea con un acento circunflejo (^) provocando que el bot ignore toda la línea.
A tener en cuenta[editar]
- Este manual está en construcción.
- El vocablo "comando" con el sentido de "orden" es un anglicismo. Su uso se justifica por la popularidad que goza en el habla coloquial e inmediata tal como sucede en un chat.
- Parte de este manual es una copia de Usuario:Orejotas/Obsoleto/Manual (Pasqual), que a su vez fue una copia —en su primera edición, exacta— de Usuario:Orejotas/Obsoleto/Manual (Klondike), para luego proceder a los pertinentes cambios. De paso, el autor del presente manual agradece inmensamente la dedicación del primer autor por su labor desinteresada y su gran entrega a la causa.
- Estos tres manuales representan diferentes épocas del mismo, por lo que no parecía posible una fusión, la cual dificultaría una visión conjunta de cada una de ellas.