summaryrefslogtreecommitdiff
path: root/doc/it
diff options
context:
space:
mode:
authorSebastien Helleu <flashcode@flashtux.org>2011-10-26 19:25:51 +0200
committerSebastien Helleu <flashcode@flashtux.org>2011-10-26 19:25:51 +0200
commit9b42328d55db6ee97bc66ebb085dadf4d94c1df9 (patch)
tree961a07617c8776d0c85680acdbd779a386ce2937 /doc/it
parentd95aef21346b04c1fc17d52b96d0dfaa0cf3d43c (diff)
downloadweechat-9b42328d55db6ee97bc66ebb085dadf4d94c1df9.zip
guile: new script plugin for scheme (task #7289)
Diffstat (limited to 'doc/it')
-rw-r--r--doc/it/autogen/plugin_api/completions.txt2
-rw-r--r--doc/it/autogen/plugin_api/infolists.txt2
-rw-r--r--doc/it/autogen/user/guile_commands.txt20
-rw-r--r--doc/it/weechat_scripting.it.txt94
-rw-r--r--doc/it/weechat_user.it.txt65
5 files changed, 129 insertions, 54 deletions
diff --git a/doc/it/autogen/plugin_api/completions.txt b/doc/it/autogen/plugin_api/completions.txt
index 8d145f62b..3d8b2a5cc 100644
--- a/doc/it/autogen/plugin_api/completions.txt
+++ b/doc/it/autogen/plugin_api/completions.txt
@@ -8,6 +8,8 @@
| aspell | aspell_langs | elenco di lingue supportate per aspell
+| guile | guile_script | elenco degli script
+
| irc | irc_channel | canale IRC corrente
| irc | irc_channel_nicks_hosts | nick e host del canale IRC corrente
diff --git a/doc/it/autogen/plugin_api/infolists.txt b/doc/it/autogen/plugin_api/infolists.txt
index 70cfd165f..7dcf002ef 100644
--- a/doc/it/autogen/plugin_api/infolists.txt
+++ b/doc/it/autogen/plugin_api/infolists.txt
@@ -4,6 +4,8 @@
| alias | alias | elenco di alias | puntatore all'alias (opzionale) | nome alias (può iniziare o terminare con "*" come carattere jolly) (opzionale)
+| guile | guile_script | elenco degli script | puntatore allo script (opzionale) | nome script (può iniziare o terminare con "*" come carattere jolly) (opzionale)
+
| irc | irc_channel | elenco dei canali per un server IRC | puntatore al canale (opzionale) | server,canale (canale è opzionale)
| irc | irc_ignore | elenco di ignore IRC | puntatore all'ignore (opzionale) | -
diff --git a/doc/it/autogen/user/guile_commands.txt b/doc/it/autogen/user/guile_commands.txt
new file mode 100644
index 000000000..989c5e3fa
--- /dev/null
+++ b/doc/it/autogen/user/guile_commands.txt
@@ -0,0 +1,20 @@
+[[command_guile_guile]]
+[command]*`guile`* elenca/carica/scarica script::
+........................................
+/guile list|listfull [<nome>]
+ load <nomefile>
+ autoload
+ reload|unload [<nome>]
+
+ list: elenca i plugin caricati
+ listfull: elenca i plugin caricati (dettagliato)
+ load: carica un plugin
+ autoload: carica automaticamente i plugin nella cartella utente o di sistema
+ reload: ricarica un plugin (se non specificato, scarica i plugin e li ricarica automaticamente)
+ unload: scarica uno o tutti i plugin
+nome_file: (file) script da caricare
+ nome: il nome di uno script (usato nella chiamata alla funzione "register")
+
+Senza argomento, questo comando elenca tutti i plugin caricati.
+........................................
+
diff --git a/doc/it/weechat_scripting.it.txt b/doc/it/weechat_scripting.it.txt
index 0f72b68b2..912c10552 100644
--- a/doc/it/weechat_scripting.it.txt
+++ b/doc/it/weechat_scripting.it.txt
@@ -17,9 +17,16 @@ Introduzione
WeeChat (Wee Enhanced Environment for Chat) è un client di chat libero,
veloce e leggero, realizzato per molti sistemi operativi.
-Questo manuale documenta i metodi per la realizzazione di script per
-WeeChat, utilizzando uno dei cinque linguaggi di script supportati: perl,
-python, ruby, lua o tcl.
+// TRANSLATION MISSING
+This manual documents way to write scripts for WeeChat, using one of supported
+script languages:
+
+* python
+* perl
+* ruby
+* lua
+* tcl
+* guile (scheme)
[NOTE]
Quasi tutti gli esempi in questo manuale sono scritti in Python, ma l'API
@@ -33,20 +40,46 @@ Script in WeeChat
Specifiche per i linguaggi
~~~~~~~~~~~~~~~~~~~~~~~~~~
-Alcune cose sono specifiche per i linguaggi:
+Python
+^^^^^^
-* perl:
-** le funzioni sono chiamate con `weechat::xxx(arg1, arg2, ...);`
-* python:
-** è necessario `import weechat`
-** le funzioni `print*` sono chiamate `prnt*` in python (dato che 'print'
- è una parola riservata)
-** le funzioni sono chiamate con `weechat.xxx(arg1, arg2, ...)`
-* ruby:
-** è necessario definire 'weechat_init' e chiamare 'register' all'interno
-** le funzioni sono chiamate con `Weechat.xxx(arg1, arg2, ...)`
-* tcl:
-** le funzioni sono chiamate con `weechat::xxx arg1 arg2 ...`
+* E necessario `import weechat`
+* Le funzioni `print*` sono chiamate `prnt*` in python (dato che 'print'
+ è una parola riservata)
+* Le funzioni sono chiamate con `weechat.xxx(arg1, arg2, ...)`
+
+Perl
+^^^^
+
+* Le funzioni sono chiamate con `weechat::xxx(arg1, arg2, ...);`
+
+Ruby
+^^^^
+
+* E necessario definire 'weechat_init' e chiamare 'register' all'interno
+* Le funzioni sono chiamate con `Weechat.xxx(arg1, arg2, ...)`
+
+Lua
+^^^
+
+* Le funzioni sono chiamate con `weechat.xxx(arg1, arg2, ...)`
+
+Tcl
+^^^
+
+* Le funzioni sono chiamate con `weechat::xxx arg1 arg2 ...`
+
+Guile (scheme)
+^^^^^^^^^^^^^^
+
+// TRANSLATION MISSING
+* Functions are called with `(weechat:xxx arg1 arg2 ...)`
+* Following functions take one list of arguments (instead of many arguments
+ for other functions), because number of arguments exceed number of allowed
+ arguments in Guile:
+** config_new_section
+** config_new_option
+** bar_new
[[register_function]]
Registrare una funzione
@@ -76,14 +109,6 @@ Argomenti:
Esempio di script, per ogni linguaggio:
-* perl:
-
-[source,perl]
-----------------------------------------
-weechat::register("test_perl", "FlashCode", "1.0", "GPL3", "Test script", "", "");
-weechat::print("", "Hello, from perl script!");
-----------------------------------------
-
* python:
[source,python]
@@ -94,6 +119,14 @@ weechat.register("test_python", "FlashCode", "1.0", "GPL3", "Test script", "", "
weechat.prnt("", "Hello, from python script!")
----------------------------------------
+* perl:
+
+[source,perl]
+----------------------------------------
+weechat::register("test_perl", "FlashCode", "1.0", "GPL3", "Test script", "", "");
+weechat::print("", "Hello, from perl script!");
+----------------------------------------
+
* ruby:
[source,ruby]
@@ -115,12 +148,20 @@ weechat.print("", "Hello, from lua script!")
* tcl:
-// [source,tcl]
+[source,tcl]
----------------------------------------
weechat::register "test_tcl" "FlashCode" "1.0" "GPL3" "Test script" "" ""
weechat::print "" "Hello, from tcl script!"
----------------------------------------
+* guile (scheme):
+
+[source,lisp]
+----------------------------------------
+(weechat:register "test_scheme" "FlashCode" "1.0" "GPL3" "Test script" "" "")
+(weechat:print "" "Hello, from scheme script!")
+----------------------------------------
+
[[load_script]]
Caricare uno script
~~~~~~~~~~~~~~~~~~~
@@ -128,11 +169,12 @@ Caricare uno script
Il comando da utilizzare, in base al linguaggio:
----------------------------------------
-/perl load perl/script.pl
/python load python/script.py
+/perl load perl/script.pl
/ruby load ruby/script.rb
/lua load lua/script.lua
/tcl load tcl/script.tcl
+/guile load guile/script.scm
----------------------------------------
È possibile creare un link nella cartella 'linguaggio/autoload' per caricare
diff --git a/doc/it/weechat_user.it.txt b/doc/it/weechat_user.it.txt
index c15b210b7..c9ec6f63f 100644
--- a/doc/it/weechat_user.it.txt
+++ b/doc/it/weechat_user.it.txt
@@ -90,23 +90,24 @@ Dipendenze
La seguente tabella mostra l'elenco di pacchetti richiesti o opzionali per
compilare WeeChat.
-[width="80%",cols="4,^2,13",options="header"]
+[width="100%",cols="5,^3,^3,13",options="header"]
|========================================
-| Pacchetto ^(1)^ | Richiesto | Caratteristica
-| cmake | *sì* | compilazione (ancora possibile con autotools, ma si raccomanda cmake)
-| libncursesw5-dev ^(2)^ | *sì* | interfaccia ncurses
-| gettext | no | internazionalizzazione (traduzione dei messaggi; la lingua base è l'inglese)
-| libgcrypt11-dev | no | autenticazione SASL per i server IRC che utilizzano il meccanismo DH-BLOWFISH
-| libgnutls-dev (≥ 2.2.0) | no | connessione SSL al server IRC
-| ca-certificates | no | certificati per le connessioni SSL
-| libaspell-dev | no | plugin aspell
-| libperl-dev | no | plugin perl
-| python-dev | no | plugin python
-| ruby1.8-dev | no | plugin ruby
-| liblua5.1-0-dev | no | plugin lua
-| tcl-dev (≥ 8.5) | no | plugin tcl
-| asciidoc (≥ 8.5.0) | no | compilazione della documentazione (file HTML)
-| source-highlight | no | evidenziazione della sintassi per i sorgenti nella documentazione HTML
+| Pacchetto ^(1)^ | Versione | Richiesto | Caratteristica
+| cmake | | *sì* | compilazione (ancora possibile con autotools, ma si raccomanda cmake)
+| libncursesw5-dev ^(2)^ | | *sì* | interfaccia ncurses
+| gettext | | | internazionalizzazione (traduzione dei messaggi; la lingua base è l'inglese)
+| libgcrypt11-dev | | | autenticazione SASL per i server IRC che utilizzano il meccanismo DH-BLOWFISH
+| libgnutls-dev | ≥ 2.2.0 | | connessione SSL al server IRC
+| ca-certificates | | | certificati per le connessioni SSL
+| libaspell-dev | | | plugin aspell
+| python-dev | 2.5 → 2.7 | | plugin python
+| libperl-dev | | | plugin perl
+| ruby1.8-dev | | | plugin ruby
+| liblua5.1-0-dev | | | plugin lua
+| tcl-dev | ≥ 8.5 | | plugin tcl
+| guile-1.8-dev | | | plugin guile (scheme)
+| asciidoc | ≥ 8.5.0 | | compilazione della documentazione (file HTML)
+| source-highlight | | | evidenziazione della sintassi per i sorgenti nella documentazione HTML
|========================================
[NOTE]
@@ -1011,8 +1012,8 @@ I plugin trovati vengono caricati automaticamente all'avvio di WeeChat, ed
È importante evidenziare la differenza tra un 'plugin' ed uno 'script': un
'plugin' è un file binario compilato e caricato con il comando `/plugin`,
-mentre uno 'script' è un file di testo caricato con un plugin come 'perl'
-con il comando `/perl`.
+mentre uno 'script' è un file di testo caricato con un plugin come 'python'
+con il comando `/python`.
È possibile utilizzare il comando `/plugin` per caricare/scaricare un plugin,
oppure elencare tutti i plugin caricati.
@@ -1041,11 +1042,12 @@ I plugin predefiniti sono:
| logger | Registra i buffer su file
| relay | Relay dei dati via rete (proxy IRC)
| rmodifier | Cambia le stringhe del modificatore con espressioni regolari
-| perl | API per lo scripting in Perl
| python | API per lo scripting in Python
+| perl | API per lo scripting in Perl
| ruby | API per lo scripting in Ruby
| lua | API per lo scripting in Lua
| tcl | API per lo scripting in TCL
+| guile | API per lo scripting in Guile (scheme)
| xfer | Trasferimento file e chat diretta
|=======================================
@@ -1244,11 +1246,11 @@ $ echo 'irc.freenode.#weechat *hello!' >~/.weechat/weechat_fifo_12345
$ echo '*hello!' >~/.weechat/weechat_fifo_12345
----------------------------------------
-* inviare due comandi per scaricare/caricare gli script Perl (è necessario
+* inviare due comandi per scaricare/caricare gli script Python (è necessario
separarli con "\n"):
----------------------------------------
-$ echo -e '*/perl unload\n*/perl autoload' >~/.weechat/weechat_fifo_12345
+$ echo -e '*/python unload\n*/python autoload' >~/.weechat/weechat_fifo_12345
----------------------------------------
È possibile realizzare uno script per inviare un comando a tutte le istanze di
@@ -1956,7 +1958,8 @@ Se la riga di comando contiene: `/oper nick password` allora sullo schermo diven
Plugin per gli script
~~~~~~~~~~~~~~~~~~~~~
-WeeChat fornisce 5 plugin per lo scripting: Perl, Python, Ruby, Lua, Tcl.
+WeeChat fornisce 6 plugin per lo scripting: Python, Perl, Ruby, Lua, Tcl, Guile
+(scheme).
Questi plugin possono caricare, eseguire e scaricare gli script per questi
linguaggi.
@@ -1965,18 +1968,18 @@ per gli script, consultare la 'Guida allo Scripting di WeeChat'.
È possibile trovare alcuni script qui: http://www.weechat.org/scripts
-[[perl_commands]]
-Comandi Perl
-^^^^^^^^^^^^
-
-include::autogen/user/perl_commands.txt[]
-
[[python_commands]]
Comandi Python
^^^^^^^^^^^^^^
include::autogen/user/python_commands.txt[]
+[[perl_commands]]
+Comandi Perl
+^^^^^^^^^^^^
+
+include::autogen/user/perl_commands.txt[]
+
[[ruby_commands]]
Comandi Ruby
^^^^^^^^^^^^
@@ -1995,6 +1998,12 @@ Comandi Tcl
include::autogen/user/tcl_commands.txt[]
+[[guile_commands]]
+Comandi Guile
+^^^^^^^^^^^^^
+
+include::autogen/user/guile_commands.txt[]
+
[[xfer_plugin]]
Plugin Xfer
~~~~~~~~~~~