Add italian docs: quickstart and tester

v2.8-utf8proc
Sebastien Helleu 2009-11-18 21:36:21 +01:00
parent b42cf691ae
commit 3c7c99b1b5
18 changed files with 521 additions and 31 deletions

View File

@ -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

View File

@ -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)

View File

@ -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"

View File

@ -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

View File

@ -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"

View File

@ -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

37
doc/it/CMakeLists.txt Normal file
View File

@ -0,0 +1,37 @@
# Copyright (c) 2003-2009 FlashCode <flashcode@flashtux.org>
#
# 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 <http://www.gnu.org/licenses/>.
#
# 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})

43
doc/it/Makefile.am Normal file
View File

@ -0,0 +1,43 @@
# Copyright (c) 2003-2009 FlashCode <flashcode@flashtux.org>
#
# 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 <http://www.gnu.org/licenses/>.
#
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

View File

@ -0,0 +1,262 @@
Guida Rapida a WeeChat
======================
FlashCode <flashcode@flashtux.org>
[[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!

View File

@ -0,0 +1,146 @@
Guida al Tester di WeeChat
==========================
FlashCode <flashcode@flashtux.org>
[[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

View File

@ -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"

View File

@ -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

View File

@ -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"

View File

@ -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

View File

@ -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"

View File

@ -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

View File

@ -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 <weechatter@arcor.de>\n"
"Language-Team: weechat-dev <weechat-dev@nongnu.org>\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"

View File

@ -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 <marcopaolone@gmail.com>\n"
"Language-Team: weechat-dev <weechat-dev@nongnu.org>\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"