Usuari:TronaBot/IRC/ordres geni 2.0

A continuació s'exposen les ordres disponibles per al geni.

convencions

En esta pàgina s'utilitzaran les següents convencions:

• el text pla indica un text literal
• el text dins de <> indica que la valor l'ha de definir l'usuari.
• el text dins d'un parèntesi quadrat ([]) indica que és opcional
• les {} indiquen que s'ha de triar una de les valors separades de una barra vertical (|), per exemple en {valor1|valor2|valor3} s'ha de triar entre valor1, valor2 o valor3
• Una paraula prefixada per l'arrova (@) indica que es tracta d'una ordre.

sintaxi

A continuació definim com és interpretat un missatge enviat al bot, al canal o en privat, i quina és la sintaxi per a les diferents ordres.

Una ordre, generalment, és una paraula que permet al bot activar algun procés i enviar-ne un resultat.

L'arrova (@) és l'identificador d'ordres per antonomàsia, tot i que existeixen altres signes —el punt (.), el signe de tancament d'interrogació (?) i el d'exclamació (!) (que al ser signes de final de frase no solen aparéixer al principi)— que permeten reconéixer al bot que estem sol·licitant algun procés. A més a més, si la línia comença pel malnom del bot seguit de dos punts i un espai aquest també interpretarà la següent paraula (sense cap signe més) com una ordre, amb l'afegit que ens contestarà indicant el nostre malnom al principi de la resposta.

Per a enviar una ordre al bot s'ha de començar la línia amb aquesta.

Les ordres poden incloure arguments o bé múltiples opcions. La diferència entre arguments i opcions és que els arguments no necessiten cap identificador, mentre que les opcions són una estructura unària o binària en la que primer s'inclou el nom de l'opció i a continuació, separat d'un espai, es pot oferir un determinada valor per a esta.

Una opció va prefixada amb un guionet (-), la valor d'una opció va a continuació d'esta. A diferència d'altres intèrprets d'ordres, per a introduir la valor d'una opció no cal incloure dos punts (:) o el signe igual (=), ni s'ha de posar cometes encara que hi haja espais. Es pot definir diverses valors per a una mateixa opció o bé repetint esta, o bé separant-les amb un punt i coma (;). En el següent cas podem vore com es donen tres valors a una mateixa opció:

@ordre -opció1 valor1 ; valor2 -opció1 valor3

Si l'opció apareix sense cap valor, llavors li estem assignant una valor positiva. Es pot donar una valor negativa a una opció afegint un ! al començament:

@ordre -opció1 -!opció2

en la línia anterior l'opció2 és negativa.

La sintaxi d'una ordre sense arguments és

@ordre

La sintaxi d'una ordre amb arguments

@ordre argument1 argument2...

La sintaxi d'una ordre amb diverses opcions

@ordre -opció1 -opció2 valor_opció2 -!opció3

La sintaxi d'una ordre amb arguments i opcions

@ordre argument1 argument2 -opció1 -opció2 valor1

limitacions

El bot pot realitzar tantes tasques com ordres rep, la qual cosa podria causar un excessiu enviament de respostes i en un determinat cas l'expulsió del bot per part del servidor. Per a evitar este tipus de situacions el bot acceptarà un determinat nombre de comandes d'un mateix usuari, també es limita el nombre de comandes rebudes entre tots els usuaris i en acabant per a més seguretat es controla el flux de respostes enviades.

Quant als usuaris i degut a les il·limitades possibilitats d'actuació del bot s'ha de restringit l'execució d'algunes d'elles. Per la qual cosa s'ha determinat la creació de grups d'usuaris.

ordres

estadístiques

---

@art [<projecte>[/<codi>]]

L'ordre @art ens retorna el nombre d'articles (o pàgines en el espai de noms principal) en un projecte. El projecte tan potser d'una llengua com d'un projecte germà. En cas d'ometre el projecte s'obtindrà el de la Viquipèdia.

Si en posem un d'una llengua distinta a més de mostrar-nos el nombre d'articles ens donarà la diferència que hi ha amb el projecte germà en català.

Si volem comparar dos projectes dels quals cap és en català es pot afegir un segon argument separant-lo del primer amb una barra inclinada (/). Per exemple per a veure la diferència entre la viquipèdia en occità i la portuguesa emprarem la següent ordre:

@art oc/pt

Per a conéixer estes diferències entre els diferents viccionaris teclejaríem la següent instrucció:

@art wikt:oc/pt

---

@lloc [<nombre>|<codi>]

L'ordre @lloc ens retorna la posició d'un determinat projecte de la taula List of Wikipedias incloent el projecte anterior i posterior i especificant tant el nombre d'articles de cada projecte com la diferència entre ells i el sol·licitat.

L'argument pot ser el número que ocupa un projecte dins la llista o el codi de la llengua. Si s'omet, el projecte per defecte que es mostrarà serà la Viquipèdia. El nombre ha de ser entre 1 i el nombre total de projectes existents, actualment 271. El codi ha de ser el mateix que s'empra per a les diferents viquipèdies.

---

@ritme [<codi>[,<codi>][,<codi>][...]][ <hores>]

L'ordre @ritme ens retorna el ritme de creació d'articles creats en un projecte en les darreres 24 hores.

el <codi> correspon al codi de l'idioma del projecte, es poden assignar diversos separant-los únicament amb una coma (sense espai intermig).

Exemples:

• @ritme Per veure el ritme de creació d'articles a la Viquipèdia.
• @ritme 48 Si volem veure el ritme dels darrers dos dies.
• @ritme fr 72 Si volem vore el ritme del projecte en francés dels darrers 3 dies.
• @ritme zh,sv,uk per veure el ritme de la viquipèdia xinesa, sueca i ucrainesa.

executar scripts

---

@executa <script>

L'ordre @executa permet engegar qualsevol script dels que hi ha disponibles. Per conéixer quins són els programes disponible teclegeu @executa.

restriccions: esta ordre només la poden executar usuaris pertanyent al grup exec.