diff options
Diffstat (limited to 'docs/ita/user')
-rw-r--r-- | docs/ita/user/android.rst | 107 | ||||
-rw-r--r-- | docs/ita/user/articles.rst | 115 | ||||
-rw-r--r-- | docs/ita/user/backup.rst | 30 | ||||
-rw-r--r-- | docs/ita/user/configuration.rst | 104 | ||||
-rw-r--r-- | docs/ita/user/configuring_mobile.rst | 13 | ||||
-rw-r--r-- | docs/ita/user/create_account.rst | 38 | ||||
-rw-r--r-- | docs/ita/user/errors_during_fetching.rst | 37 | ||||
-rw-r--r-- | docs/ita/user/faq.rst | 53 | ||||
-rw-r--r-- | docs/ita/user/filters.rst | 45 | ||||
-rw-r--r-- | docs/ita/user/import.rst | 115 | ||||
-rw-r--r-- | docs/ita/user/installation.rst | 333 | ||||
-rw-r--r-- | docs/ita/user/parameters.rst | 93 | ||||
-rw-r--r-- | docs/ita/user/upgrade.rst | 102 |
13 files changed, 1185 insertions, 0 deletions
diff --git a/docs/ita/user/android.rst b/docs/ita/user/android.rst new file mode 100644 index 00000000..a82bbef5 --- /dev/null +++ b/docs/ita/user/android.rst | |||
@@ -0,0 +1,107 @@ | |||
1 | Applicazione Android | ||
2 | ==================== | ||
3 | |||
4 | Scopo di questo documento | ||
5 | ------------------------- | ||
6 | |||
7 | Questo documento spiega come configurare la vostra applicazione Android in modo che funzioni con la vostra istanza di wallabag. Non vi é differenza in questa procedura sia per wallabag v1 che per v2. | ||
8 | |||
9 | Passi per configurare la vostra app | ||
10 | ----------------------------------- | ||
11 | |||
12 | Quando aprirete l'app per la prima volta, vedrete una schermata di benvenuto dove vi si consiglia per prima cosa di configurare l'app per la vostra istanza di wallabag. | ||
13 | |||
14 | .. image:: ../../img/user/android_welcome_screen.en.png | ||
15 | :alt: Welcome screen | ||
16 | :align: center | ||
17 | |||
18 | Confermate semplicemente quel messaggio e verrete reindirizzati alla schermata delle impostazioni. | ||
19 | |||
20 | .. image:: ../../img/user/android_configuration_screen.en.png | ||
21 | :alt: Settings screen | ||
22 | :align: center | ||
23 | |||
24 | Inserite i vostri dati di wallabag. Dovrete inserire il vostro indirizzo di wallabag. **É importante che questo URL non finisca con una barra**. Inserite anche le vostre credenziali nei campi user name e password. | ||
25 | |||
26 | .. image:: ../../img/user/android_configuration_filled_in.en.png | ||
27 | :alt: Filled in settings | ||
28 | :align: center | ||
29 | |||
30 | Dopo aver completato l'inserimento dei dati, premete il bottone Connection test e aspettate che il test finisca. | ||
31 | |||
32 | .. image:: ../../img/user/android_configuration_connection_test.en.png | ||
33 | :alt: Connection test with your wallabag data | ||
34 | :align: center | ||
35 | |||
36 | Il test di connessione dovrebbe finire con successo. In caso contrario, dovrete prima risolvere questo problema fino a che possiate procedere. | ||
37 | |||
38 | .. image:: ../../img/user/android_configuration_connection_test_success.en.png | ||
39 | :alt: Connection test successful | ||
40 | :align: center | ||
41 | |||
42 | Dopo che il test sará avvenuto con successo, potrete premere il bottone per ottenere le credenziali del vostro feed. L'app cercherá di connettersi alla vostra istanza di wallabag e ottenere l'id utente e il token corrispondente per i feed. | ||
43 | |||
44 | .. image:: ../../img/user/android_configuration_get_feed_credentials.en.png | ||
45 | :alt: Getting the feed credentials | ||
46 | :align: center | ||
47 | |||
48 | Quando il processo di ottenimento delle credenziali del vostro feed sará concluso con successo, vedrete un messaggio toast, il quale avviserá che l'id utente ed il token sono stati inseriti nel modulo. | ||
49 | |||
50 | .. image:: ../../img/user/android_configuration_feed_credentials_automatically_filled_in.en.png | ||
51 | :alt: Getting feed credentials successful | ||
52 | :align: center | ||
53 | |||
54 | Ora dovrete scorrere fino alla fine del menu delle impostazioni. Ovviamente potrete cambiare le impostazioni in base alle vostre preferenze. | ||
55 | Terminate la configurazione della vostra app premendo il bottone per il salvataggio. | ||
56 | |||
57 | .. image:: ../../img/user/android_configuration_scroll_bottom.en.png | ||
58 | :alt: Bottom of the settings screen | ||
59 | :align: center | ||
60 | |||
61 | Dopo aver premuto il bottone apparirá la seguente schermata. L'app proporrá di iniziare il processo di sincronizzazione per aggiornare i vostri feed ed articoli. É raccomandato accettare quest'azione e premere Sí. | ||
62 | |||
63 | .. image:: ../../img/user/android_configuration_saved_feed_update.en.png | ||
64 | :alt: Settings saved the first time | ||
65 | :align: center | ||
66 | |||
67 | Alla fine, dopo che la sincronizzazione sará avvenuta con successo, apparirá la lista degli articoli non letti. | ||
68 | |||
69 | .. image:: ../../img/user/android_unread_feed_synced.en.png | ||
70 | :alt: Filled article list cause feeds successfully synchronized | ||
71 | :align: center | ||
72 | |||
73 | Limiti conosciuti | ||
74 | ----------------- | ||
75 | |||
76 | Autenticazione a due fattori (2FA) | ||
77 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
78 | |||
79 | Attualmente l'applicazione Android non supporta l'autenticazione a due fattori. Dovreste disabilitare questa opzione in modo da far funzionare l'applicazione. | ||
80 | |||
81 | Quantitá limitata di articoli con wallabag v2 | ||
82 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
83 | |||
84 | Nella vostra istanza web di wallabag potete configurare quanti oggetti sono parte del feed RSS. Questa opzione non esisteva in wallabag v1, dove tutti gli articoli erano parte del feed. Quindi se imposterete il numero di articoli da visualizzare maggiore del numero di oggetti che sono contenuti nel vostro feed RSS, vedrete solamente il numero di oggetti nel vostro feed RSS. | ||
85 | |||
86 | Crittografia SSL/TLS | ||
87 | ~~~~~~~~~~~~~~~~~~~~ | ||
88 | |||
89 | Se potete raggiungere la vostra istanza web di wallabag via HTTPS, dovreste usare quest'ultimo, in particolar modo se il vostro URL HTTP vi reindirizza a quello HTTPS. Attualmente l'app non puó gestire propriamente il reindirizzamento. | ||
90 | |||
91 | Riferimenti | ||
92 | ----------- | ||
93 | |||
94 | - `Codice sorgente dell'applicazione Android <https://github.com/wallabag/android-app>`_ | ||
95 | - `Applicazione Android su F-Droid <https://f-droid.org/repository/browse/?fdfilter=wallabag&fdid=fr.gaulupeau.apps.InThePoche>`_ | ||
96 | - `Applicazione Android su Google Play <https://play.google.com/store/apps/details?id=fr.gaulupeau.apps.InThePoche>`_ | ||
97 | |||
98 | |||
99 | |||
100 | |||
101 | |||
102 | |||
103 | |||
104 | |||
105 | |||
106 | |||
107 | |||
diff --git a/docs/ita/user/articles.rst b/docs/ita/user/articles.rst new file mode 100644 index 00000000..944b23ef --- /dev/null +++ b/docs/ita/user/articles.rst | |||
@@ -0,0 +1,115 @@ | |||
1 | |||
2 | Articoli | ||
3 | ======== | ||
4 | |||
5 | Salvate il vostro primo articolo | ||
6 | -------------------------------- | ||
7 | |||
8 | Il proposito principale di wallabag é di salvare articoli web, e potete farlo in molti modi. Se pensate che l'articolo sia mostrato in modo sbagliato, `potete leggere questa documentazione`_. | ||
9 | |||
10 | Usando un bookmarklet | ||
11 | ^^^^^^^^^^^^^^^^^^^^^ | ||
12 | |||
13 | Nella pagina ``Howto`` avete una sezione ``Bookmarklet``. Trascinate il link ``bag it!`` sulla barra dei preferiti del vostro browser. | ||
14 | |||
15 | |||
16 | Ora, ogni volta che leggiate un articolo sul web e vogliate salvarlo, cliccate sul link ``bag it!`` sulla vostra barra dei preferiti. L'articolo é salvato. | ||
17 | |||
18 | Usando la maniera classica | ||
19 | ^^^^^^^^^^^^^^^^^^^^^^^^^^ | ||
20 | |||
21 | Sulla barra in alto del vostro schermo avete 3 icone. Con la prima, un simbolo "piú", potrete salvare facilmente un articolo. | ||
22 | |||
23 | .. image:: ../../img/user/topbar.png | ||
24 | :alt: Top bar | ||
25 | :align: center | ||
26 | |||
27 | Cliccateci sopra per mostrare un nuovo campo, inserite in quest'ultimo la URL dell'articolo e premete il tasto ``Return``. L'articolo é salvato. | ||
28 | |||
29 | Usando un add-on del browser | ||
30 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | ||
31 | |||
32 | Firefox | ||
33 | """"""" | ||
34 | |||
35 | Potete scaricare `qui l'addon per Firefox <https://addons.mozilla.org/firefox/addon/wallabag-v2/>`_. | ||
36 | |||
37 | Chrome | ||
38 | """""" | ||
39 | |||
40 | Potete scaricare `qui l'addon per Chrome <https://chrome.google.com/webstore/detail/wallabagger/gbmgphmejlcoihgedabhgjdkcahacjlj?hl=fr>`_. | ||
41 | |||
42 | Usando la vostra applicazione per smartphone | ||
43 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | ||
44 | |||
45 | Android | ||
46 | """"""" | ||
47 | |||
48 | Potete scaricare `qui l'applicazione per Android <https://play.google.com/store/apps/details?id=fr.gaulupeau.apps.InThePoche>`_. | ||
49 | |||
50 | Windows Phone | ||
51 | """"""""""""" | ||
52 | |||
53 | Potete scaricare `qui l'applicazione per Windows Phone <https://www.microsoft.com/store/apps/9nblggh5x3p6>`_. | ||
54 | |||
55 | Scaricate i vostri articoli | ||
56 | --------------------------- | ||
57 | |||
58 | Potete scaricare ogni articolo in vari formati: ePUB, MOBI, PDF, XML, JSON, CSV. | ||
59 | |||
60 | Sulla vista dell'articolo, cliccate su questa icona, nella barra laterale: | ||
61 | |||
62 | .. image:: ../../img/user/download_article.png | ||
63 | :alt: download article | ||
64 | :align: center | ||
65 | |||
66 | Potete anche scaricare una categoria completa di articoli (unread, starred, archive) in questi formati. Per esempio, nella vista **Unread**, cliccate su questa icona sulla barra superiore: | ||
67 | |||
68 | .. image:: ../../img/user/download_articles.png | ||
69 | :alt: download articles | ||
70 | :align: center | ||
71 | |||
72 | Condividete i vostri articoli | ||
73 | ----------------------------- | ||
74 | |||
75 | Quando leggete un articolo, potete condividerlo. Cliccate semplicemente sul bottone di condivisione: | ||
76 | |||
77 | .. image:: ../../img/user/share.png | ||
78 | :alt: share article | ||
79 | :align: center | ||
80 | |||
81 | Ora potete condividere l'articolo: | ||
82 | |||
83 | - attraverso una URL pubblica (avrete una vista semplificata dell'articolo) | ||
84 | - attraverso un tweet | ||
85 | - nel vostro Shaarli | ||
86 | - attraverso un post su Diaspora* | ||
87 | - su Carrot | ||
88 | - attraverso un'email | ||
89 | |||
90 | Annotate i vostri articoli | ||
91 | -------------------------- | ||
92 | |||
93 | in ogni articolo che leggiate potete scrivere delle note. É piú facile da capire con delle immagini. | ||
94 | |||
95 | Selezionate la parte dell'articolo che volete annotare e cliccate sulla matita: | ||
96 | |||
97 | .. image:: ../../img/user/annotations_1.png | ||
98 | :alt: Select your text | ||
99 | :align: center | ||
100 | |||
101 | Scrivete poi la vostra nota: | ||
102 | |||
103 | .. image:: ../../img/user/annotations_2.png | ||
104 | :alt: Write your annotation | ||
105 | :align: center | ||
106 | |||
107 | Il testo é ora sottolineato e potrete leggere la vostra nota muovendo il cursore su di esso. | ||
108 | |||
109 | .. image:: ../../img/user/annotations_3.png | ||
110 | :alt: Read your annotation | ||
111 | :align: center | ||
112 | |||
113 | Potete creare quante note vogliate. | ||
114 | |||
115 | |||
diff --git a/docs/ita/user/backup.rst b/docs/ita/user/backup.rst new file mode 100644 index 00000000..548c675b --- /dev/null +++ b/docs/ita/user/backup.rst | |||
@@ -0,0 +1,30 @@ | |||
1 | Eseguire il backup di wallabag | ||
2 | ============================== | ||
3 | |||
4 | Siccome a volte potreste commettere errori con il vostro wallabag e perdere i vostri dati, oppure in caso dobbiate spostare il vostro wallabag su un altro server, dovete fare un backup dei vostri dati. | ||
5 | |||
6 | Impostazioni base | ||
7 | ----------------- | ||
8 | |||
9 | wallabag memorizza alcuni parametri base (come il server SMTP o il backend del database) nel file `app/config/parameters.yml`. | ||
10 | |||
11 | Database | ||
12 | -------- | ||
13 | |||
14 | Per il fatto che wallabag supporta vari tipi di database, il modo di eseguire backup dipende dal database che stiate usando, quindi dovrete fare riferimento alla documentazione del venditore. | ||
15 | |||
16 | Ecco alcuni esempi: | ||
17 | |||
18 | - MySQL: http://dev.mysql.com/doc/refman/5.7/en/backup-methods.html | ||
19 | - PostgreSQL: https://www.postgresql.org/docs/current/static/backup.html | ||
20 | |||
21 | SQLite | ||
22 | ~~~~~~ | ||
23 | |||
24 | Per eseguire il backup di un database SQLite, dovete semplicemente copiare la directory `data/db` dalla directory dell'applicazione wallabag. | ||
25 | |||
26 | Immagini | ||
27 | -------- | ||
28 | |||
29 | Le immagini recuperate da wallabag sono memorizzate in `web/assets/images` (la memoria delle immagini sará implementata in wallabag 2.2). | ||
30 | |||
diff --git a/docs/ita/user/configuration.rst b/docs/ita/user/configuration.rst new file mode 100644 index 00000000..fbc8687f --- /dev/null +++ b/docs/ita/user/configuration.rst | |||
@@ -0,0 +1,104 @@ | |||
1 | Configurazione | ||
2 | ============== | ||
3 | |||
4 | Ora che siete acceduti, é ora di configurare il vostro account come volete. | ||
5 | |||
6 | cliccate sul menu ``Configurazione``. Avrete cinque tab: ``Impostazioni``, ``RSS``, ``Informazioni utente``, ``Password`` e ``Regole di tagging``. | ||
7 | |||
8 | Impostazioni | ||
9 | ------------ | ||
10 | |||
11 | Tema | ||
12 | ~~~~ | ||
13 | |||
14 | wallabag é personalizzabile. Potete scegliere il vostro tema preferito qui. Il tema di default é ``Material``, é il tema usato nelle immagini della documentazione. | ||
15 | |||
16 | Oggetti per pagina | ||
17 | ~~~~~~~~~~~~~~~~~~ | ||
18 | |||
19 | Potete cambiare il numero di articoli mostrati su ogni pagina. | ||
20 | |||
21 | Velocitá di lettura | ||
22 | ~~~~~~~~~~~~~~~~~~~ | ||
23 | |||
24 | wallabag calcola un tempo di lettura per ogni articolo. Potete definire qui, grazie a questa lista, se siete dei lettori lenti of veloci. wallabag ricalcolerá il tempo di lettura per ogni articolo. | ||
25 | |||
26 | Lingua | ||
27 | ~~~~~~ | ||
28 | |||
29 | Potete cambiare la lingua dell'interfaccia di wallabag. | ||
30 | |||
31 | RSS | ||
32 | --- | ||
33 | |||
34 | wallabag offre feed RSS per ogni stato dell'articolo: non letto, preferito e archiviato. | ||
35 | |||
36 | Per prima cosa dovete creare un token personale: cliccate su ``Crea il tuo token``. É possibile cambiare il proprio token cliccando su ``Rigenera il tuo token``. | ||
37 | |||
38 | Ora avrete tre link, uno per ogni stato: aggiungeteli al vostro lettore RSS preferito. | ||
39 | |||
40 | Potete anche definire quanti articoli volete nel vostro feed RSS (valore di default: 50)- | ||
41 | |||
42 | Informazioni dell'utente | ||
43 | ------------------------ | ||
44 | |||
45 | Potete cambiare il vostro nome, il vostro indirizzo email e abilitare l'``Autenticazione a due fattori``. | ||
46 | |||
47 | Autenticazione a due fattori (2FA) | ||
48 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
49 | |||
50 | L'autenticazione a due fattori (conosciuta anche come 2FA) é una tecnologia brevettata nel 1984 che offre l'identificazione degli utenti tramite una combinazione di due componenti differenti. | ||
51 | |||
52 | https://it.wikipedia.org/wiki/Autenticazione_a_due_fattori | ||
53 | |||
54 | Se abilitate la 2FA, ogni volta che vogliate accedere a wallabag, riceverete un codice via email. Dovrete inserire il codice nel seguente modulo. | ||
55 | |||
56 | .. image:: ../../img/user/2FA_form.png | ||
57 | :alt: Two factor authentication | ||
58 | :align: center | ||
59 | |||
60 | Se non volete ricevere il codice ogni volta che vogliate accedere, potete spuntare la casella ``I'm on a trusted computer``: wallabag vi ricorderá per 15 giorni. | ||
61 | |||
62 | Password | ||
63 | -------- | ||
64 | |||
65 | Qui potete cambiare la password (minimo 8 caratteri) | ||
66 | |||
67 | Regole di tagging | ||
68 | ----------------- | ||
69 | |||
70 | Se volete assegnare un tag ai nuovi articoli, questa parte della configurazione fa per voi. | ||
71 | |||
72 | Cosa significa « regole di tagging » ? | ||
73 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
74 | |||
75 | Sono regole usate da wallabag per etichettare i nuovi articoli. Ogni volta che un nuovo articolo viene aggiunto, verranno usate tutte le regole di tagging per aggiungere le etichette che avete configurato, risparmiandovi quindi il lavoro di classificare manualmente i vostri articoli. | ||
76 | |||
77 | Come le uso? | ||
78 | ~~~~~~~~~~~~ | ||
79 | |||
80 | Immaginiamo che vogliate taggare un contenuto come *« lettura corta »* quando il tempo di lettura è inferiore ai 3 minuti. In questo caso, dovreste mettere « readingTime <= 3 » nel campo **Regola** | ||
81 | e *« lettura corta »* nel campo **Tag**. Molte etichette possono essere aggiunte simultaneamente separandole con una virgola: *« lettura corta, da leggere »*. | ||
82 | Si possono scrivere regole complesse usando gli operatori predefiniti: | ||
83 | se *« readingTime >= 5 AND domainName = "github.com" »* allora etichetta come *« lettura lunga, github »*. | ||
84 | |||
85 | Quali variabili ed operatori posso usare per scrivere le regole? | ||
86 | |||
87 | I seguenti operatori e variabili possono essere usati per creare regole di tagging (attenzione, per alcuni valori, dovete aggiungere le virgolette, per esempio ``language = "en"``): | ||
88 | |||
89 | =========== ============================================== ========= =========== | ||
90 | Variabile Significato Operatore Significato | ||
91 | ----------- ---------------------------------------------- --------- ----------- | ||
92 | title Titolo dell'articolo <= Minore di… | ||
93 | url URL dell'articolo < Strettamente minore di… | ||
94 | isArchived Se l'articolo é archiviato o no => Maggiore di… | ||
95 | isStarred Se l'articolo é preferito o no > Strettamente maggiore di… | ||
96 | content Il contenuto dell'articolo = Uguale a… | ||
97 | language La lingua dell'aritcolo != Diverso da… | ||
98 | mimetype The entry's mime-type OR Una regola o l'altra | ||
99 | readingTime Il tempo di lettura dell'articolo stimato AND Una regola e l'altra | ||
100 | domainName Il nome del dominio dell'articolo matches Vede se un soggetto corrisponde alla ricerca (indipendentemente dal maiuscolo o minuscolo). Esempio: titolo corrisponde a "football" | ||
101 | =========== ============================================== ======== ========== | ||
102 | |||
103 | |||
104 | |||
diff --git a/docs/ita/user/configuring_mobile.rst b/docs/ita/user/configuring_mobile.rst new file mode 100644 index 00000000..7229aed6 --- /dev/null +++ b/docs/ita/user/configuring_mobile.rst | |||
@@ -0,0 +1,13 @@ | |||
1 | Configuring mobile apps to work with wallabag | ||
2 | ============================================= | ||
3 | |||
4 | Steps to configure the app | ||
5 | -------------------------- | ||
6 | |||
7 | - First *create a new client* in the ``API clients management`` section. The name of your app doesn't matter as much as the ``Client ID`` and the ``Client secret``. Write these two values down. | ||
8 | - When you download a mobile app, it's going to ask for the server address of the hosted wallabag instance. For example, with wallabag.it that is: ``https://app.wallabag.it``. | ||
9 | - It's also going to ask for the aforementioned ``Client ID`` and ``secret``. Please insert those in the text fields, when asked. | ||
10 | - Lastly you need to provide your ``username`` and ``password``. These are the same credentials you use to login in to wallabag. | ||
11 | |||
12 | Please also have a look at `Android <android.html>`_ page. Especially the section on *known limitations*. | ||
13 | |||
diff --git a/docs/ita/user/create_account.rst b/docs/ita/user/create_account.rst new file mode 100644 index 00000000..c569962d --- /dev/null +++ b/docs/ita/user/create_account.rst | |||
@@ -0,0 +1,38 @@ | |||
1 | Creazione di un account e autenticazione | ||
2 | ======================================== | ||
3 | |||
4 | Registrazione | ||
5 | ------------- | ||
6 | |||
7 | Sulla pagina di login, cliccate sul bottone ``Register`` | ||
8 | |||
9 | .. image:: ../../img/user/registration_form.png | ||
10 | :alt: Registration form | ||
11 | :align: center | ||
12 | |||
13 | Dovrete completare il modulo. Assicuratevi di inserire un indirizzo email valido, quindi vi invieremo un'email di attivazione. | ||
14 | |||
15 | .. image:: ../../img/user/sent_email.png | ||
16 | :alt: Email was sent to activate account | ||
17 | :align: center | ||
18 | |||
19 | Controllate la vostra casella, in cui avrete una nuova mail con un link che assomiglia a questo ``http://wallabag/register/confirm/Ba19wokGovN-DdBQNfg4YgRkUQWRP4-k2g0Bk-hBTX4``. Cliccateci sopra per attivare il vostro account. | ||
20 | |||
21 | Il vostro account é ora attivo | ||
22 | |||
23 | .. image:: ../../img/user/activated_account.png | ||
24 | :alt: Welcome on board! | ||
25 | :align: center | ||
26 | |||
27 | Login | ||
28 | ----- | ||
29 | |||
30 | Il vostro account é ora abilitato, congratulazioni! | ||
31 | |||
32 | Se siete sul vostro computer personale e volete restare connessi, spuntate la casella ``Keep me logged in``: wallabag vi ricorderá per un anno. | ||
33 | |||
34 | .. image:: ../../img/user/login_form.png | ||
35 | :alt: Login form | ||
36 | :align: center | ||
37 | |||
38 | |||
diff --git a/docs/ita/user/errors_during_fetching.rst b/docs/ita/user/errors_during_fetching.rst new file mode 100644 index 00000000..d92b83dc --- /dev/null +++ b/docs/ita/user/errors_during_fetching.rst | |||
@@ -0,0 +1,37 @@ | |||
1 | |||
2 | Errori durante l'ottenimento degli articoli | ||
3 | =========================================== | ||
4 | |||
5 | Perché l'ottenimento di un articolo fallisce? | ||
6 | --------------------------------------------- | ||
7 | |||
8 | Ci possono essere varie ragioni: | ||
9 | |||
10 | - problema del network | ||
11 | - wallabag non può ottenere il contenuto a causa della struttura del sito web | ||
12 | |||
13 | Potete provare a risolvere il problema da soli ( in modo che noi possiamo concentrarci nel migliorare wallabag internamente invece di scrivere siteconfig | ||
14 | :) ). | ||
15 | |||
16 | Potete provare a vedere se funziona qui: `http://f43.me/feed/test <http://f43.me/feed/test>`_ (usa quasi lo stesso sistema per ottenere contenuto). | ||
17 | |||
18 | Se funziona lì e non su wallabag, significa che c'è qualcosa all'interno di wallabag che causa il malfunzionamento del parser (difficile da aggiustare: si prega di riportare il problema). | ||
19 | |||
20 | Se non funziona, provate a estrarre un site config usando: `http://siteconfig.fivefilters.org/ <http://siteconfig.fivefilters.org/>`_ (seleziona quale parte del contenuto é effettivamente contenuto). Potete `leggere prima questa documentazione <http://help.fivefilters.org/customer/en/portal/articles/223153-site-patterns>`_. | ||
21 | |||
22 | Potete testarlo sul sito **f43.m3**: cliccate su **Want to try a custom siteconfig?** e inseritvi il file generato in and put the generated file from siteconfig.fivefilters.org. | ||
23 | |||
24 | Ripetete finché non avrete qualcosa di buono. | ||
25 | |||
26 | Potete poi inviare una pull request a `https://github.com/fivefilters/ftr-site-config <https://github.com/fivefilters/ftr-site-config>`_ il quale é il repository ufficiale per i file siteconfig. | ||
27 | |||
28 | Come posso provare a riottenere questo articolo? | ||
29 | ------------------------------------------------ | ||
30 | |||
31 | Se wallabag ha fallito a ottenere l'articolo, potete cliccare sul bottone di ricaricamento (il terzo bottone nella figura sottostante). | ||
32 | |||
33 | .. image:: ../../img/user/refetch.png | ||
34 | :alt: Refetch content | ||
35 | :align: center | ||
36 | |||
37 | |||
diff --git a/docs/ita/user/faq.rst b/docs/ita/user/faq.rst new file mode 100644 index 00000000..decdfab1 --- /dev/null +++ b/docs/ita/user/faq.rst | |||
@@ -0,0 +1,53 @@ | |||
1 | Domande frequenti | ||
2 | ================= | ||
3 | |||
4 | Durante l'installazione ho riscontrato l'errore ``Error Output: sh: 1: @post-cmd: not found`` | ||
5 | --------------------------------------------------------------------------------------------- | ||
6 | |||
7 | Sembra che ci sia un problema con la vostra installazione di ``composer``. Provate a disinstallarlo e reinstallarlo. | ||
8 | |||
9 | `Leggete la documentazione su composer per sapere come installarlo | ||
10 | <https://getcomposer.org/doc/00-intro.md>`__. | ||
11 | |||
12 | Non riesco a convalidare il modulo di registrazione | ||
13 | --------------------------------------------------- | ||
14 | |||
15 | Assicuratevi che tutti i campi siano riempiti correttamente: | ||
16 | |||
17 | * indirizzo email valido | ||
18 | * stessa password nei due campi | ||
19 | |||
20 | Non riesco a ricevere la mia mail di attivazione | ||
21 | ------------------------------------------------ | ||
22 | |||
23 | Siete sicuri che il vostro indirizzo email sia corretto? avete controllato la cartella di spam? | ||
24 | |||
25 | Se ancora non vedete la mail di attivazione, assicuratevi di aver installato e configurato a dovere un mail transfer agent. Assicuratevi di includere una regola del firewall per SMTP. Per esempio, se usate firewalld: | ||
26 | |||
27 | :: | ||
28 | |||
29 | firewall-cmd --permanent --add-service=smtp | ||
30 | firewall-cmd --reload | ||
31 | |||
32 | Infine, se avete SELinux abilitato, impostate la seguente regola: | ||
33 | |||
34 | ``setsebool -P httpd_can_sendmail 1`` | ||
35 | |||
36 | Quando clicco il link di attivazione, mi appare questo messaggio: ``L'utente con token di conferma "DtrOPfbQeVkWf6N" non esiste``. | ||
37 | ---------------------------------------------------------------------------------------------------------------------------------- | ||
38 | |||
39 | Avete giá attivato il vostro account oppure l'URL dell'email di attivazione é sbagliato. | ||
40 | |||
41 | Ho dimenticato la mia password | ||
42 | ------------------------------ | ||
43 | |||
44 | Potete ripristinare la password cliccando il link``Hai dimenticato la password?``, nella pagina di login. Quindi, riempite il modulo con la vostra email o il vostro username e riceverete un'email per ripristinare la vostra password. | ||
45 | |||
46 | Ho riscontrato l'errore ``failed to load external entity`` cercando di installare wallabag | ||
47 | ------------------------------------------------------------------------------------------ | ||
48 | |||
49 | Come descritto `qui <https://github.com/wallabag/wallabag/issues/2529>`_, modificate il vostro file ``web/app.php`` ed aggiungete questa linea: ``libxml_disable_entity_loader(false);`` sulla linea 5. | ||
50 | |||
51 | Questo é un bug di Doctrine / PHP, non possiamo farci nulla. | ||
52 | |||
53 | |||
diff --git a/docs/ita/user/filters.rst b/docs/ita/user/filters.rst new file mode 100644 index 00000000..105cb1d6 --- /dev/null +++ b/docs/ita/user/filters.rst | |||
@@ -0,0 +1,45 @@ | |||
1 | Trovate i vostri articoli grazie ai filtri | ||
2 | ------------------------------------------ | ||
3 | |||
4 | Per trovare facilmente gli articoli, potete usare i filtri. | ||
5 | |||
6 | .. image:: ../../img/user/topbar.png | ||
7 | :alt: Top bar | ||
8 | :align: center | ||
9 | |||
10 | Tutti questi filtri possono essere combinati. | ||
11 | |||
12 | .. image:: ../../img/user/filters.png | ||
13 | :alt: Combine all filters | ||
14 | :align: center | ||
15 | |||
16 | Stato | ||
17 | ----- | ||
18 | |||
19 | Usate queste caselle per trovare articoli archiviati o preferiti. | ||
20 | |||
21 | Immagine di anteprima | ||
22 | --------------------- | ||
23 | |||
24 | Selezionate questo filtro se volete trovare articoli con un'immagine di anteprima. | ||
25 | |||
26 | Lingua | ||
27 | ------ | ||
28 | |||
29 | wallabag (attraverso graby) puó individuare la lingua di un articolo. É facile per voi trovare articoli scritti in una lingua specifica. | ||
30 | |||
31 | Tempo di lettura | ||
32 | ---------------- | ||
33 | |||
34 | wallabag stima quanto tempo é necessario per leggere un articolo. Con questo filtro potete, per esempio, trovare articoli con un tempo di lettura compreso fra 2 e 5 minuti. | ||
35 | |||
36 | Nome di dominio | ||
37 | --------------- | ||
38 | |||
39 | Grazie a questo filtro potete trovare articoli dallo stesso nome di dominio. Per esempio, scrivete in questo campo ``bbc.co.uk`` per trovare gli articoli di questo sito. | ||
40 | |||
41 | Data di creazione | ||
42 | ----------------- | ||
43 | |||
44 | Quando salvate un articolo, wallabag memorizza la data corrente. ció é comodo, per esempio, per trovare articoli salvati tra il primo ed il 31 di Gennaio. | ||
45 | |||
diff --git a/docs/ita/user/import.rst b/docs/ita/user/import.rst new file mode 100644 index 00000000..c249acfd --- /dev/null +++ b/docs/ita/user/import.rst | |||
@@ -0,0 +1,115 @@ | |||
1 | Migrare da... | ||
2 | ============= | ||
3 | |||
4 | In wallabag 2.x, potete importare dati da: | ||
5 | |||
6 | - `Pocket <#id1>`_ | ||
7 | - `Readability <#id2>`_ | ||
8 | - `Instapaper <#id4>`_ | ||
9 | - `wallabag 1.x <#id6>`_ | ||
10 | - `wallabag 2.x <#id7>`_ | ||
11 | |||
12 | Abbiamo anche sviluppato `uno script per eseguire migrazioni tramite la linea di comando <#import-via-command-line-interface-cli>`_. | ||
13 | |||
14 | Poiché le importazioni possono richiedere molto tempo, abbiamo sviluppato un sistema di compiti asincroni. *inserisci qui link una volta tradotto articolo su asynchronous* | ||
15 | |||
16 | |||
17 | ------ | ||
18 | |||
19 | Creare una nuova applicazione su Pocket | ||
20 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
21 | |||
22 | Per importare dati da Pocket usiamo l'API di Pocket. Dovete creare una nuova applicazione sul loro sito per sviluppatori per continuare. | ||
23 | |||
24 | * Create una nuova applicazione `sul sito per sviluppatori <https://getpocket.com/developer/apps/new>`_ | ||
25 | * Riempite i campi richiesti: nome dell'applicazione, descrizione dell'applicazione, permessi (solo **retrieve**), piattaforma (**web**), accettate i termini di servizio ed inviate la vostra nuova applicazione | ||
26 | |||
27 | Pocket vi dará una **Consumer Key** (per esempio, `49961-985e4b92fe21fe4c78d682c1`). Dovete configurare la ``pocket_consumer_key`` dal menu ``Config``. | ||
28 | |||
29 | Ora é tutto pronto per migrare da Pocket. | ||
30 | |||
31 | Importate i vostri dati su wallabag 2.x | ||
32 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
33 | |||
34 | Cliccate sul link `Importa` nel menu, su `Importa contenuti` nella sezione Pocket e poi su ``Connetti a Pocket ed importa i dati`` | ||
35 | |||
36 | Dovete autorizzare wallabag a interagire con il vostro account Pocket. | ||
37 | I vostri dati saranno importati. L'importazione di dati puó essere un processo esigente per il vostro server. | ||
38 | |||
39 | Instapaper | ||
40 | ---------- | ||
41 | |||
42 | Esportate i vostri dati di Instapaper | ||
43 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
44 | |||
45 | Sulla pagina delle impostazioni (`https://www.instapaper.com/user <https://www.instapaper.com/user>`_), cliccate su "Download .CSV file" nella sezione "Export". Verrá scaricato un file CSV (like ``instapaper-export.csv``). | ||
46 | |||
47 | Importate i vostri dati in wallabag 2.x | ||
48 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
49 | |||
50 | Cliccate sul link `Importa` sul menu, poi su `Importa contenuti` nella sezione di Instapaper, quindi selezionate il vostro file CSV e caricatelo. | ||
51 | |||
52 | I vostri dati saranno importati. L'importazione di dati puó essere un'operazione esigente per il server. | ||
53 | |||
54 | wallabag 1.x | ||
55 | ------------ | ||
56 | |||
57 | Se state usando wallabag 1.x, dovete esportare i dati prima di migrare a wallabag 2.x, poiché l'applicazione ed il suo database sono cambiati molto. Potete esportare i vostri dati dalla vostra vecchia installazione di wallabag sulla pagina Config di questa. | ||
58 | |||
59 | .. image:: ../../img/user/export_v1.png | ||
60 | :alt: Exporting from wallabag v1 | ||
61 | :align: center | ||
62 | |||
63 | .. nota:: | ||
64 | Se avete account multipli nella stessa istanza di wallabag, ogni utente dovrá esportare da v1 ed importare su v2. | ||
65 | |||
66 | .. nota:: | ||
67 | Se riscontrate problemi durante l'importazione o l'esportazione, non esitate a `chiedere supporto <https://www.wallabag.org/pages/support.html>`__. | ||
68 | |||
69 | Quando avrete ottenuto il file json contenente i vostri articoli, potrete installare wallabag v2 seguendo, se necessario, `la procedura standard *link mancante*. | ||
70 | |||
71 | Dopo aver creato un account utente sulla vostra nuova istanza di wallabag v2, dovete andare alla sezione `Importa` e selezionare `Importa da wallabag v1`. Selezionate il vostro file json e caricatelo. | ||
72 | |||
73 | .. image:: ../../img/user/import_wallabagv1.png | ||
74 | :alt: Import from wallabag v1 | ||
75 | :align: center | ||
76 | |||
77 | wallabag 2.x | ||
78 | ------------ | ||
79 | |||
80 | Dalla istanza di wallabag precedente sulla quale eravate prima, andate su `Tutti gli articoli`, poi esportate questi articoli come json. | ||
81 | |||
82 | .. image:: ../../img/user/export_v2.png | ||
83 | :alt: Export depuis wallabag v2 | ||
84 | :align: center | ||
85 | |||
86 | Dalla vostra nuova istanza di wallabag, create un account utente e cliccate sul link nel menu per procedere all'importazione. Scegliete di importare da wallabag v2 e selezionate il vostro file json per caricarlo. | ||
87 | |||
88 | .. nota:: | ||
89 | Se riscontrate problemi durante l'importazione o l'esportazione, non esitate a `chiedere supporto <https://www.wallabag.org/pages/support.html>`__. | ||
90 | |||
91 | Importate dall'interfaccia a riga di comando (CLI) | ||
92 | -------------------------------------------------- | ||
93 | |||
94 | Se avete un accesso CLI al vostro server web, potete eseguire questo comando per importare ció che avete esportato da wallabag v1: | ||
95 | |||
96 | :: | ||
97 | |||
98 | bin/console wallabag:import 1 ~/Downloads/wallabag-export-1-2016-04-05.json --env=prod | ||
99 | |||
100 | Rimpiazzate i valori: | ||
101 | |||
102 | * ``1`` é l'identificatore utente nel database (l'ID del primo utente creato su wallabag é 1) | ||
103 | * ``~/Downloads/wallabag-export-1-2016-04-05.json`` é il percorso del file esportato da wallabag v1 | ||
104 | |||
105 | Se volete segnare tutti questi articoli come giá letti, potete aggiungere l'opzione ``--markAsRead``. | ||
106 | Per importare un file di wallabag v2, dovete aggiungere l'opzione ``--importer=v2``. | ||
107 | |||
108 | Come risultato avrete questo messaggio: | ||
109 | |||
110 | :: | ||
111 | |||
112 | Start : 05-04-2016 11:36:07 --- | ||
113 | 403 imported | ||
114 | 0 already saved | ||
115 | End : 05-04-2016 11:36:09 --- | ||
diff --git a/docs/ita/user/installation.rst b/docs/ita/user/installation.rst new file mode 100644 index 00000000..cd6ebbef --- /dev/null +++ b/docs/ita/user/installation.rst | |||
@@ -0,0 +1,333 @@ | |||
1 | |||
2 | |||
3 | Installa wallabag | ||
4 | ================= | ||
5 | |||
6 | Requisiti | ||
7 | --------- | ||
8 | wallabag é compatibile con PHP >= 5.5, incluso PHP 7. | ||
9 | |||
10 | .. nota:: | ||
11 | |||
12 | Per installare facilmente wallabag vi forniamo un Makefile, dunque avrete bisogno dello strumento make. | ||
13 | |||
14 | wallabag utilizza un gran numero di librerie PHP per funzionare. Queste librerie vanno installate tramite uno strumento chiamato Composer. Dovete installarlo se non lo avete giá fatto e assicuratevi di usare la versione 1.2 ( se giá avete Composer, esegui il comando composer selfupdate). | ||
15 | |||
16 | Installa Composer: | ||
17 | |||
18 | :: | ||
19 | curl -s http://getcomposer.org/installer | php | ||
20 | |||
21 | `Qui <https://getcomposer.org/doc/00-intro.md>`__ puoi trovare istruzioni specifiche. | ||
22 | |||
23 | Per far funzionare wallabag avrete anche bisogno delle seguenti estensioni. Alcune di queste dovrebbero essere giá attive nella vostra versione di PHP, per cui potrebbe non essere necessario installare tutti i pacchetti corrispondenti. | ||
24 | |||
25 | - php-session | ||
26 | - php-ctype | ||
27 | - php-dom | ||
28 | - php-hash | ||
29 | - php-simplexml | ||
30 | - php-json | ||
31 | - php-gd | ||
32 | - php-mbstring | ||
33 | - php-xml | ||
34 | - php-tidy | ||
35 | - php-iconv | ||
36 | - php-curl | ||
37 | - php-gettext | ||
38 | - php-tokenizer | ||
39 | - php-bcmath | ||
40 | |||
41 | wallabag usa PDO per connettersi, per cui avrete bisogno di uno dei seguenti: | ||
42 | |||
43 | -pdo_mysql | ||
44 | -pdo_sqlite | ||
45 | -pdo_pgsql | ||
46 | |||
47 | E il corrispondente database server. | ||
48 | |||
49 | Installazione | ||
50 | ------------- | ||
51 | |||
52 | Su un web server dedicato (raccomandato) | ||
53 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
54 | |||
55 | Per installare wallabag stesso dovete eseguire i seguenti comandi: | ||
56 | |||
57 | :: | ||
58 | |||
59 | git clone https://github.com/wallabag/wallabag.git | ||
60 | cd wallabag && make install | ||
61 | |||
62 | Per attivare il server incorporato di PHP e verificare che l’installazione sia andata a buon fine potete eseguire: | ||
63 | |||
64 | :: | ||
65 | |||
66 | make run | ||
67 | |||
68 | E accedere a wallabag all’indirizzo http://ipdeltuoserver:8000 | ||
69 | |||
70 | .. consiglio:: | ||
71 | |||
72 | Per definire i parametri con variabili d’ambiente é necessario impostare queste ultime con il prefisso ``SYMFONY_``. Per esempio, ``SYMFONY__DATABASE_DRIVER``. Puoi guardare la `documentazione di Symfony <http://symfony.com/doc/current/cookbook/configuration/external_parameters.html>`__ per maggiori informazioni. | ||
73 | |||
74 | A proposito di hosting condiviso | ||
75 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
76 | |||
77 | Offriamo un pacchetto con tutte le dipendenze incluse. La configurazione di default usa SQLite per il database. Se volete cambiare queste impostazioni, modificate app/config/parameters.yml. | ||
78 | |||
79 | Abbiamo giá creato un utente: il login e la password sono wallabag. | ||
80 | |||
81 | .. attenzione: | ||
82 | |||
83 | Con questo pacchetto, wallabag non controlla le estensioni obbligatorie usate nell’applicazione (questi controlli sono fatti durante ``composer install`` quando hai un server web dedicato, vedi sopra). | ||
84 | |||
85 | Eseguite questo comando per scaricare ed estrarre il pacchetto piú aggiornato: | ||
86 | |||
87 | .. code-block:: bash | ||
88 | |||
89 | wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package | ||
90 | |||
91 | Troverete il `hash md5 del pacchetto piú aggiornato sul nostro sito <https://www.wallabag.org/pages/download-wallabag.html>`_. | ||
92 | |||
93 | Ora leggete la seguente documentazione per creare il vostro host virtuale poi accedete al vostro wallabag. Se avete cambiato la configurazione del database per usare MySQL o PostrgreSQL, dovrete creare un utente con il comando php bin/console wallabag:install --env=prod . | ||
94 | |||
95 | Installazione con Docker | ||
96 | ~~~~~~~~~~~~~~~~~~~~~~~~ | ||
97 | |||
98 | Offriamo un’immagine Docker per installare wallabag facilmente. Guarda la nostra repository su `Docker Hub <https://hub.docker.com/r/wallabag/wallabag/>`__ per maggiori informazioni. | ||
99 | |||
100 | Comando per avviare il container | ||
101 | |||
102 | .. code-block:: bash | ||
103 | |||
104 | docker pull wallabag/wallabag | ||
105 | |||
106 | |||
107 | Host virtuali | ||
108 | ------------- | ||
109 | |||
110 | Configurazione su Apache | ||
111 | ~~~~~~~~~~~~~~~~~~~~~~~~ | ||
112 | |||
113 | Assumendo che voi abbiate installato wallabag nella cartella ``/var/www/wallabag`` e che vogliate usare PHP come un modulo Apache, ecco un vhost per l’applicazione: | ||
114 | |||
115 | :: | ||
116 | |||
117 | <VirtualHost *:80> | ||
118 | ServerName domain.tld | ||
119 | ServerAlias www.domain.tld | ||
120 | |||
121 | DocumentRoot /var/www/wallabag/web | ||
122 | <Directory /var/www/wallabag/web> | ||
123 | AllowOverride None | ||
124 | Order Allow,Deny | ||
125 | Allow from All | ||
126 | |||
127 | <IfModule mod_rewrite.c> | ||
128 | Options -MultiViews | ||
129 | RewriteEngine On | ||
130 | RewriteCond %{REQUEST_FILENAME} !-f | ||
131 | RewriteRule ^(.*)$ app.php [QSA,L] | ||
132 | </IfModule> | ||
133 | </Directory> | ||
134 | |||
135 | # uncomment the following lines if you install assets as symlinks | ||
136 | # or run into problems when compiling LESS/Sass/CoffeScript assets | ||
137 | # <Directory /var/www/wallabag> | ||
138 | # Options FollowSymlinks | ||
139 | # </Directory> | ||
140 | |||
141 | # optionally disable the RewriteEngine for the asset directories | ||
142 | # which will allow apache to simply reply with a 404 when files are | ||
143 | # not found instead of passing the request into the full symfony stack | ||
144 | <Directory /var/www/wallabag/web/bundles> | ||
145 | <IfModule mod_rewrite.c> | ||
146 | RewriteEngine Off | ||
147 | </IfModule> | ||
148 | </Directory> | ||
149 | ErrorLog /var/log/apache2/wallabag_error.log | ||
150 | CustomLog /var/log/apache2/wallabag_access.log combined | ||
151 | </VirtualHost> | ||
152 | |||
153 | Dopo aver riavviato o ricaricato Apache dovreste essere in grado di accedere a wallabag tramite l’indirizzo http://domain.tld. | ||
154 | |||
155 | Configurazione su Nginx | ||
156 | ~~~~~~~~~~~~~~~~~~~~~~~ | ||
157 | |||
158 | Assumendo che abbiate installato wallabag nella cartella ``/var/www/wallabag``, ecco una ricetta per l’applicazione: | ||
159 | |||
160 | :: | ||
161 | |||
162 | server { | ||
163 | server_name domain.tld www.domain.tld; | ||
164 | root /var/www/wallabag/web; | ||
165 | |||
166 | location / { | ||
167 | # try to serve file directly, fallback to app.php | ||
168 | try_files $uri /app.php$is_args$args; | ||
169 | } | ||
170 | location ~ ^/app\.php(/|$) { | ||
171 | fastcgi_pass unix:/var/run/php5-fpm.sock; | ||
172 | fastcgi_split_path_info ^(.+\.php)(/.*)$; | ||
173 | include fastcgi_params; | ||
174 | # When you are using symlinks to link the document root to the | ||
175 | # current version of your application, you should pass the real | ||
176 | # application path instead of the path to the symlink to PHP | ||
177 | # FPM. | ||
178 | # Otherwise, PHP's OPcache may not properly detect changes to | ||
179 | # your PHP files (see https://github.com/zendtech/ZendOptimizerPlus/issues/126 | ||
180 | # for more information). | ||
181 | fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name; | ||
182 | fastcgi_param DOCUMENT_ROOT $realpath_root; | ||
183 | # Prevents URIs that include the front controller. This will 404: | ||
184 | # http://domain.tld/app.php/some-path | ||
185 | # Remove the internal directive to allow URIs like this | ||
186 | internal; | ||
187 | } | ||
188 | |||
189 | # return 404 for all other php files not matching the front controller | ||
190 | # this prevents access to other php files you don't want to be accessible. | ||
191 | location ~ \.php$ { | ||
192 | return 404; | ||
193 | } | ||
194 | |||
195 | error_log /var/log/nginx/wallabag_error.log; | ||
196 | access_log /var/log/nginx/wallabag_access.log; | ||
197 | } | ||
198 | |||
199 | |||
200 | Dopo aver riavviato o ricaricato Nginx dovreste essere in grado di accedere a wallabag tramite l’indirizzo http://domain.tld. | ||
201 | |||
202 | Configurazione su lighttpd | ||
203 | ~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
204 | |||
205 | Assumendo che abbiate installato wallabag nella cartella /var/www/wallabag, ecco una ricetta per l’applicazione (modificate il vostro file lighttpd.conf e incollatevi questa configurazione): | ||
206 | |||
207 | :: | ||
208 | |||
209 | server.modules = ( | ||
210 | "mod_fastcgi", | ||
211 | "mod_access", | ||
212 | "mod_alias", | ||
213 | "mod_compress", | ||
214 | "mod_redirect", | ||
215 | "mod_rewrite", | ||
216 | ) | ||
217 | server.document-root = "/var/www/wallabag/web" | ||
218 | server.upload-dirs = ( "/var/cache/lighttpd/uploads" ) | ||
219 | server.errorlog = "/var/log/lighttpd/error.log" | ||
220 | server.pid-file = "/var/run/lighttpd.pid" | ||
221 | server.username = "www-data" | ||
222 | server.groupname = "www-data" | ||
223 | server.port = 80 | ||
224 | server.follow-symlink = "enable" | ||
225 | index-file.names = ( "index.php", "index.html", "index.lighttpd.html") | ||
226 | url.access-deny = ( "~", ".inc" ) | ||
227 | static-file.exclude-extensions = ( ".php", ".pl", ".fcgi" ) | ||
228 | compress.cache-dir = "/var/cache/lighttpd/compress/" | ||
229 | compress.filetype = ( "application/javascript", "text/css", "text/html", "text/plain" ) | ||
230 | include_shell "/usr/share/lighttpd/use-ipv6.pl " + server.port | ||
231 | include_shell "/usr/share/lighttpd/create-mime.assign.pl" | ||
232 | include_shell "/usr/share/lighttpd/include-conf-enabled.pl" | ||
233 | dir-listing.activate = "disable" | ||
234 | |||
235 | url.rewrite-if-not-file = ( | ||
236 | "^/([^?]*)(?:\?(.*))?" => "/app.php?$1&$2", | ||
237 | "^/([^?]*)" => "/app.php?=$1", | ||
238 | ) | ||
239 | |||
240 | |||
241 | Diritti di accesso alle cartelle del progetto | ||
242 | --------------------------------------------- | ||
243 | |||
244 | Ambiente di test | ||
245 | ~~~~~~~~~~~~~~~~ | ||
246 | |||
247 | Quando vorremo solamente testare wallabag, eseguiremo il comando ``make run`` per avviare la nostra istanza di wallabag e tutto funzionerá correttamente poiché l’utente che ha iniziato il progetto puó accedere alla cartella corrente senza problemi. | ||
248 | |||
249 | Ambiente di produzione | ||
250 | ~~~~~~~~~~~~~~~~~~~~~~ | ||
251 | |||
252 | Non appena useremo Apache o Nginx per accedere alla nostra istanza di wallabag, e non avviandola con il comando ``make run``, dovremo aver cura di concedere i giusti diritti sulle giuste cartelle per far rimanere sicure tutte le cartelle del progetto. | ||
253 | |||
254 | Per fare ció, il nome della cartella, conosciuta come ``DocumentRoot`` (per Apache) o ``root`` (per Nginx), deve essere assolutamente accessibile all’utente Apache/Nginx. Il suo nome è generalmente ``www-data``, ``apache`` o ``nobody`` (dipendendo dal sistema Linux utilizzato). | ||
255 | |||
256 | Quindi la cartella ``/var/www/wallabag/web`` deve essere accessibile da quest’ultimo. Questo tuttavia potrebbe non essere sufficiente se solo ci importa di questa cartella poiché potremmo incontrare una pagina bianca o un errore 500 quando cerchiamo di accedere alla homepage del progetto. | ||
257 | |||
258 | Questo é dato dal fatto che dovremo concedere gli stessi diritti di accesso di ``/var/www/wallabag/web`` alla cartella ``/var/www/wallabag/var`` . Risolveremo quindi il problema con il seguente comando: | ||
259 | |||
260 | .. code-block:: bash | ||
261 | |||
262 | chown -R www-data:www-data /var/www/wallabag/var | ||
263 | |||
264 | |||
265 | Deve essere tutto uguale per le seguenti cartelle: | ||
266 | |||
267 | * /var/www/wallabag/bin/ | ||
268 | * /var/www/wallabag/app/config/ | ||
269 | * /var/www/wallabag/vendor/ | ||
270 | * /var/www/wallabag/data/ | ||
271 | |||
272 | inserendo | ||
273 | |||
274 | .. code-block:: bash | ||
275 | |||
276 | chown -R www-data:www-data /var/www/wallabag/bin | ||
277 | chown -R www-data:www-data /var/www/wallabag/app/config | ||
278 | chown -R www-data:www-data /var/www/wallabag/vendor | ||
279 | chown -R www-data:www-data /var/www/wallabag/data/ | ||
280 | |||
281 | Altrimenti prima o poi incontreremo questi messaggi di errore: | ||
282 | |||
283 | .. code-block:: bash | ||
284 | |||
285 | Unable to write to the "bin" directory. | ||
286 | file_put_contents(app/config/parameters.yml): failed to open stream: Permission denied | ||
287 | file_put_contents(/.../wallabag/vendor/autoload.php): failed to open stream: Permission denied | ||
288 | |||
289 | Regole aggiuntive per SELinux | ||
290 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
291 | |||
292 | se SELinux é abilitato sul vostro sistema, dovrete configurare contesti aggiuntivi in modo che wallabag funzioni correttamente. Per controllare se SELinux é abilitato, semplicemente inserisci ció che segue: | ||
293 | |||
294 | ``getenforce`` | ||
295 | |||
296 | Questo mostrerá ``Enforcing`` se SELinux é abilitato. Creare un nuovo contesto coinvolge la seguente sintassi: | ||
297 | |||
298 | ``semanage fcontext -a -t <context type> <full path>`` | ||
299 | |||
300 | Per esempio: | ||
301 | |||
302 | ``semanage fcontext -a -t httpd_sys_content_t "/var/www/wallabag(/.*)?"`` | ||
303 | |||
304 | Questo applicherá ricorsivamente il constesto httpd_sys_content_t alla cartella wallabag e a tutti i file e cartelle sottostanti. Sono necessarie le seguenti regole: | ||
305 | |||
306 | +-----------------------------------+----------------------------+ | ||
307 | | Percorso completo | Contesto | | ||
308 | +===================================+============================+ | ||
309 | | /var/www/wallabag(/.*)? | ``httpd_sys_content_t`` | | ||
310 | +-----------------------------------+----------------------------+ | ||
311 | | /var/www/wallabag/data(/.*)? | ``httpd_sys_rw_content_t`` | | ||
312 | +-----------------------------------+----------------------------+ | ||
313 | | /var/www/wallabag/var/logs(/.*)? | ``httpd_log_t`` | | ||
314 | +-----------------------------------+----------------------------+ | ||
315 | | /var/www/wallabag/var/cache(/.*)? | ``httpd_cache_t`` | | ||
316 | +-----------------------------------+----------------------------+ | ||
317 | |||
318 | Dopo aver creato questi contesti, inserite ció che segue per applicare le vostre regole: | ||
319 | |||
320 | ``restorecon -R -v /var/www/wallabag`` | ||
321 | |||
322 | Potrete controllare i contesti in una cartella scrivendo ``ls -lZ`` e potrete vedere tutte le regole correnti con ``semanage fcontext -l -C``. | ||
323 | |||
324 | Se state installando il pacchetto latest-v2-package, é necessaria un'ulteriore regola durante la configurazione iniziale: | ||
325 | |||
326 | ``semanage fcontext -a -t httpd_sys_rw_content_t "/var/www/wallabag/var"`` | ||
327 | |||
328 | Dopo che siate acceduti con successo al vostro wallabag e abbiate completato la configurazione iniziale, questo contesto puó essere rimosso: | ||
329 | |||
330 | :: | ||
331 | |||
332 | semanage fcontext -d -t httpd_sys_rw_content_t "/var/www/wallabag/var" | ||
333 | retorecon -R -v /var/www/wallabag/var | ||
diff --git a/docs/ita/user/parameters.rst b/docs/ita/user/parameters.rst new file mode 100644 index 00000000..da9555e1 --- /dev/null +++ b/docs/ita/user/parameters.rst | |||
@@ -0,0 +1,93 @@ | |||
1 | Qual'é il significato dei parametri? | ||
2 | ==================================== | ||
3 | |||
4 | File `parameters.yml` di default | ||
5 | -------------------------------- | ||
6 | |||
7 | Ecco l'ultima versione del file `app/config/parameters.yml` di default. Assicuratevi che la vostra rispetti questa. | ||
8 | Se non sapete quale parametro dovete impostare, si prega di lasciare quello di default. | ||
9 | |||
10 | .. code-block:: yml | ||
11 | |||
12 | parameters: | ||
13 | database_driver: pdo_sqlite | ||
14 | database_host: 127.0.0.1 | ||
15 | database_port: null | ||
16 | database_name: symfony | ||
17 | database_user: root | ||
18 | database_password: null | ||
19 | database_path: '%kernel.root_dir%/../data/db/wallabag.sqlite' | ||
20 | database_table_prefix: wallabag_ | ||
21 | database_socket: null | ||
22 | mailer_transport: smtp | ||
23 | mailer_host: 127.0.0.1 | ||
24 | mailer_user: null | ||
25 | mailer_password: null | ||
26 | locale: en | ||
27 | secret: ovmpmAWXRCabNlMgzlzFXDYmCFfzGv | ||
28 | twofactor_auth: true | ||
29 | twofactor_sender: no-reply@wallabag.org | ||
30 | fosuser_registration: true | ||
31 | fosuser_confirmation: true | ||
32 | from_email: no-reply@wallabag.org | ||
33 | rss_limit: 50 | ||
34 | rabbitmq_host: localhost | ||
35 | rabbitmq_port: 5672 | ||
36 | rabbitmq_user: guest | ||
37 | rabbitmq_password: guest | ||
38 | redis_scheme: tcp | ||
39 | redis_host: localhost | ||
40 | redis_port: 6379 | ||
41 | redis_path: null | ||
42 | |||
43 | Significato di ogni parametro | ||
44 | ----------------------------- | ||
45 | |||
46 | .. csv-table:: Parametri del database | ||
47 | :header: "nome", "default", "descrizione" | ||
48 | |||
49 | "database_driver", "pdo_sqlite", "Dovrebbe essere pdo_sqlite o pdo_mysql o pdo_pgsql" | ||
50 | "database_host", "127.0.0.1", "Host del vostro database (generalmente localhost o 127.0.0.1)" | ||
51 | "database_port", "~", "Porta del vostro database (potete lasciare ``~`` per usare quella di default)" | ||
52 | "database_name", "symfony", "Nome del vostro database" | ||
53 | "database_user", "root", "L'utente che puó scrivere su questo database" | ||
54 | "database_password", "~", "Password di quell'utente" | ||
55 | "database_path", "``""%kernel.root_dir%/../data/db/wallabag.sqlite""``", "Solo per SQLite, definite dove mettere il file del database. Lasciatelo vuoto se usate un altro database" | ||
56 | "database_table_prefix", "wallabag_", "Tutte le tavole di wallabag avranno quella stringa come prefisso. Potete includere un ``_`` per maggior chiarezza" | ||
57 | "database_socket", "null", "Se il vostro database usa un socket al posto di tcp, inserite il percorso del socket (altri parametri di connessione saranno ignorati)" | ||
58 | |||
59 | .. csv-table:: Configurazione per inviare email da wallabag | ||
60 | :header: "nome", "default", "descrizione" | ||
61 | |||
62 | "mailer_transport", "smtp", "Il metodo di trasporto esatto usato per consegnare email. Valori validi sono: smtp, gmail, mail, sendmail, null (ció disattiva il mailer)" | ||
63 | "mailer_host", "127.0.0.1", "L'host al quale connettersi quando si usa smtp come metodo di trasporto." | ||
64 | "mailer_user", "~", "Lo username quando si usa smtp come metodo di trasporto." | ||
65 | "mailer_password", "~", "La password quando si usa smtp come metodo di trasporto." | ||
66 | |||
67 | .. csv-table:: Altre opzioni di wallabag | ||
68 | :header: "nome", "default", "descrizione" | ||
69 | |||
70 | "locale", "en", "Lingua di default della vostra istanza di wallabag (come en, fr, es, etc.)" | ||
71 | "secret", "ovmpmAWXRCabNlMgzlzFXDYmCFfzGv", "Questa é una stringa che dovrebbe essere unica per la vostra applicazione ed é usata comunemente per aggiungere piú entropia alle operazioni di sicurezza." | ||
72 | "twofactor_auth", "true", "true per abilitare l'autenticazione a due fattori" | ||
73 | "twofactor_sender", "no-reply@wallabag.org", "Email del mittente per ricevere il codice a due fattori" | ||
74 | "fosuser_registration", "true", "true per abilitare la registrazione pubblica" | ||
75 | "fosuser_confirmation", "true", "true per inviare una mail di conferma per ogni registrazione" | ||
76 | "from_email", "no-reply@wallabag.org", "Indirizzo email usato nel campo Da: in ogni email" | ||
77 | "rss_limit", "50", "Limite per i feed RSS" | ||
78 | |||
79 | .. csv-table:: Configurazione di RabbitMQ | ||
80 | :header: "nome", "default", "descrizione" | ||
81 | |||
82 | "rabbitmq_host", "localhost", "Host del vostro RabbitMQ" | ||
83 | "rabbitmq_port", "5672", "Porta del vostro RabbitMQ" | ||
84 | "rabbitmq_user", "guest", "Utente che puó leggere le code" | ||
85 | "rabbitmq_password", "guest", "Password di quell'utente" | ||
86 | |||
87 | .. csv-table:: Configurazione di Redis | ||
88 | :header: "nome", "default", "descrizione" | ||
89 | |||
90 | "redis_scheme", "tcp", "Specifica il protocollo da usare per comunicare con una istanza di Redis. Valori validi sono: tcp, unix, http" | ||
91 | "redis_host", "localhost", "IP o hostname del server bersaglio (ignorato per lo schema unix)" | ||
92 | "redis_port", "6379", "Porta TCP/IP del server bersaglio (ignorato per lo schema unix)" | ||
93 | "redis_path", "null", "Percorso del file domain socket di UNIX usato quando ci si connette a Redis usando domain socket di UNIX" | ||
diff --git a/docs/ita/user/upgrade.rst b/docs/ita/user/upgrade.rst new file mode 100644 index 00000000..86122223 --- /dev/null +++ b/docs/ita/user/upgrade.rst | |||
@@ -0,0 +1,102 @@ | |||
1 | Aggiornate la vostra installazione di wallabag | ||
2 | ============================================== | ||
3 | |||
4 | Troverete qui i differenti modi per aggiornare il vostro wallabag: | ||
5 | |||
6 | - `da 2.0.x a 2.1.1 <#upgrade-from-2-0-x-to-2-1-1>`_ | ||
7 | - `da 2.1.x a 2.1.y <#upgrading-from-2-1-x-to-2-1-y>`_ | ||
8 | - `da 1.x a 2.x <#from-wallabag-1-x>`_ | ||
9 | |||
10 | Aggiornate da 2.0.x a 2.1.1 | ||
11 | --------------------------- | ||
12 | |||
13 | .. attenzione:: | ||
14 | |||
15 | prima di questa migrazione, se avete configurato l'importazione di Pocket aggiungendo la vostra consumer key nelle Impostazioni interne, si prega di farne un backup: dovrete aggiungere questa nella pagina di configurazione dopo l'aggiornamento. | ||
16 | |||
17 | Aggiornamento su un web server dedicato | ||
18 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | ||
19 | : | ||
20 | |||
21 | rm -rf var/cache/* | ||
22 | git fetch origin | ||
23 | git fetch --tags | ||
24 | git checkout 2.1.1 --force | ||
25 | SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist | ||
26 | php bin/console doctrine:migrations:migrate --env=prod | ||
27 | php bin/console cache:clear --env=prod | ||
28 | |||
29 | Aggiornamento su un hosting condiviso | ||
30 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | ||
31 | Fate un backup del file ``app/config/parameters.yml``. | ||
32 | Scaricate la versione 2.1.1 di wallabag: | ||
33 | |||
34 | .. code-block:: bash | ||
35 | |||
36 | wget http://framabag.org/wallabag-release-2.1.1.tar.gz && tar xvf wallabag-release-2.1.1.tar.gz | ||
37 | |||
38 | (hash md5 del pacchetto 2.1.1: ``9584a3b60a2b2a4de87f536548caac93``) | ||
39 | |||
40 | Estraete l'archivio nella vostra cartella di wallabag e sostituite ``app/config/parameters.yml`` con il vostro. | ||
41 | |||
42 | Controllate che il vostro ``app/config/parameters.yml`` contenga tutti i parametri richiesti. Potete trovare qui la documentazione sui parametri *link mancante*. | ||
43 | |||
44 | Se usate SQLite, dovete anche copiare la vostra cartella ``data/`` dentro la nuova installazione. | ||
45 | |||
46 | Svuotate la cartella ``var/cache``. | ||
47 | |||
48 | Dovete eseguire delle query di SQL per aggiornare il vostro database. Assumiamo che il prefisso della tabella sia ``wallabag_`` e che il database sia MySQL: | ||
49 | |||
50 | .. code-block:: sql | ||
51 | |||
52 | ALTER TABLE `wallabag_entry` ADD `uuid` LONGTEXT DEFAULT NULL; | ||
53 | INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('share_public', '1', 'entry'); | ||
54 | ALTER TABLE `wallabag_oauth2_clients` ADD name longtext COLLATE 'utf8_unicode_ci' DEFAULT NULL; | ||
55 | INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('import_with_redis', '0', 'import'); | ||
56 | INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('import_with_rabbitmq', '0', 'import'); | ||
57 | ALTER TABLE `wallabag_config` ADD `pocket_consumer_key` VARCHAR(255) DEFAULT NULL; | ||
58 | DELETE FROM `wallabag_craue_config_setting` WHERE `name` = 'pocket_consumer_key'; | ||
59 | |||
60 | Aggiornamento da 2.1.x a 2.1.y | ||
61 | ------------------------------ | ||
62 | |||
63 | Aggiornamento su un web server dedicato | ||
64 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | ||
65 | |||
66 | Per aggiornare la vostra installazione di wallabag ed ottenere l'ultima versione, eseguite il seguente comando nella vostra cartella wallabag: | ||
67 | |||
68 | :: | ||
69 | |||
70 | make update | ||
71 | |||
72 | Aggiornamento su un hosting condiviso | ||
73 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | ||
74 | |||
75 | Fate un backup del file ``app/config/parameters.yml``. | ||
76 | |||
77 | Scaricate l'ultima versione di wallabag: | ||
78 | |||
79 | . code-block:: bash | ||
80 | |||
81 | wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package | ||
82 | |||
83 | Troverete il `hash md5 dell'ultima versione del pacchetto sul nostro sito <https://www.wallabag.org/pages/download-wallabag.html>`_. | ||
84 | |||
85 | Estraete l'archivio nella vostra cartella di wallabag e rimpiazzate ``app/config/parameters.yml`` con il vostro. | ||
86 | |||
87 | Controllate che il vostro ``app/config/parameters.yml`` contenga tutti i parametri richiesti. | ||
88 | |||
89 | Potete trovare qui la documentazione sui parametri *link mancante*. | ||
90 | |||
91 | Se usate SQLite, dovete anche copiare la vostra cartella ``data/`` dentro la nuova installazione. | ||
92 | |||
93 | Svuotate la cartella ``var/cache``. | ||
94 | |||
95 | Da wallabag 1.x | ||
96 | --------------- | ||
97 | |||
98 | Non esiste uno script automatico per aggiornare da wallabag 1.x a wallabag 2.x. Dovete: | ||
99 | |||
100 | - esportare i vostri dati | ||
101 | - installare wallabag 2.x (leggete la documentazione a proposito dell'installazione *link mancante*) | ||
102 | - importate i dati in questa nuova installazione (leggete la documentazione a proposito dell'importazione) | ||