Dimensione: 9266
Commento: category comunita
|
Dimensione: 9163
Commento: converted to 1.6 markup
|
Le cancellazioni sono segnalate in questo modo. | Le aggiunte sono segnalate in questo modo. |
Linea 1: | Linea 1: |
## page was renamed from UbotIt | |
Linea 3: | Linea 4: |
[[BR]] ||<tablebgcolor="#f1f1ed" tablewidth="30%" tablestyle="margin: 0pt 0pt 1em 1em; float: right; font-size: 0.9em;"style="padding: 0.5em;">'''Indice'''[[BR]][[TableOfContents]] || |
<<BR>> <<Indice(depth=2)>> |
Linea 11: | Linea 12: |
Questo bot permette di visualizzare, aggiungere, eliminare, cambiare, ''lockare'' (e quindi rendere non modificabili) e ''unlockare'' varie definizioni. [[BR]] Queste definizioni sono del tipo: "parola"-> "valore", dove "parola" è la parola da cercare (es.: "mp3"), e "valore" è la definizione per "parola" (es.: "vedere http://wiki.ubuntu-it.org/FormatiProprietari"). | Questo bot permette di visualizzare, aggiungere, eliminare, cambiare, ''lockare'' (e quindi rendere non modificabili) e ''unlockare'' varie definizioni. <<BR>> Queste definizioni sono del tipo: "parola"-> "valore", dove "parola" è la parola da cercare (es.: "mp3"), e "valore" è la definizione per "parola" (es.: "vedere http://wiki.ubuntu-it.org/FormatiProprietari"). |
Linea 18: | Linea 19: |
attachment:Icone/Grandi/info.png ''Da questo momento in poi la forma abbreviata e la forma estesa verranno usate arbitrariamente, ma, ovviamente, possono essere usate entrambe.'' | {{attachment:Icone/Grandi/info.png}} ''Da questo momento in poi la forma abbreviata e la forma estesa verranno usate arbitrariamente, ma, ovviamente, possono essere usate entrambe.'' |
Linea 29: | Linea 30: |
Per cercare una voce (e nel valore della voce) nel database: {{{!search <key>}}} [[BR]][[BR]] Esempio: {{{!search gestione}}} restituirà | Per cercare una voce (e nel valore della voce) nel database: {{{!search <key>}}} <<BR>><<BR>> Esempio: {{{!search gestione}}} restituirà |
Linea 43: | Linea 44: |
attachment:Icone/Piccole/warning.png ~+'''''Vedere a fondo pagina il meccanismo dei permessi.'''''+~ [[BR]][[BR]] | {{attachment:Icone/Piccole/warning.png}} ~+'''''Vedere a fondo pagina il meccanismo dei permessi.'''''+~ <<BR>><<BR>> |
Linea 60: | Linea 61: |
attachment:Icone/Piccole/warning.png ~+'''''Vedere a fondo pagina il meccanismo dei permessi.'''''+~ [[BR]][[BR]] Molte voci hanno una descrizione comune (ad esempio, "mp3", "wmv", "wma" sono tutti formati proprietari, e possono avere la stessa definizione.[[BR]] È quindi comodo creare (sempre seguendo l'esempio) solamente una voce "FormatiProprietari" come descritto nel punto precedente e poi creare uno o più alias ad essa. La sintassi è: | {{attachment:Icone/Piccole/warning.png}} ~+'''''Vedere a fondo pagina il meccanismo dei permessi.'''''+~ <<BR>><<BR>> Molte voci hanno una descrizione comune (ad esempio, "mp3", "wmv", "wma" sono tutti formati proprietari, e possono avere la stessa definizione.<<BR>> È quindi comodo creare (sempre seguendo l'esempio) solamente una voce "FormatiProprietari" come descritto nel punto precedente e poi creare uno o più alias ad essa. La sintassi è: |
Linea 80: | Linea 81: |
attachment:Icone/Piccole/warning.png ~+'''''Vedere a fondo pagina il meccanismo dei permessi.'''''+~ [[BR]][[BR]] Per eliminare una voce dal database si usa il comando {{{forget}}}. La sintassi è la seguente: | {{attachment:Icone/Piccole/warning.png}} ~+'''''Vedere a fondo pagina il meccanismo dei permessi.'''''+~ <<BR>><<BR>> Per eliminare una voce dal database si usa il comando {{{forget}}}. La sintassi è la seguente: |
Linea 88: | Linea 89: |
attachment:Icone/Piccole/warning.png ~+'''''Vedere a fondo pagina il meccanismo dei permessi.'''''+~ [[BR]][[BR]] Per modificare una voce nel database si usa il comando {{{change}}}. La sintassi è la seguente: | {{attachment:Icone/Piccole/warning.png}} ~+'''''Vedere a fondo pagina il meccanismo dei permessi.'''''+~ <<BR>><<BR>> Per modificare una voce nel database si usa il comando {{{change}}}. La sintassi è la seguente: |
Linea 96: | Linea 97: |
attachment:Icone/Piccole/warning.png ~+'''''Vedere a fondo pagina il meccanismo dei permessi.'''''+~ [[BR]][[BR]] Per bloccare una voce nel database si usa il comando {{{lock}}}. La sintassi è la seguente: | {{attachment:Icone/Piccole/warning.png}} ~+'''''Vedere a fondo pagina il meccanismo dei permessi.'''''+~ <<BR>><<BR>> Per bloccare una voce nel database si usa il comando {{{lock}}}. La sintassi è la seguente: |
Linea 104: | Linea 105: |
attachment:Icone/Piccole/warning.png ~+'''''Vedere a fondo pagina il meccanismo dei permessi.'''''+~ [[BR]][[BR]] | {{attachment:Icone/Piccole/warning.png}} ~+'''''Vedere a fondo pagina il meccanismo dei permessi.'''''+~ <<BR>><<BR>> |
Linea 109: | Linea 110: |
attachment:Icone/Piccole/warning.png ~+'''''Vedere a fondo pagina il meccanismo dei permessi.'''''+~ [[BR]][[BR]] | {{attachment:Icone/Piccole/warning.png}} ~+'''''Vedere a fondo pagina il meccanismo dei permessi.'''''+~ <<BR>><<BR>> |
Linea 116: | Linea 117: |
'''Ovviamente''' ha senso se dato in query. [[BR]] attachment:Icone/Grandi/info.png a differenza di tutti gli altri comandi, in query il suo utilizzo rimane invariato (es.: non includere il nome del canale). | '''Ovviamente''' ha senso se dato in query. <<BR>> {{attachment:Icone/Grandi/info.png}} a differenza di tutti gli altri comandi, in query il suo utilizzo rimane invariato (es.: non includere il nome del canale). |
Linea 126: | Linea 127: |
Tutte le voci correntemente presenti nel database sono visibili alla pagina ["/Voci"] . | Tutte le voci correntemente presenti nel database sono visibili alla pagina [[/Voci]] . |
Linea 132: | Linea 133: |
Il bot non è aperto completamente agli utenti.[[BR]][[BR]] Delle precedenti, alcune opzioni sono riservate ad alcuni utenti (come testimonia l'avviso all' inizio della definizione), ovvero agli operatori del canale. Puoi trovare la lista completa a [https://launchpad.net/~ubuntu-it-irc/+members questo indirizzo]. | Il bot non è aperto completamente agli utenti.<<BR>><<BR>> Delle precedenti, alcune opzioni sono riservate ad alcuni utenti (come testimonia l'avviso all' inizio della definizione), ovvero agli operatori del canale. Puoi trovare la lista completa a [[https://launchpad.net/~ubuntu-it-irc/+members|questo indirizzo]]. |
Linea 140: | Linea 141: |
Per dubbi e/o suggerimenti, potete contattare il ["Consiglio"] che gestisce il bot. | Per dubbi e/o suggerimenti, potete contattare il [[Consiglio]] che gestisce il bot. |
Linea 150: | Linea 151: |
Se riscontrate altri problemi potete contattatare il ["Consiglio"] della comunità. | Se riscontrate altri problemi potete contattatare il GruppoIrc. |
Linea 152: | Linea 153: |
CategoryComunita | CategoryComunitaIrc |
Indice
- Introduzione: Cos'è ubot-it?
-
Utilizzo di ubot-it
- Visualizzare voci del database
- Fare in modo che il bot si rivolga ad un utente in particolare
- Cercare voci nel database
- Mostrare ad un solo utente specifico la voce del database
- Aggiungere voci nel database
- Creare alias per voci presenti nel database
- Eliminare voci dal database
- Modificare voci del database
- Rendere non modificabili alcune voci del database
- Rendere modificabili alcune voci del database
- Far annunciare qualcosa nel canale dal bot
- Utilizzo avanzato
- Comportamento in caso di errore
- Meccanismo dei permessi
- Suggerire aggiunta delle voci
- Risoluzione problemi noti
Introduzione: Cos'è ubot-it?
Per chi ha familiarità con il canale #ubuntu su Freenode, possiamo dire che ubot-it è il corrispettivo italiano del bot internazionale Ubotu. In linea generale, ubot-it serve per dare, con un solo comando, quelle risposte che vengono date frequentemente con assoluta semplicità, come dimostrato dalla sintassi (vedere sotto).
Utilizzo di ubot-it
Questo bot permette di visualizzare, aggiungere, eliminare, cambiare, lockare (e quindi rendere non modificabili) e unlockare varie definizioni.
Queste definizioni sono del tipo: "parola"-> "valore", dove "parola" è la parola da cercare (es.: "mp3"), e "valore" è la definizione per "parola" (es.: "vedere http://wiki.ubuntu-it.org/FormatiProprietari").
Visualizzare voci del database
Per visualizzare una voce del database, si hanno diverse possibilità, che cambiano solo per forma ma non per risultato:
ubot-it: <parola> (esempio: ubot-it: mp3)
- !mp3
Da questo momento in poi la forma abbreviata e la forma estesa verranno usate arbitrariamente, ma, ovviamente, possono essere usate entrambe.
Se la parola cercata c'è, il bot vi restituirà la definizione cercata, altrimenti vi avviserà che non ci sono definizioni per quella parola.
Fare in modo che il bot si rivolga ad un utente in particolare
Spesso capita (mettiamo anche il caso che il canale sia molto frequentato, e che un eventuale chiamata al bot potrebbe risultare poco chiara, nel senso che potrebbe non essere chiaro a chi sia diretto il suggerimento) di dover avvertire un utente particolare circa il significato di una parola chiave. Oltre al comando tell (descritto sotto) che svolge questo ruolo in query, molto spesso non è necessario (e anche fastidioso ricevere numerosi messaggi privati). Il comando per svolgere il compito che vogliamo è !say ubuntu > <nickname> (oppure !say ubuntu to <nickname>) dove <nickname> è ovviamente il nick al quale vogliamo rivolgere il suggerimento. La risposta ora sarà:
<nickname>, "ubuntu": http://www.ubuntu.com
Cercare voci nel database
Per cercare una voce (e nel valore della voce) nel database: !search <key>
Esempio: !search gestione restituirà
'gestione programmi'
Mostrare ad un solo utente specifico la voce del database
Capita spesso che bisogna mostrare ad un solo utente la definizione piuttosto che a tutto il canale. Questo è possibile per mezzo dei nested-command. Se ad esempio vogliamo mostrare ad un utente che è off-topic in canale la possibilità di entrare in #ubuntu-it-chat, la sintassi è
tell <nick> [chat]
dove nick è il nick dell'utente.
Aggiungere voci nel database
Vedere a fondo pagina il meccanismo dei permessi.
Per aggiungere una voce nel database si usa il comando learn. La sintassi è la seguente:
learn [<channel>] <key> = <value>
dove <channel> è il canale (nel caso di ubot-it può essere omesso, non verrà più specificato per il resto del documento), <key> è la parola da aggiungere e <value> è la definizione.
Esempio:
!learn mp3 = vedere http://wiki.ubuntu-it.org/FormatiProprietari o http://help.ubuntu-it.org/guidabreezy/ch03.html#sect-music-and-movies
E' possibile inoltre avere più definizioni per la stessa parola (che si aggiungono come nell'esempio precedente una alla volta). Quando si cercherà di visualizzare la parola, verrà data una definizione del tipo "(#1)prima definizione (#2)seconda definizione (#3)....."
Creare alias per voci presenti nel database
Vedere a fondo pagina il meccanismo dei permessi.
Molte voci hanno una descrizione comune (ad esempio, "mp3", "wmv", "wma" sono tutti formati proprietari, e possono avere la stessa definizione.
È quindi comodo creare (sempre seguendo l'esempio) solamente una voce "FormatiProprietari" come descritto nel punto precedente e poi creare uno o più alias ad essa. La sintassi è:
add <name> <alias>
Per cui, per l'esempio:
add mp3 FormatiProprietari add wmv FormatiProprietari etc....
Gli alias si rimuovono con il comando remove.
ATTENZIONE: Se la voce per cui si deve creare un alias contiene caratteri speciali ("-", "+", "*", etc...), il comando da dare è
add <name> [<alias>]
Eliminare voci dal database
Vedere a fondo pagina il meccanismo dei permessi.
Per eliminare una voce dal database si usa il comando forget. La sintassi è la seguente:
forget [<channel>] <key> [<number>|*]
Il suo utilizzo è simile alla procedura per aggiungere voci. L'unica spiegazione da dare è quella che riguarda <number>. <number> non è necessario se c'è una sola definizione per quella voce, ma diventa necessario se ce ne sono più di una, quindi si deve aggiungere il numero della definizione che si vuole cancellare. Se si vogliono cancellare tutte le definizioni per quella parola, basta mettere "*" al posto del numero.
Modificare voci del database
Vedere a fondo pagina il meccanismo dei permessi.
Per modificare una voce nel database si usa il comando change. La sintassi è la seguente:
change [<channel>] <key> <number> <regexp>
Cambia la definizione numero <number> della voce <key> secondo <regexp>.
Rendere non modificabili alcune voci del database
Vedere a fondo pagina il meccanismo dei permessi.
Per bloccare una voce nel database si usa il comando lock. La sintassi è la seguente:
lock [<channel>] <key>
Blocca la/le definizione/i associate a <key> in modo che non possono essere modificate (rimosse o aggiunte).
Rendere modificabili alcune voci del database
Vedere a fondo pagina il meccanismo dei permessi.
Significato opposto rispetto a lock, per cui rende le voci modificabili. Il comando è unlock
Far annunciare qualcosa nel canale dal bot
Vedere a fondo pagina il meccanismo dei permessi.
Molto utile per informazioni di servizio, ovviamente utilizzabile dagli operatori. Il comando:
announce <testo da annunciare>
Ovviamente ha senso se dato in query.
a differenza di tutti gli altri comandi, in query il suo utilizzo rimane invariato (es.: non includere il nome del canale).
Utilizzo avanzato
Utilizzo in query
È possibile utilizzare anche il bot in query (privato). La sintassi cambia leggermente, perchè il comando deve contenere anche il nome del canale. Per esempio, per aggiungere una voce "comandi base" in query per il canale #ubuntu-it, il comando è
learn #ubuntu-it comandi base = http://wiki.ubuntu-it.org/AmministrazioneSistema/ComandiBase
Vedere tutte le voci salvate nel database
Tutte le voci correntemente presenti nel database sono visibili alla pagina /Voci .
Comportamento in caso di errore
ubot-it risponderà con una combinazione di query/notice. In questo modo il canale sara' pulito e chi non vuole ricevere gli errori da ubot-it può ignorare le notice da esso provenienti.
Meccanismo dei permessi
Il bot non è aperto completamente agli utenti.
Delle precedenti, alcune opzioni sono riservate ad alcuni utenti (come testimonia l'avviso all' inizio della definizione), ovvero agli operatori del canale. Puoi trovare la lista completa a questo indirizzo.
Suggerire aggiunta delle voci
Se volete segnalare l'aggiunta di alcune voci, se uno dei precedenti utenti è presente nel canale, contattatelo e deciderà l'idoneità o meno della richiesta, altrimenti potete aggiungere la "voce -> definizione" sulla pagina /DaAggiungere.
Per richiamare l'attenzione di tutti gli operatori, basta scrivere !ops.
Per dubbi e/o suggerimenti, potete contattare il Consiglio che gestisce il bot.
Risoluzione problemi noti
Nick con caratteri speciali
Se un nick contiene le parentesi quadre ( '[' e ']' ), potreste avere problemi nell'utilizzo del bot, poichè sono usate dal bot stesso per alcune operazioni. Tutto ciò che dovete fare per aggirare il problema è racchiudere il vostro nick all'interno delle virgolette. Esempio:
tell "nick[resto del nick nelle parentesi]" [mp3]
Altri?
Se riscontrate altri problemi potete contattatare il GruppoIrc.