From 3c7c99b1b56160b5bc22fc35988209ce01237b4a Mon Sep 17 00:00:00 2001 From: Sebastien Helleu Date: Wed, 18 Nov 2009 21:36:21 +0100 Subject: [PATCH] Add italian docs: quickstart and tester --- configure.in | 1 + doc/CMakeLists.txt | 1 + doc/de/CMakeLists.txt | 6 +- doc/de/Makefile.am | 6 +- doc/fr/CMakeLists.txt | 10 +- doc/fr/Makefile.am | 12 +- doc/it/CMakeLists.txt | 37 +++++ doc/it/Makefile.am | 43 +++++ doc/it/weechat_quickstart.it.txt | 262 +++++++++++++++++++++++++++++++ doc/it/weechat_tester.it.txt | 146 +++++++++++++++++ doc/ja/CMakeLists.txt | 2 +- doc/ja/Makefile.am | 2 +- doc/pl/CMakeLists.txt | 6 +- doc/pl/Makefile.am | 6 +- doc/ru/CMakeLists.txt | 2 +- doc/ru/Makefile.am | 2 +- po/de.po | 3 +- po/it.po | 5 +- 18 files changed, 521 insertions(+), 31 deletions(-) create mode 100644 doc/it/CMakeLists.txt create mode 100644 doc/it/Makefile.am create mode 100644 doc/it/weechat_quickstart.it.txt create mode 100644 doc/it/weechat_tester.it.txt diff --git a/configure.in b/configure.in index 4e3cad944..e97dc71f3 100644 --- a/configure.in +++ b/configure.in @@ -946,6 +946,7 @@ AC_OUTPUT([Makefile doc/de/Makefile doc/ru/Makefile doc/ja/Makefile + doc/it/Makefile src/Makefile src/core/Makefile src/plugins/Makefile diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt index 1952203fc..b1d2b3c19 100644 --- a/doc/CMakeLists.txt +++ b/doc/CMakeLists.txt @@ -25,6 +25,7 @@ IF(NOT DISABLE_DOC) ADD_SUBDIRECTORY( de ) ADD_SUBDIRECTORY( ru ) ADD_SUBDIRECTORY( ja ) + ADD_SUBDIRECTORY( it ) ENDIF(ASCIIDOC_FOUND AND SOURCEHIGHLIGHT_FOUND) ENDIF(NOT DISABLE_DOC) diff --git a/doc/de/CMakeLists.txt b/doc/de/CMakeLists.txt index d48121f61..ed723de5d 100644 --- a/doc/de/CMakeLists.txt +++ b/doc/de/CMakeLists.txt @@ -17,7 +17,7 @@ # FAQ ADD_CUSTOM_COMMAND( OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_faq.de.html - COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toc_title='Inhaltsverzeichnis' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_faq.de.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_faq.de.txt + COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toc-title='Inhaltsverzeichnis' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_faq.de.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_faq.de.txt DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/weechat_faq.de.txt COMMENT "Building weechat_faq.de.html" @@ -28,7 +28,7 @@ INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_faq.de.html DESTINATION ${SHAR # quickstart ADD_CUSTOM_COMMAND( OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.de.html - COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toc_title='Inhaltsverzeichnis' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.de.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_quickstart.de.txt + COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toc-title='Inhaltsverzeichnis' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.de.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_quickstart.de.txt DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/weechat_quickstart.de.txt COMMENT "Building weechat_quickstart.de.html" @@ -39,7 +39,7 @@ INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.de.html DESTINATION # tester's guide ADD_CUSTOM_COMMAND( OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.de.html - COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toc_title='Inhaltsverzeichnis' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.de.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_tester.de.txt + COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toc-title='Inhaltsverzeichnis' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.de.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_tester.de.txt DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/weechat_tester.de.txt COMMENT "Building weechat_tester.de.html" diff --git a/doc/de/Makefile.am b/doc/de/Makefile.am index 07a164ef3..829784245 100644 --- a/doc/de/Makefile.am +++ b/doc/de/Makefile.am @@ -27,15 +27,15 @@ all-local: weechat_faq.de.html \ # FAQ weechat_faq.de.html: weechat_faq.de.txt - $(ASCIIDOC) -a toc -a toc_title='Inhaltsverzeichnis' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_faq.de.html weechat_faq.de.txt + $(ASCIIDOC) -a toc -a toc-title='Inhaltsverzeichnis' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_faq.de.html weechat_faq.de.txt # quickstart weechat_quickstart.de.html: weechat_quickstart.de.txt - $(ASCIIDOC) -a toc -a toc_title='Inhaltsverzeichnis' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_quickstart.de.html weechat_quickstart.de.txt + $(ASCIIDOC) -a toc -a toc-title='Inhaltsverzeichnis' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_quickstart.de.html weechat_quickstart.de.txt # tester's guide weechat_tester.de.html: weechat_tester.de.txt - $(ASCIIDOC) -a toc -a toc_title='Inhaltsverzeichnis' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_tester.de.html weechat_tester.de.txt + $(ASCIIDOC) -a toc -a toc-title='Inhaltsverzeichnis' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_tester.de.html weechat_tester.de.txt # install docs diff --git a/doc/fr/CMakeLists.txt b/doc/fr/CMakeLists.txt index 17e887372..f78d66988 100644 --- a/doc/fr/CMakeLists.txt +++ b/doc/fr/CMakeLists.txt @@ -17,7 +17,7 @@ # user's guide ADD_CUSTOM_COMMAND( OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_user.fr.html - COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toclevels=3 -a toc_title='Table des matières' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_user.fr.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_user.fr.txt + COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toclevels=3 -a toc-title='Table des matières' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_user.fr.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_user.fr.txt DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/weechat_user.fr.txt ${CMAKE_CURRENT_SOURCE_DIR}/autogen/user/*.txt @@ -29,7 +29,7 @@ INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_user.fr.html DESTINATION ${SHA # plugin API reference ADD_CUSTOM_COMMAND( OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_plugin_api.fr.html - COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toclevels=3 -a toc_title='Table des matières' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_plugin_api.fr.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_plugin_api.fr.txt + COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toclevels=3 -a toc-title='Table des matières' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_plugin_api.fr.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_plugin_api.fr.txt DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/weechat_plugin_api.fr.txt ${CMAKE_CURRENT_SOURCE_DIR}/autogen/plugin_api/*.txt @@ -52,7 +52,7 @@ INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_scripting.fr.html DESTINATION # FAQ ADD_CUSTOM_COMMAND( OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_faq.fr.html - COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toc_title='Table des matières' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_faq.fr.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_faq.fr.txt + COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toc-title='Table des matières' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_faq.fr.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_faq.fr.txt DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/weechat_faq.fr.txt COMMENT "Building weechat_faq.fr.html" @@ -63,7 +63,7 @@ INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_faq.fr.html DESTINATION ${SHAR # quickstart ADD_CUSTOM_COMMAND( OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.fr.html - COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toc_title='Table des matières' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.fr.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_quickstart.fr.txt + COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toc-title='Table des matières' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.fr.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_quickstart.fr.txt DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/weechat_quickstart.fr.txt COMMENT "Building weechat_quickstart.fr.html" @@ -74,7 +74,7 @@ INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.fr.html DESTINATION # tester's guide ADD_CUSTOM_COMMAND( OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.fr.html - COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toc_title='Table des matières' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.fr.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_tester.fr.txt + COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toc-title='Table des matières' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.fr.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_tester.fr.txt DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/weechat_tester.fr.txt COMMENT "Building weechat_tester.fr.html" diff --git a/doc/fr/Makefile.am b/doc/fr/Makefile.am index 2a8087296..92dbfb334 100644 --- a/doc/fr/Makefile.am +++ b/doc/fr/Makefile.am @@ -35,27 +35,27 @@ all-local: weechat_user.fr.html \ # user's guide weechat_user.fr.html: weechat_user.fr.txt $(wildcard autogen/user/*.txt) - $(ASCIIDOC) -a toc -a toclevels=3 -a toc_title='Table des matières' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_user.fr.html weechat_user.fr.txt + $(ASCIIDOC) -a toc -a toclevels=3 -a toc-title='Table des matières' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_user.fr.html weechat_user.fr.txt # plugin API reference weechat_plugin_api.fr.html: weechat_plugin_api.fr.txt $(wildcard autogen/plugin_api/*.txt) - $(ASCIIDOC) -a toc -a toclevels=3 -a toc_title='Table des matières' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_plugin_api.fr.html weechat_plugin_api.fr.txt + $(ASCIIDOC) -a toc -a toclevels=3 -a toc-title='Table des matières' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_plugin_api.fr.html weechat_plugin_api.fr.txt # scripting guide weechat_scripting.fr.html: weechat_scripting.fr.txt - $(ASCIIDOC) -a toc -a toclevels=3 -a toc_title='Table des matières' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_scripting.fr.html weechat_scripting.fr.txt + $(ASCIIDOC) -a toc -a toclevels=3 -a toc-title='Table des matières' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_scripting.fr.html weechat_scripting.fr.txt # FAQ weechat_faq.fr.html: weechat_faq.fr.txt - $(ASCIIDOC) -a toc -a toc_title='Table des matières' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_faq.fr.html weechat_faq.fr.txt + $(ASCIIDOC) -a toc -a toc-title='Table des matières' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_faq.fr.html weechat_faq.fr.txt # quickstart weechat_quickstart.fr.html: weechat_quickstart.fr.txt - $(ASCIIDOC) -a toc -a toc_title='Table des matières' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_quickstart.fr.html weechat_quickstart.fr.txt + $(ASCIIDOC) -a toc -a toc-title='Table des matières' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_quickstart.fr.html weechat_quickstart.fr.txt # tester's guide weechat_tester.fr.html: weechat_tester.fr.txt - $(ASCIIDOC) -a toc -a toc_title='Table des matières' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_tester.fr.html weechat_tester.fr.txt + $(ASCIIDOC) -a toc -a toc-title='Table des matières' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_tester.fr.html weechat_tester.fr.txt # install docs diff --git a/doc/it/CMakeLists.txt b/doc/it/CMakeLists.txt new file mode 100644 index 000000000..14c7d3e33 --- /dev/null +++ b/doc/it/CMakeLists.txt @@ -0,0 +1,37 @@ +# Copyright (c) 2003-2009 FlashCode +# +# This program is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 3 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . +# + +# quickstart +ADD_CUSTOM_COMMAND( + OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.it.html + COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toc-title='Indice' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.it.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_quickstart.it.txt + DEPENDS + ${CMAKE_CURRENT_SOURCE_DIR}/weechat_quickstart.it.txt + COMMENT "Building weechat_quickstart.it.html" +) +ADD_CUSTOM_TARGET(doc-quickstart-it ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.it.html) +INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.it.html DESTINATION ${SHAREDIR}/doc/${PROJECT_NAME}) + +# tester's guide +ADD_CUSTOM_COMMAND( + OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.it.html + COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toc-title='Indice' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.it.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_tester.it.txt + DEPENDS + ${CMAKE_CURRENT_SOURCE_DIR}/weechat_tester.it.txt + COMMENT "Building weechat_tester.it.html" +) +ADD_CUSTOM_TARGET(doc-tester-it ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.it.html) +INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.it.html DESTINATION ${SHAREDIR}/doc/${PROJECT_NAME}) diff --git a/doc/it/Makefile.am b/doc/it/Makefile.am new file mode 100644 index 000000000..0dcb01507 --- /dev/null +++ b/doc/it/Makefile.am @@ -0,0 +1,43 @@ +# Copyright (c) 2003-2009 FlashCode +# +# This program is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 3 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . +# + +docdir = $(datadir)/doc/$(PACKAGE) + +EXTRA_DIST = CMakeLists.txt \ + weechat_quickstart.it.txt \ + weechat_tester.it.txt + +all-local: weechat_quickstart.it.html \ + weechat_tester.it.html + +# quickstart +weechat_quickstart.it.html: weechat_quickstart.it.txt + $(ASCIIDOC) -a toc -a toc_title='Indice' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_quickstart.it.html weechat_quickstart.it.txt + +# tester's guide +weechat_tester.it.html: weechat_tester.it.txt + $(ASCIIDOC) -a toc -a toc_title='Indice' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_tester.it.html weechat_tester.it.txt + +# install docs + +install-data-hook: + $(mkinstalldirs) $(DESTDIR)$(docdir)/ + $(INSTALL_DATA) *.html $(DESTDIR)$(docdir)/ + +# clean + +clean-local: + -rm -f *.html diff --git a/doc/it/weechat_quickstart.it.txt b/doc/it/weechat_quickstart.it.txt new file mode 100644 index 000000000..f80571478 --- /dev/null +++ b/doc/it/weechat_quickstart.it.txt @@ -0,0 +1,262 @@ +Guida Rapida a WeeChat +====================== +FlashCode + + +[[start]] +Avvio di WeeChat +---------------- + +Un emulatore di terminale raccomandato per X (ma non obbligatorio) è +rxvt-unicode (ha un buon supporto per UTF-8, e nessun problema con +le scorciatoie da tastiera predefinite). + +Avviare "weechat-curses" dalla propria shell. + + +[[help_options]] +Aiuto online / opzioni +---------------------- + +WeeChat offre aiuto per tutti i comandi, basta digitare /help +Per ricevere aiuto su un comando specifico, digitare `/help +comando` + +Per impostare le opzioni, utilizzare `/set config.sezione.opzione valore` +(dove `config` è il nome della configurazione (`weechat` per il core, +oppure un nome plugin), `sezione` la sezione di questa configurazione +e `opzione` il nome dell'opzione). + +WeeChat utilizza subito il nuovo valore (non c'è *mai* bisogno di riavviare +WeeChat dopo aver cambiato la configurazione). + +È possibile utilizzare l'opzione `/set` con un nome parziale e il carattere jolly "*" +all'inizio o alla fine per visualizzare tutte le opzioni contenenti le lettere. +Per esempio: + +`/set`:: + visualizza tutte le opzioni (WeeChat e plugin) + +`/set weechat.*`:: + visualizza le opzioni di WeeChat + +`/set irc.*`:: + visualizza le opzioni del plugin IRC + +È possibile visualizzare l'aiuto per ogni opzione con `/help`, per esempio: +`/help weechat.look.highlight`. + +Tutte le impostazioni vengono salvato all'uscita di WeeChat (o con il comando +`/save` per forzare il salvataggio di una o più opzioni). + +Si possono modificare manualmente i file di configurazione (*.conf) e +ricaricarli con il comando `/reload` se non si vuole usare il comando `/set`. + + +[[core_vs_plugins]] +Core vs plugin +-------------- + +Il "core" di WeeChat è utilizzato solo per visualizzare i dati sullo schermo +e interagire con l'utente; ciò vuol dire che il core di weechat senza i +plugin è inutile (utenti più fedeli: IRC faceva parte del core per le +versioni < = 0.2.6). + +Tutti i protocolli di rete come IRC sono forniti in plugin separati. + +Utilizzando il comando `plugin` per elencare i plugin caricati, è possibile +vedere "irc" ed altri plugin nella lista. + + +[[create_irc_server]] +Creare un server IRC +-------------------- + +Si può aggiungere un server IRC con il comando `/server`, per esempio: + + /server add oftc irc.oftc.org/6667 + +Come al solito, è disponibile l'aiuto se c'è qualche problema: `/help server`. + + +[[irc_server_options]] +Impostare opzioni personalizzate per il server IRC +-------------------------------------------------- + +WeeChat usa valori predefiniti per tutti i server, se non si specifica un +valore preciso per un'opzione del server. Questi valori predefiniti sono +"irc.server_default.*" + +Per ogni opzione del server, WeeChat usa il proprio valore se definito +(non "nullo"). Altrimenti si utilizza il valore predefinito +("irc.server_default.xxx"). + +Per esempio ci sono dei nick predefiniti (basati sul proprio login un*x), ed +è possibile sovrascriverli per il server oftc con il seguente comando: + + /set irc.server.oftc.nicks "mynick1,mynick2,mynick3,mynick4,mynick5" + +Per impostare il nome utente ed il nome reale: + + /set irc.server.oftc.username "Mio nome utente" + /set irc.server.oftc.realname "Mio nome reale" + +Per impostare la connessione automatica al server all'avvio: + + /set irc.server.oftc.autoconnect on + +Per eseguire un comando dopo la connessione al server, ad esempio +per identificarsi con nickserv: + + /set irc.server.oftc.command "/msg nickserv identify xxxxxx" + +Nota: più comandi possono essere separati da ';' (punto e virgola) + +Per entrare automaticamente in alcuni canali quando ci si connette +al server: + + /set irc.server.oftc.autojoin "#canale1,#canale2" + +Per eliminare il valore di un'opzione del server, e usare invece il valore +predefinito, per esempio per utilizzare i nick predefiniti +(irc.server_default.nicks): + + /set irc.server.oftc.nicks null + +Altre opzioni: è possibile impostare altre opzioni con il seguente comando +("xxx" è il nome dell'opzione): + + /set irc.server.oftc.xxx value + + +[[connect_to_irc_server]] +Connessione al server IRC e ingresso automatico nei canali +---------------------------------------------------------- + + /connect oftc + +[NOTE] +Questo comando può essere usato per creare e connettersi ad un nuovo server +senza utilizzare il comando `/server` (è necessario ripetere che è possibile +visualizzare l'aiuto per questo comando con `/help connect`?). + +I buffer dei server vengono uniti al buffer 'core' di WeeChat in modo +predefinito. Per passare tra buffer 'core' e buffer server, si può digitare +Ctrl-X. + +È possibile disabilitare l'unione automatica dei server dei buffer per avere i +buffer dei server indipendenti: + + /set irc.look.server_buffer independent + + +[[join_part_irc_channels]] +Entrare/uscire dai canali IRC +----------------------------- + +`/join #canale`:: + entra in un canale + +`/part [messaggio di uscita]`:: + esce da un canale (mantenendo il buffer aperto) + +`/close [messaggio di uscita]`:: + chiude il buffer del server o del canale (`/close è un alias per `/buffer + close`) + + +[[buffer_window]] +Gestione buffer/finestra +------------------------ + +Un buffer è un componente collegato ad un plugin con un numero, +una categoria e un nome. Un buffer contiene i dati visualizzati sullo +schermo. + +Una finestra è la vista di un buffer. Il comportamento predefinito +prevede solo una finestra che visualizza un buffer. Se lo schermo +viene diviso, sarà possibile vedere più finestre con molti buffer allo +stesso tempo. + +I comandi per gestire buffer e finestre: + + /buffer + /window + +(Qui non si ripeterà che è possibile avere aiuto su questi comandi con /help) + +Per esempio, per dividere verticalmente lo schermo in una finestra piccola +(1/3 della larghezza) ed una grande (2/3), utilizzare il comando: + + /window splitv 33 + + +[[key_bindings]] +Associazione tasti +------------------ + +WeeChat usa molti tasti. Essi sono tutti presenti nella documentazione, +ma si dovrebbero conoscere almeno quelli vitali: + +- 'alt + freccia sinistra/destra' (oppure 'F5/F6'): passa al buffer +precedente/successivo +- 'F7/F8': passa alla finestra precedente/successiva (quando lo schermo +è diviso) +- 'F9/F10': scorre la barra del titolo +- 'F11/F12': scorre la lista nick +- 'tab': completa il testo nella barra di input, proprio come nella shell +- 'pagina su/giù': scorre testo nel buffer corrente +- 'alt + A': passa al buffer con attività (nella hotlist) + +A seconda della propria tastiera e/o le proprie necessità, è possibile +associare nuovamente qualsiasi tasto ad un comando tramite +`/key`. +Un tasto utile è meta-k (alt-k) per trovare i codici tasti. + +Ad esempio, per associare meta-y (alt-y) al comando `/buffer close`: + + /key bind (digitare meta-k) (digitare meta-y) /buffer close + +Si otterrà una riga di comando simile a: + + /key bind meta-y /buffer close + +Per eliminare il tasto: + + /key unbind meta-y + + +[[plugins_scripts]] +Plugin/script +------------- + +Su alcune distribuzioni come Debian, i plugin sono disponibili tramite un +pacchetto separato (come weechat-plugins). +I plugin vengono caricati automaticamente quando trovati +(per favore consultare la documentazione per attivare/disattivare plugin +o script). + +Alcuni plugin consentono di usare gli script in WeeChat (in molti linguaggi +come Perl, Python, Ruby, Lua e Tcl). Questi plugin devono essere +caricati con il comando `/plugin` e forniscono comandi come `/perl`, +utilizzati per caricare gli script. + +Sono disponibili molti plugin/script esterni (dai contributori) per +WeeChat: http://www.weechat.org/plugins + +Il modo più facile per installare gli script è utilizzare 'weeget.py': + +. scaricare e copiare 'weeget.py' in ~/.weechat/python/autoload/ +. caricare lo script: `/python autoload` +. elenco degli script: `/weeget list` (per aiuto: `/help weeget`) + + +[[more_doc]] +Ulteriore documentazione +------------------------ + +È ora possibilie usare WeeChat e leggere FAQ/documentazione per ogni altra +domanda: +http://www.weechat.org/doc + +Buon WeeChat! diff --git a/doc/it/weechat_tester.it.txt b/doc/it/weechat_tester.it.txt new file mode 100644 index 000000000..f2f0639a6 --- /dev/null +++ b/doc/it/weechat_tester.it.txt @@ -0,0 +1,146 @@ +Guida al Tester di WeeChat +========================== +FlashCode + + +[[purpose]] +Scopo +----- + +Molti utenti riconoscenti chiedono come possono aiutare nello sviluppo +di WeeChat. Il modo più semplice (ed anche più delicato) per aiutare +lo sviluppo di WeeChat è il testing! + +Il testing è una parte davvero importante dello sviluppo software e non +può essere sottovalutato. Quando vengono implementate alcune +funzionalità dovrebbero essere testate, ma per alcune di esse esistono +troppi casi di utilizzo o questi casi sono delicati e gli sviluppatori non +possono verificarli uno ad uno. + +Per esempio: È stato introdotto un famigerato set di caratteri in WeeChat 0.2.2: +nessuno di noi (sviluppatori, contributori e tester) utilizzava canali con lettere +dell'alfabeto nazionale nei loro nomi e quando è stata rilasciata la 0.2.2 siamo +stati inondati dagli utenti russi. Se avessimo più tester non dovrebbe più +accadere in futuro. + +Testare la versione stabile di WeeChat è inutile poiché gli sviluppatori sono +occupati nell'implementazione di nuove funzionalità (e nella correzione di +vecchi bug). + + +[[prepare_system]] +Preparazione del sistema +------------------------ + +Sarebbe molto di aiuto abilitare i file 'core' di Linux: se WeeChat +dovesse andare in crash, Linux scriverebbe un file chiamato 'core'. +Questo file contiene informazioni di debug molto utili, per sapere +esattamente dove sia il problema in WeeChat. + +Se si utilizza la shell 'bash', aggiungere la seguente riga al file `~/.bashrc`: + + ulimit -c unlimited + + +[[download]] +Download della versione di sviluppo +----------------------------------- + +Il codice più fresco (con gli ultimi bug e le funzionalità più recenti) è +conservato in un deposito GIT. + +È possibile compilarlo manualmente (raccomandato): + +* La versione GIT può essere compilata ed installata parallelamente alla +* versione stabile, non è necessario l'accesso da root né sacrificare la + versione stabile di WeeChat. + +[[get_sources]] +Ottenere e compilare i sorgenti +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Per prima cosa creare una cartella, per esempio 'weechat-git': + +--------------------- +$ mkdir ~/weechat-git +$ cd ~/weechat-git +--------------------- + +Se si ha git installato, si può clonare il deposito git (raccomandato): + +-------------------------------------------- +$ git clone git://git.sv.gnu.org/weechat.git +$ cd weechat +-------------------------------------------- + +NOTA: In seguito, si può eseguire "`git pull`" in questa cartella per +ricevere gli ultimi aggiornamenti. + +Altrimenti si può scaricare ed estrarre il pacchetto 'devel': + +----------------------------------------------------------------- +$ wget http://www.weechat.org/files/src/weechat-devel.tar.bz2 +$ tar xvjf weechat-devel.tar.bz2 +$ cd weechat-devel +----------------------------------------------------------------- + +Per compilare i sorgenti, si raccomanda cmake: + +-------------------------------------------------------------- +$ mkdir build +$ cd build +$ cmake .. -DPREFIX=$HOME/weechat-git -DCMAKE_BUILD_TYPE=Debug +$ make +$ make install +-------------------------------------------------------------- + +Se cmake non è installato, è ancora possibile usare gli autotools: + +---------------------------------------------------------- +$ ./autogen.sh # (solo se clonato il deposito git) +$ ./configure --prefix=$HOME/weechat-git +$ make +$ make install +---------------------------------------------------------- + +[[install_binary_package]] +Installazione del pacchetto binario +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +A seconda della distribuzione Linux: + +* Debian: http://debian.flashtux.org/ +* Gentoo: http://www.weechat.org/download +* ArchLinux: PKGBUILD da http://aur.archlinux.org/ +* altro: non lo sappiamo! Eheh. + + +[[run]] +Eseguire WeeChat +---------------- + +Si raccomanda di avviare WeeChat con un'altra cartella (diversa dalla versione +stabile), con l'opzione `--dir`. + +Il comando è: + + ~/weechat-git/bin/weechat-curses --dir ~/.weechat-dev + +Se siete ancora svegli dovreste vedere un'interfaccia familiare e vantarvi del +fatto di avere la versione più nuova possibile di WeeChat. ;) + +Se si dovessero verificare strani comportamenti (potrebbe andare in crash +o far bollire la vostra birra) non esitate ad entrare in `#weechat` su +`irc.freenode.net` e farcelo sapere. + +Se non dovesse andare in crash - ditelo comunque, abbiamo bisogno dei vostri +commenti! + + +[[links]] +Collegamenti utili +------------------ + +* Deposito GIT: http://git.savannah.gnu.org/gitweb/?p=weechat.git +* Bug tracker: https://savannah.nongnu.org/bugs/?group=weechat +* Feed RSS dei commit di WeeChat: http://git.savannah.gnu.org/gitweb/?p=weechat.git;a=rss diff --git a/doc/ja/CMakeLists.txt b/doc/ja/CMakeLists.txt index 4975fc9bb..399a6d48c 100644 --- a/doc/ja/CMakeLists.txt +++ b/doc/ja/CMakeLists.txt @@ -17,7 +17,7 @@ # quickstart ADD_CUSTOM_COMMAND( OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.ja.html - COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toc_title='目次' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.ja.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_quickstart.ja.txt + COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toc-title='目次' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.ja.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_quickstart.ja.txt DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/weechat_quickstart.ja.txt COMMENT "Building weechat_quickstart.ja.html" diff --git a/doc/ja/Makefile.am b/doc/ja/Makefile.am index b4dd80377..32e730add 100644 --- a/doc/ja/Makefile.am +++ b/doc/ja/Makefile.am @@ -23,7 +23,7 @@ all-local: weechat_quickstart.ja.html # quickstart weechat_quickstart.ja.html: weechat_quickstart.ja.txt - $(ASCIIDOC) -a toc -a toc_title='目次' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_quickstart.ja.html weechat_quickstart.ja.txt + $(ASCIIDOC) -a toc -a toc-title='目次' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_quickstart.ja.html weechat_quickstart.ja.txt # install docs diff --git a/doc/pl/CMakeLists.txt b/doc/pl/CMakeLists.txt index 6e0791f7a..ce201d84d 100644 --- a/doc/pl/CMakeLists.txt +++ b/doc/pl/CMakeLists.txt @@ -17,7 +17,7 @@ # FAQ ADD_CUSTOM_COMMAND( OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_faq.pl.html - COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toc_title='Spis treści' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_faq.pl.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_faq.pl.txt + COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toc-title='Spis treści' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_faq.pl.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_faq.pl.txt DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/weechat_faq.pl.txt COMMENT "Building weechat_faq.pl.html" @@ -28,7 +28,7 @@ INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_faq.pl.html DESTINATION ${SHAR # quickstart ADD_CUSTOM_COMMAND( OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.pl.html - COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toc_title='Spis treści' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.pl.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_quickstart.pl.txt + COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toc-title='Spis treści' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.pl.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_quickstart.pl.txt DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/weechat_quickstart.pl.txt COMMENT "Building weechat_quickstart.pl.html" @@ -39,7 +39,7 @@ INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.pl.html DESTINATION # tester's guide ADD_CUSTOM_COMMAND( OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.pl.html - COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toc_title='Spis treści' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.pl.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_tester.pl.txt + COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toc-title='Spis treści' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.pl.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_tester.pl.txt DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/weechat_tester.pl.txt COMMENT "Building weechat_tester.pl.html" diff --git a/doc/pl/Makefile.am b/doc/pl/Makefile.am index ef4d296b9..5eaea56f3 100644 --- a/doc/pl/Makefile.am +++ b/doc/pl/Makefile.am @@ -27,15 +27,15 @@ all-local: weechat_faq.pl.html \ # FAQ weechat_faq.pl.html: weechat_faq.pl.txt - $(ASCIIDOC) -a toc -a toc_title='Spis treści' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_faq.pl.html weechat_faq.pl.txt + $(ASCIIDOC) -a toc -a toc-title='Spis treści' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_faq.pl.html weechat_faq.pl.txt # quickstart weechat_quickstart.pl.html: weechat_quickstart.pl.txt - $(ASCIIDOC) -a toc -a toc_title='Spis treści' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_quickstart.pl.html weechat_quickstart.pl.txt + $(ASCIIDOC) -a toc -a toc-title='Spis treści' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_quickstart.pl.html weechat_quickstart.pl.txt # tester's guide weechat_tester.pl.html: weechat_tester.pl.txt - $(ASCIIDOC) -a toc -a toc_title='Spis treści' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_tester.pl.html weechat_tester.pl.txt + $(ASCIIDOC) -a toc -a toc-title='Spis treści' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_tester.pl.html weechat_tester.pl.txt # install docs diff --git a/doc/ru/CMakeLists.txt b/doc/ru/CMakeLists.txt index fac1ff8cb..bc65e7e1c 100644 --- a/doc/ru/CMakeLists.txt +++ b/doc/ru/CMakeLists.txt @@ -17,7 +17,7 @@ # quickstart ADD_CUSTOM_COMMAND( OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.ru.html - COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toc_title='Содержание' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.ru.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_quickstart.ru.txt + COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toc-title='Содержание' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.ru.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_quickstart.ru.txt DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/weechat_quickstart.ru.txt COMMENT "Building weechat_quickstart.ru.html" diff --git a/doc/ru/Makefile.am b/doc/ru/Makefile.am index a8de2e377..bb227e638 100644 --- a/doc/ru/Makefile.am +++ b/doc/ru/Makefile.am @@ -23,7 +23,7 @@ all-local: weechat_quickstart.ru.html # quickstart weechat_quickstart.ru.html: weechat_quickstart.ru.txt - $(ASCIIDOC) -a toc -a toc_title='Содержание' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_quickstart.ru.html weechat_quickstart.ru.txt + $(ASCIIDOC) -a toc -a toc-title='Содержание' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_quickstart.ru.html weechat_quickstart.ru.txt # install docs diff --git a/po/de.po b/po/de.po index 6077d01e7..db81c3983 100644 --- a/po/de.po +++ b/po/de.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: WeeChat 0.3.1-dev\n" "Report-Msgid-Bugs-To: flashcode@flashtux.org\n" -"POT-Creation-Date: 2009-11-17 12:24+0100\n" +"POT-Creation-Date: 2009-11-07 13:09+0100\n" "PO-Revision-Date: 2009-11-17 00:01+0100\n" "Last-Translator: Nils G \n" "Language-Team: weechat-dev \n" @@ -4892,6 +4892,7 @@ msgstr "Protokollieren der Buffer:" msgid "logging (level: %d)" msgstr "Protokolliere (Level: %d)" +#, c-format msgid "not logging" msgstr "nicht protokolliert" diff --git a/po/it.po b/po/it.po index 4fbe8f3ff..b84bb5625 100644 --- a/po/it.po +++ b/po/it.po @@ -9,7 +9,7 @@ msgstr "" "Project-Id-Version: Weechat 0.31-dev\n" "Report-Msgid-Bugs-To: flashcode@flashtux.org\n" "POT-Creation-Date: 2009-11-07 13:09+0100\n" -"PO-Revision-Date: 2009-11-18 15:30+0100\n" +"PO-Revision-Date: 2009-11-18 21:26+0100\n" "Last-Translator: Marco Paolone \n" "Language-Team: weechat-dev \n" "MIME-Version: 1.0\n" @@ -2735,8 +2735,7 @@ msgstr "" #, c-format msgid "" "%s%s: disconnected from %d %s (SSL connection not supported with upgrade)" -msgstr "" -"%s%s: disconnesso da %s %d (connessione SSL non supportata con l'upgrade)" +msgstr "%s%s: disconnesso da %d %s (connessione SSL non supportata con l'upgrade)" #, c-format msgid "%s%s: error with server from URL (\"%s\"), ignored"