From 5601b4536cea2a4c5ebdd39251cc16ec92c01b1d Mon Sep 17 00:00:00 2001 From: matteocoder Date: Tue, 14 Feb 2017 16:36:40 +0100 Subject: Italian documentation added There are some missing links in various articles. Please let me know how I can fix this :) --- docs/ita/conf.py | 55 +++++ docs/ita/developer/api.rst | 269 +++++++++++++++++++++++++ docs/ita/developer/asynchronous.rst | 162 +++++++++++++++ docs/ita/developer/docker.rst | 41 ++++ docs/ita/developer/documentation.rst | 12 ++ docs/ita/developer/paywall.rst | 52 +++++ docs/ita/developer/testsuite.rst | 6 + docs/ita/developer/translate.rst | 55 +++++ docs/ita/index.rst | 52 +++++ docs/ita/requirements.txt | 2 + docs/ita/user/android.rst | 107 ++++++++++ docs/ita/user/articles.rst | 115 +++++++++++ docs/ita/user/backup.rst | 30 +++ docs/ita/user/configuration.rst | 104 ++++++++++ docs/ita/user/create_account.rst | 38 ++++ docs/ita/user/errors_during_fetching.rst | 37 ++++ docs/ita/user/faq.rst | 53 +++++ docs/ita/user/filters.rst | 45 +++++ docs/ita/user/import.rst | 115 +++++++++++ docs/ita/user/installation.rst | 333 +++++++++++++++++++++++++++++++ docs/ita/user/parameters.rst | 93 +++++++++ docs/ita/user/upgrade.rst | 102 ++++++++++ 22 files changed, 1878 insertions(+) create mode 100644 docs/ita/conf.py create mode 100644 docs/ita/developer/api.rst create mode 100644 docs/ita/developer/asynchronous.rst create mode 100644 docs/ita/developer/docker.rst create mode 100644 docs/ita/developer/documentation.rst create mode 100644 docs/ita/developer/paywall.rst create mode 100644 docs/ita/developer/testsuite.rst create mode 100644 docs/ita/developer/translate.rst create mode 100644 docs/ita/index.rst create mode 100644 docs/ita/requirements.txt create mode 100644 docs/ita/user/android.rst create mode 100644 docs/ita/user/articles.rst create mode 100644 docs/ita/user/backup.rst create mode 100644 docs/ita/user/configuration.rst create mode 100644 docs/ita/user/create_account.rst create mode 100644 docs/ita/user/errors_during_fetching.rst create mode 100644 docs/ita/user/faq.rst create mode 100644 docs/ita/user/filters.rst create mode 100644 docs/ita/user/import.rst create mode 100644 docs/ita/user/installation.rst create mode 100644 docs/ita/user/parameters.rst create mode 100644 docs/ita/user/upgrade.rst (limited to 'docs/ita') diff --git a/docs/ita/conf.py b/docs/ita/conf.py new file mode 100644 index 00000000..717b35f1 --- /dev/null +++ b/docs/ita/conf.py @@ -0,0 +1,55 @@ +# -*- coding: utf-8 -*- +# +# wallabag documentation build configuration file, created by +# sphinx-quickstart on Fri Oct 16 06:47:23 2015. + +import sys +import os + +extensions = [] +templates_path = ['_templates'] +source_suffix = '.rst' +master_doc = 'index' +project = u'wallabag' +copyright = u'2013-2016, Nicolas Lœuillet - MIT Licence' +version = '2.1.0' +release = version +exclude_patterns = ['_build'] +pygments_style = 'sphinx' +html_theme = 'default' +html_static_path = ['_static'] +htmlhelp_basename = 'wallabagdoc' +latex_elements = { + +} + +latex_documents = [ + ('index', 'wallabag.tex', u'wallabag Documentation', + u'Nicolas Lœuillet', 'manual'), +] + +man_pages = [ + ('index', 'wallabag', u'wallabag Documentation', + [u'Nicolas Lœuillet'], 1) +] + +texinfo_documents = [ + ('index', 'wallabag', u'wallabag Documentation', + u'Nicolas Lœuillet', 'wallabag', 'wallabag is an opensource read-it-later.', + 'Miscellaneous'), +] + +##### Guzzle sphinx theme + +import guzzle_sphinx_theme +html_translator_class = 'guzzle_sphinx_theme.HTMLTranslator' +html_theme_path = guzzle_sphinx_theme.html_theme_path() +html_theme = 'guzzle_sphinx_theme' + +# Custom sidebar templates, maps document names to template names. +html_sidebars = { + '**': ['logo-text.html', 'globaltoc.html', 'searchbox.html'] +} + +# Register the theme as an extension to generate a sitemap.xml +extensions.append("guzzle_sphinx_theme") diff --git a/docs/ita/developer/api.rst b/docs/ita/developer/api.rst new file mode 100644 index 00000000..fc19a175 --- /dev/null +++ b/docs/ita/developer/api.rst @@ -0,0 +1,269 @@ +Documentazione su API +--------------------- + +Grazie a questa documentazione, vedremo come interagire con l'API di wallabag. + +Requisiti +--------- + +* wallabag appena (o no) installato su http://localhost:8000 +* ``httpie`` installato sul vostro computer (`guardate il sito del progetto `__). Da notare che potete anche adattare i comandi usando curl o wget. +* tutti i metodi API documentati qui http://localhost:8000/api/doc (sulla vostra istanza) e `sulla nostra istanza d'esempio `_ + +Creare un nuovo client API +-------------------------- + +Sul vostro account wallabag potete creare un nuovo client API presso questo URL http://localhost:8000/developer/client/create. + +Date solamente l'URL per il reindirizzamento della vostra applicazione e create il vostro client. Se la vostra applicazione è desktop, inserite l'URL che preferite. + +Toverete informazioni come queste: + +:: + + Client ID: + + 1_3o53gl30vhgk0c8ks4cocww08o84448osgo40wgw4gwkoo8skc + + Client secret: + + 636ocbqo978ckw0gsw4gcwwocg8044sco0w8w84cws48ggogs4 + + +Ottenere un token per il ricaricamento +-------------------------------------- + +Per ogni chiamata API avrete bisogno di un token. Creiamolo con questo comando (rimpiazzate ``client_id``, ``client_secret``, ``username`` and ``password`` con i loro valori): + +:: + + http POST http://localhost:8000/oauth/v2/token \ + grant_type=password \ + client_id=1_3o53gl30vhgk0c8ks4cocww08o84448osgo40wgw4gwkoo8skc \ + client_secret=636ocbqo978ckw0gsw4gcwwocg8044sco0w8w84cws48ggogs4 \ + username=wallabag \ + password=wallabag + +Otterrete questo risultato: + +:: + + HTTP/1.1 200 OK + Cache-Control: no-store, private + Connection: close + Content-Type: application/json + Date: Tue, 05 Apr 2016 08:44:33 GMT + Host: localhost:8000 + Pragma: no-cache + X-Debug-Token: 19c8e0 + X-Debug-Token-Link: /_profiler/19c8e0 + X-Powered-By: PHP/7.0.4 + + { + "access_token": "ZGJmNTA2MDdmYTdmNWFiZjcxOWY3MWYyYzkyZDdlNWIzOTU4NWY3NTU1MDFjOTdhMTk2MGI3YjY1ZmI2NzM5MA", + "expires_in": 3600, + "refresh_token": "OTNlZGE5OTJjNWQwYzc2NDI5ZGE5MDg3ZTNjNmNkYTY0ZWZhZDVhNDBkZTc1ZTNiMmQ0MjQ0OThlNTFjNTQyMQ", + "scope": null, + "token_type": "bearer" + } + +Lavoreremo con il valore ``access_token`` nelle nostre prossime chiamate. + +esempio di cURL: + +:: + + curl -s "https://localhost:8000/oauth/v2/token?grant_type=password&client_id=1_3o53gl30vhgk0c8ks4cocww08o84448osgo40wgw4gwkoo8skc&client_secret=636ocbqo978ckw0gsw4gcwwocg8044sco0w8w84cws48ggogs4&username=wallabag&password=wallabag" + +Ottenere voci esistenti +----------------------- + +Documentazione per questo metodo: http://localhost:8000/api/doc#get--api-entries.{_format} + +Mentre lavoriamo su una nuova installazione di wallabag, non otterremo risultati con questo comando: + +:: + + http GET http://localhost:8000/api/entries.json \ + "Authorization:Bearer ZGJmNTA2MDdmYTdmNWFiZjcxOWY3MWYyYzkyZDdlNWIzOTU4NWY3NTU1MDFjOTdhMTk2MGI3YjY1ZmI2NzM5MA" + +restituisce: + +:: + + HTTP/1.1 200 OK + 0: application/json + Cache-Control: no-cache + Connection: close + Content-Type: application/json + Date: Tue, 05 Apr 2016 08:51:32 GMT + Host: localhost:8000 + Set-Cookie: PHPSESSID=nrogm748md610ovhu6j70c3q63; path=/; HttpOnly + X-Debug-Token: 4fbbc4 + X-Debug-Token-Link: /_profiler/4fbbc4 + X-Powered-By: PHP/7.0.4 + + { + "_embedded": { + "items": [] + }, + "_links": { + "first": { + "href": "http://localhost:8000/api/entries?page=1&perPage=30" + }, + "last": { + "href": "http://localhost:8000/api/entries?page=1&perPage=30" + }, + "self": { + "href": "http://localhost:8000/api/entries?page=1&perPage=30" + } + }, + "limit": 30, + "page": 1, + "pages": 1, + "total": 0 + } + +L'insieme ``items`` è vuoto. + +esempio di cURL: + +:: + + curl --get "https://localhost:8000/api/entries.html?access_token=ZGJmNTA2MDdmYTdmNWFiZjcxOWY3MWYyYzkyZDdlNWIzOTU4NWY3NTU1MDFjOTdhMTk2MGI3YjY1ZmI2NzM5MA" + +Aggiungere la vostra prima voce +------------------------------- + +Documentazione per questo metodo: http://localhost:8000/api/doc#post--api-entries.{_format} + +:: + + http POST http://localhost:8000/api/entries.json \ + "Authorization:Bearer ZGJmNTA2MDdmYTdmNWFiZjcxOWY3MWYyYzkyZDdlNWIzOTU4NWY3NTU1MDFjOTdhMTk2MGI3YjY1ZmI2NzM5MA" \ + url="http://www.numerama.com/tech/160115-le-pocket-libre-wallabag-fait-le-plein-de-fonctionnalites.html" + +restituisce: + +:: + + HTTP/1.1 200 OK + 0: application/json + Cache-Control: no-cache + Connection: close + Content-Type: application/json + Date: Tue, 05 Apr 2016 09:07:54 GMT + Host: localhost:8000 + Set-Cookie: PHPSESSID=bjie40ck72kp2pst3i71gf43a4; path=/; HttpOnly + X-Debug-Token: e01c51 + X-Debug-Token-Link: /_profiler/e01c51 + X-Powered-By: PHP/7.0.4 + + { + "_links": { + "self": { + "href": "/api/entries/1" + } + }, + "content": "

Fonctionnant sur le même principe que Pocket, Instapaper ou Readability, le logiciel Wallabag permet de mémoriser des articles pour les lire plus tard. Sa nouvelle version apporte une multitude de nouvelles fonctionnalités.

Si vous utilisez Firefox comme navigateur web, vous avez peut-être constaté l’arrivée d’une fonctionnalité intitulée Pocket. Disponible autrefois sous la forme d’un module complémentaire, et sous un autre nom (Read it Later), elle est depuis le mois de juin 2015 directement incluse au sein de Firefox.

\n

Concrètement, Pocket sert à garder en mémoire des contenus que vous croisez au fil de la navigation, comme des articles de presse ou des vidéos, afin de pouvoir les consulter plus tard. Pocket fonctionne un peu comme un système de favoris, mais en bien plus élaboré grâce à ses options supplémentaires.

\n

Mais Pocket fait polémique, car il s’agit d’un projet propriétaire qui est intégré dans un logiciel libre. C’est pour cette raison que des utilisateurs ont choisi de se tourner vers d’autres solutions, comme Wallabag, qui est l’équivalent libre de Pocket et d’autres systèmes du même genre, comme Instapaper et Readability.

\n

Et justement, Wallabag évolue. C’est ce dimanche que la version 2.0.0 du logiciel a été publiée par l’équipe en charge de son développement et celle-ci contient de nombreux changements par rapport aux moutures précédentes (la documentation est traduite en français), lui permettant d’apparaître comme une alternative à Pocket, Instapaper et Readability.

\n

\"homepage\"

\n

Parmi les principaux changements que l’on peut retenir avec cette nouvelle version, notons la possibilité d’écrire des annotations dans les articles mémorisés, de filtrer les contenus selon divers critères (temps de lecture, nom de domaine, date de création, statut…), d’assigner des mots-clés aux entrées, de modifier le titre des articles, le support des flux RSS ou encore le support de plusieurs langues dont le français.

\n

D’autres options sont également à signaler, comme l’aperçu d’un article mémorisé (si l’option est disponible), un guide de démarrage rapide pour les débutants, un outil d’export dans divers formats (PDF, JSON, EPUB, MOBI, XML, CSV et TXT) et, surtout, la possibilité de migrer vers Wallabag depuis Pocket, afin de convaincre les usagers de se lancer.

\n \n \n

Articles liés

\n
\n
\n", + "created_at": "2016-04-05T09:07:54+0000", + "domain_name": "www.numerama.com", + "id": 1, + "is_archived": 0, + "is_starred": 0, + "language": "fr-FR", + "mimetype": "text/html", + "preview_picture": "http://www.numerama.com/content/uploads/2016/04/post-it.jpg", + "reading_time": 2, + "tags": [], + "title": "Le Pocket libre Wallabag fait le plein de fonctionnalités - Tech - Numerama", + "updated_at": "2016-04-05T09:07:54+0000", + "url": "http://www.numerama.com/tech/160115-le-pocket-libre-wallabag-fait-le-plein-de-fonctionnalites.html", + "user_email": "", + "user_id": 1, + "user_name": "wallabag" + } + +Ora, se eseguite il comando precedente (vedere **Ottenere voci esistenti**), avrete dei dati. + +esempio di cURL: + +:: + + curl "https://localhost:8000/api/entries.html?access_token=ZGJmNTA2MDdmYTdmNWFiZjcxOWY3MWYyYzkyZDdlNWIzOTU4NWY3NTU1MDFjOTdhMTk2MGI3YjY1ZmI2NzM5MA&url=http://www.numerama.com/tech/160115-le-pocket-libre-wallabag-fait-le-plein-de-fonctionnalites.html" + +Eliminare una voce +------------------ + +Documentazione per questo metodo: http://localhost:8000/api/doc#delete--api-entries-{entry}.{_format} + +:: + + http DELETE http://localhost:8000/api/entries/1.json \ + "Authorization:Bearer ZGJmNTA2MDdmYTdmNWFiZjcxOWY3MWYyYzkyZDdlNWIzOTU4NWY3NTU1MDFjOTdhMTk2MGI3YjY1ZmI2NzM5MA" + +restituisce + +:: + + HTTP/1.1 200 OK + 0: application/json + Cache-Control: no-cache + Connection: close + Content-Type: application/json + Date: Tue, 05 Apr 2016 09:19:07 GMT + Host: localhost:8000 + Set-Cookie: PHPSESSID=jopgnfvmuc9a62b27sqm6iulr6; path=/; HttpOnly + X-Debug-Token: 887cef + X-Debug-Token-Link: /_profiler/887cef + X-Powered-By: PHP/7.0.4 + + { + "_links": { + "self": { + "href": "/api/entries/" + } + }, + "annotations": [], + "content": "

Fonctionnant sur le même principe que Pocket, Instapaper ou Readability, le logiciel Wallabag permet de mémoriser des articles pour les lire plus tard. Sa nouvelle version apporte une multitude de nouvelles fonctionnalités.

Si vous utilisez Firefox comme navigateur web, vous avez peut-être constaté l’arrivée d’une fonctionnalité intitulée Pocket. Disponible autrefois sous la forme d’un module complémentaire, et sous un autre nom (Read it Later), elle est depuis le mois de juin 2015 directement incluse au sein de Firefox.

\n

Concrètement, Pocket sert à garder en mémoire des contenus que vous croisez au fil de la navigation, comme des articles de presse ou des vidéos, afin de pouvoir les consulter plus tard. Pocket fonctionne un peu comme un système de favoris, mais en bien plus élaboré grâce à ses options supplémentaires.

\n

Mais Pocket fait polémique, car il s’agit d’un projet propriétaire qui est intégré dans un logiciel libre. C’est pour cette raison que des utilisateurs ont choisi de se tourner vers d’autres solutions, comme Wallabag, qui est l’équivalent libre de Pocket et d’autres systèmes du même genre, comme Instapaper et Readability.

\n

Et justement, Wallabag évolue. C’est ce dimanche que la version 2.0.0 du logiciel a été publiée par l’équipe en charge de son développement et celle-ci contient de nombreux changements par rapport aux moutures précédentes (la documentation est traduite en français), lui permettant d’apparaître comme une alternative à Pocket, Instapaper et Readability.

\n

\"homepage\"

\n

Parmi les principaux changements que l’on peut retenir avec cette nouvelle version, notons la possibilité d’écrire des annotations dans les articles mémorisés, de filtrer les contenus selon divers critères (temps de lecture, nom de domaine, date de création, statut…), d’assigner des mots-clés aux entrées, de modifier le titre des articles, le support des flux RSS ou encore le support de plusieurs langues dont le français.

\n

D’autres options sont également à signaler, comme l’aperçu d’un article mémorisé (si l’option est disponible), un guide de démarrage rapide pour les débutants, un outil d’export dans divers formats (PDF, JSON, EPUB, MOBI, XML, CSV et TXT) et, surtout, la possibilité de migrer vers Wallabag depuis Pocket, afin de convaincre les usagers de se lancer.

\n \n \n

Articles liés

\n
\n
\n", + "created_at": "2016-04-05T09:07:54+0000", + "domain_name": "www.numerama.com", + "is_archived": 0, + "is_starred": 0, + "language": "fr-FR", + "mimetype": "text/html", + "preview_picture": "http://www.numerama.com/content/uploads/2016/04/post-it.jpg", + "reading_time": 2, + "tags": [], + "title": "Le Pocket libre Wallabag fait le plein de fonctionnalités - Tech - Numerama", + "updated_at": "2016-04-05T09:07:54+0000", + "url": "http://www.numerama.com/tech/160115-le-pocket-libre-wallabag-fait-le-plein-de-fonctionnalites.html", + "user_email": "", + "user_id": 1, + "user_name": "wallabag" + } + +E se volete elencare le voci esistenti (vedere **Ottenere voci esistenti**), l'insieme è vuoto. + +esempio di cURL: + +:: + + curl --request DELETE "https://localhost:8000/api/entries/1.html?access_token=ZGJmNTA2MDdmYTdmNWFiZjcxOWY3MWYyYzkyZDdlNWIzOTU4NWY3NTU1MDFjOTdhMTk2MGI3YjY1ZmI2NzM5MA" + +Altri metodi +------------ + +Non scriveremo esempi per ogni metodo API. +Guardate l'elenco qui : http://localhost:8000/api/doc per ogni metodo conosciuto. + +Risorse di terze parti +---------------------- + +Alcune applicazioni o librerie usano le nostre API. Ecco una lista non esaustiva: + +- `Wrapper Java per l'API di wallabag `_ di Strubbl. +- `Libreria .NET per l'API di wallabag v2 `_ di Julian Oster. +- `API di Python per wallabag `_ di FoxMaSk, per il suo progetto `Trigger Happy `_. +- `Un plugin `_ creato per `Tiny Tiny RSS `_ questo usa l'API di wallabag v2. Di Josh Panter. +- `Wrapper Golang per l'API di wallabag `_ di Strubbl, per il suo progetto `wallabag-stats graph `_. diff --git a/docs/ita/developer/asynchronous.rst b/docs/ita/developer/asynchronous.rst new file mode 100644 index 00000000..d753bd23 --- /dev/null +++ b/docs/ita/developer/asynchronous.rst @@ -0,0 +1,162 @@ +Compiti Asincroni +================= + +Per avviare compiti asincroni (utile ad esempio per grandi importazioni), Possiamo usare RabbitMQ o Redis. + +Installare RabbitMQ per compiti asincroni +----------------------------------------- + +Requisiti +^^^^^^^^^ + +Dovete avere RabbitMQ installato sul vostro server. + +Installazione +^^^^^^^^^^^^^ + +.. code:: bash + + wget https://www.rabbitmq.com/rabbitmq-signing-key-public.asc + apt-key add rabbitmq-signing-key-public.asc + apt-get update + apt-get install rabbitmq-server + +Configurazione ed avvio +^^^^^^^^^^^^^^^^^^^^^^^ + +.. code:: bash + + rabbitmq-plugins enable rabbitmq_management # (useful to have a web interface, available at http://localhost:15672/ (guest/guest) + rabbitmq-server -detached + +Fermare RabbitMQ +^^^^^^^^^^^^^^^^ + +.. code:: bash + + rabbitmqctl stop + + +Configurare RabbitMQ in wallabag +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Modificate il vostro file ``app/config/parameters.yml`` per modificare la configurazione di RabbitMQ. Quella di default dovrebbe andare bene: + +.. code:: yaml + + rabbitmq_host: localhost + rabbitmq_port: 5672 + rabbitmq_user: guest + rabbitmq_password: guest + rabbitmq_prefetch_count: 10 # read http://www.rabbitmq.com/consumer-prefetch.html + +Abilitare RabbitMQ su wallabag +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Su Strumenti, nella sezione **Importa**, abilitate RabbitMQ (con il valore 1). + +Avviare RabbitMQ consumer +^^^^^^^^^^^^^^^^^^^^^^^^^ + +Dipendendo da quale servizio vogliate importare, dovrete abilitare uno (o più se volete supportare molti) o più cronjob: + +.. code:: bash + + # per importare da Pocket + bin/console rabbitmq:consumer -e=prod import_pocket -w + + # per importare da Readability + bin/console rabbitmq:consumer -e=prod import_readability -w + + # per importare da Instapaper + bin/console rabbitmq:consumer -e=prod import_instapaper -w + + # per importare da wallabag v1 + bin/console rabbitmq:consumer -e=prod import_wallabag_v1 -w + + # per importare da wallabag v2 + bin/console rabbitmq:consumer -e=prod import_wallabag_v2 -w + + # per importare da Firefox + bin/console rabbitmq:consumer -e=prod import_firefox -w + + # per importare da Chrome + bin/console rabbitmq:consumer -e=prod import_chrome -w + +Installare Redis per compiti asincroni +-------------------------------------- + +Per avviare compiti asincroni (utile ad esempio per grandi importazioni), Possiamo usare Redis. + +Requisiti +^^^^^^^^^ + +Dovete avere Redis installato sul vostro server. + +Installazione +^^^^^^^^^^^^^ + +.. code:: bash + + apt-get install redis-server + + +Avvio +^^^^^ + +Il server dovrebbe già essere attivo dopo l'installazione, altrimenti potete avviarlo usando: + +.. code:: bash + + redis-server + + +Configurare Redis su wallabag +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Modificate il vostro file ``app/config/parameters.yml`` per modificare la configurazione di Redis. Quella di default dovrebbe andare bene: + +.. code:: yaml + + redis_host: localhost + redis_port: 6379 + +Abilitare Redis su wallabag +^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Su Strumenti, nella sezione **Importa**, abilitate Redis (con il valore 1). + +Avviare Redis consumer +^^^^^^^^^^^^^^^^^^^^^^ + +Dipendendo da quale servizio vogliate importare, dovrete abilitare uno (o più se volete supportare molti) o più cronjob: + +.. code:: bash + + # per importare da Pocket + bin/console wallabag:import:redis-worker -e=prod pocket -vv >> /path/to/wallabag/var/logs/redis-pocket.log + + # per importare da Readability + bin/console wallabag:import:redis-worker -e=prod readability -vv >> /path/to/wallabag/var/logs/redis-readability.log + + # per importare da Instapaper + bin/console wallabag:import:redis-worker -e=prod instapaper -vv >> /path/to/wallabag/var/logs/redis-instapaper.log + + # per importare da wallabag v1 + bin/console wallabag:import:redis-worker -e=prod wallabag_v1 -vv >> /path/to/wallabag/var/logs/redis-wallabag_v1.log + + # per importare da wallabag v2 + bin/console wallabag:import:redis-worker -e=prod wallabag_v2 -vv >> /path/to/wallabag/var/logs/redis-wallabag_v2.log + + # per importare da Firefox + bin/console wallabag:import:redis-worker -e=prod firefox -vv >> /path/to/wallabag/var/logs/redis-firefox.log + + # per importare da Chrome + bin/console wallabag:import:redis-worker -e=prod chrome -vv >> /path/to/wallabag/var/logs/redis-chrome.log + +Se volete avviare l'importazione solamente per alcuni messaggi e non tutti, potete specificare questo numero (qui 12) e il programma si fermerà dopo il dodicesimo messaggio: + +.. code:: bash + + bin/console wallabag:import:redis-worker -e=prod pocket -vv --maxIterations=12 + diff --git a/docs/ita/developer/docker.rst b/docs/ita/developer/docker.rst new file mode 100644 index 00000000..f07df20d --- /dev/null +++ b/docs/ita/developer/docker.rst @@ -0,0 +1,41 @@ +Eseguite wallabag in docker-compose +=================================== + +Per eseguire la vostra propria istanza di sviluppo di wallabag, dovreste usare i file docker compose preconfigurati. + +Requisiti +--------- + +Assicuratevi di avere `Docker +` e `Docker +Compose `__ disponibili sul vostro sistema e aggiornati. + +Cambiate DBMS +------------- + +Per default, wallabag inizierá con un database SQLite. +Visto che wallabag supporta Postgresql e MySQL, i container di docker sono disponibili anche per questi. + +In ``docker-compose.yml``, per il DBMS scelto, togliete i commenti: + +- la definizione del container (blocco a livello root ``postgres`` o ``mariadb``) +- il link del container nel container``php`` +- il file env del container nel container ``php`` + +Per far continuare ad eseguire i comandi Symfony sul vostro host (come ``wallabag:install``), dovreste anche: + +- caricare i file env appropriati sulla vostra riga di comando, in modo che possano esistere variabili come ``SYMFONY__ENV__DATABASE_HOST``. +- creare un ``127.0.0.1 rdbms`` sul vostro file di sistema ``hosts`` + +Eseguite wallabag +----------------- + +#. Fate un fork o clonate il progetto +#. Modificate ``app/config/parameters.yml`` per rimpiazzare le proprietá di ``database_*`` con quelle commentate (con valori con prefisso ``env.``) +#. ``composer install`` per installare le dipendenze del progetto +#. ``php bin/console wallabag:install`` per creare lo schema +#. ``docker-compose up`` per eseguire i containers +#. Infine, andate su http://localhost:8080/ per trovare il vostro wallabag appena installato. + +Durante i vari passi potreste incontrare problemi di permessi UNIX, percorsi sbagliati nella cache generata, etc... +Operazioni come cambiare i file della cache o cambiare i proprietari dei file potrebbero essere richiesto frequentemente, per cui non abbiate paura! diff --git a/docs/ita/developer/documentation.rst b/docs/ita/developer/documentation.rst new file mode 100644 index 00000000..d4b63bb6 --- /dev/null +++ b/docs/ita/developer/documentation.rst @@ -0,0 +1,12 @@ +Contribuite a questa documentazione +=================================== + +Le fonti della nostra documentazione sono qui https://github.com/wallabag/wallabag/tree/master/docs + +Usiamo `ReadTheDocs +`__ per generarla. + +Le pagine sono scritte nel formato `Restructured Text +`__. Potete usare strumenti online come http://rst.aaroniles.net/ o http://rst.ninjs.org/ per vedere un'anteprima dei vostri articoli. + +Se create una nuova pagina, non scordatevi di modificare il file `index.rst `__ per aggiungere un link nella barra laterale. diff --git a/docs/ita/developer/paywall.rst b/docs/ita/developer/paywall.rst new file mode 100644 index 00000000..2c4e1bf7 --- /dev/null +++ b/docs/ita/developer/paywall.rst @@ -0,0 +1,52 @@ +Articoli dietro ad un paywall +============================= + +wallabag puó acquisire articoli da siti web che usano un sistema paywall + +Abilitate l'autenticazione paywall +---------------------------------- + +Su impostazioni interne, nella sezione **Articolo**, abilitate l'autenticazione per siti con paywall (con il valore 1). + +Configurate le credenziali in wallabag +-------------------------------------- + +Modificate il vostro file ``app/config/parameters.yml`` per modificare le credenziali per ogni sito con paywall. Ecco un esempio di alcuni siti francesi: + +.. code:: yaml + + sites_credentials: + mediapart.fr: {username: "myMediapartLogin", password: "mypassword"} + arretsurimages.net: {username: "myASILogin", password: "mypassword"} + +.. note:: + + These credentials will be shared between each user of your wallabag instance. + +Fate il parsing dei file di configurazione +------------------------------------------ + +Leggete `questa parte della documentazione *link mancante*` per capire i file di configurazione. + +Ogni file di configurazione del parsing deve essere migliorato aggiungendo ``requires_login``, ``login_uri``, ``login_username_field``, ``login_password_field`` e ``not_logged_in_xpath``. + +Fate attenzione, il modulo di login deve essere nel contenuto della pagina quando wallabag lo carica. É impossibile per wallab essere autenticato su un sito dove il modulo di login é caricato dopo la pagina (da ajax per esempio). + +``login_uri`` é l'URL di azione del modulo (l'attributo ``action`` del modulo). +``login_username_field`` é l'attributo ``name`` nel campo di login. +``login_password_field`` é l'attributo ``name`` nel campo password. + +Per esempio: + +.. code:: + + title://div[@id="titrage-contenu"]/h1[@class="title"] + body: //div[@class="contenu-html"]/div[@class="page-pane"] + + requires_login: yes + + login_uri: http://www.arretsurimages.net/forum/login.php + login_username_field: username + login_password_field: password + + not_logged_in_xpath: //body[@class="not-logged-in"] diff --git a/docs/ita/developer/testsuite.rst b/docs/ita/developer/testsuite.rst new file mode 100644 index 00000000..fdb72401 --- /dev/null +++ b/docs/ita/developer/testsuite.rst @@ -0,0 +1,6 @@ +Testsuite +========= +Per assicurare la qualità di sviluppo di wallabag, abbiamo scritto i test con `PHPUnit `_. +Se contribuite al progetto (traducendo l'applicazione, risolvendo i bug o aggiungendo nuove funzioni), si prega di scrivere i propri test. + +Per avviare la testsuite di wallabag dovete installare `ant `_. Poi, eseguite il comando ``make test``. \ No newline at end of file diff --git a/docs/ita/developer/translate.rst b/docs/ita/developer/translate.rst new file mode 100644 index 00000000..c0b8e265 --- /dev/null +++ b/docs/ita/developer/translate.rst @@ -0,0 +1,55 @@ +Tradurre wallabag +================= + +wallabag web app +---------------- + +File per la traduzione +~~~~~~~~~~~~~~~~~~~~~~ + +.. note:: + + Visto che wallabag é principalmente sviluppato da un team francese, si prega di considerare che la traduzione francese é la più aggiornata, e si prega di copiarla e di creare la vostra propria traduzione. + +Potete trovare qui i file per la traduzione: +https://github.com/wallabag/wallabag/tree/master/src/Wallabag/CoreBundle/Resources/translations. + +Dovrete creare ``messages.CODE.yml`` e ``validators.CODE.yml``, dove CODE é il codice ISO 639-1 della vostra lingua (`guardate wikipedia `__). + +Altri file da tradurre: + +- https://github.com/wallabag/wallabag/tree/master/app/Resources/CraueConfigBundle/translations. +- https://github.com/wallabag/wallabag/tree/master/src/Wallabag/UserBundle/Resources/translations. + +Dovete creare i file ``THE_TRANSLATION_FILE.CODE.yml``. + +File di configurazione +~~~~~~~~~~~~~~~~~~~~~~ + +Dovete modificare `app/config/config.yml +`__ per mostrare il vostro linguaggio nella pagina di configurazione di wallabag (per consentire agli utenti di passare a questa nuova traduzione). + +Nella sezione ``wallabag_core.languages``, dovete aggiungere una nuova linea con la vostra traduzione. Per esempio: + +:: + + wallabag_core: + ... + languages: + en: 'English' + fr: 'Français' + +Nella prima colonna (``en``, ``fr``, etc.), dovete aggiungere il codice ISO 639-1 della vostra lingua (vedete sopra). + +Nella seconda colonna, aggiungete solamente il nome della vostra lingua. + +documentazione di wallabag +-------------------------- + +.. note:: + Contrariamente alla web app, il linguaggio principale per la documentazione é l'inglese. + +I file della documentazione sono memorizzati qui: https://github.com/wallabag/wallabag/tree/master/docs + +Dovete rispettare la struttura della cartella ``en`` quando create la vostra traduzione. + diff --git a/docs/ita/index.rst b/docs/ita/index.rst new file mode 100644 index 00000000..32d175c7 --- /dev/null +++ b/docs/ita/index.rst @@ -0,0 +1,52 @@ +Documentazione di wallabag +-------------------------- + +.. image:: ../img/wallabag.png + :alt: wallabag logo + :align: center + +**wallabag** è un'applicazione read-it-later: salva una pagina web lasciando solamente il contenuto. Elementi come comandi di navigazione o pubblicità sono rimossi. + +La documentazione principale per quest'applicazione è organizzata in un paio di sezioni: + +* :ref:`user-docs` +* :ref:`dev-docs` + +La documentazione è disponibile anche in altre lingue: + +* `Documentation en français `_ +* `Dokumentation in Deutsch `_ +* `Documentation in English `_ + +.. _user-docs: + +.. toctree:: + :maxdepth: 2 + :caption: User documentation + + user/installation + user/upgrade + user/configuration + user/import + user/create_account + user/articles + user/errors_during_fetching + user/filters + user/tags + user/android + user/parameters + user/backup + user/faq + +.. _dev-docs: + +.. toctree:: + :maxdepth: 2 + :caption: Developer documentation + + developer/api + developer/docker + developer/paywall + developer/documentation + developer/translate + developer/asynchronous diff --git a/docs/ita/requirements.txt b/docs/ita/requirements.txt new file mode 100644 index 00000000..06fc8973 --- /dev/null +++ b/docs/ita/requirements.txt @@ -0,0 +1,2 @@ +Sphinx>=1.3.0,<1.4.0 +guzzle_sphinx_theme>=0.7.0,<0.8.0 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 @@ +Applicazione Android +==================== + +Scopo di questo documento +------------------------- + +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. + +Passi per configurare la vostra app +----------------------------------- + +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. + +.. image:: ../../img/user/android_welcome_screen.en.png + :alt: Welcome screen + :align: center + +Confermate semplicemente quel messaggio e verrete reindirizzati alla schermata delle impostazioni. + +.. image:: ../../img/user/android_configuration_screen.en.png + :alt: Settings screen + :align: center + +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. + +.. image:: ../../img/user/android_configuration_filled_in.en.png + :alt: Filled in settings + :align: center + +Dopo aver completato l'inserimento dei dati, premete il bottone Connection test e aspettate che il test finisca. + +.. image:: ../../img/user/android_configuration_connection_test.en.png + :alt: Connection test with your wallabag data + :align: center + +Il test di connessione dovrebbe finire con successo. In caso contrario, dovrete prima risolvere questo problema fino a che possiate procedere. + +.. image:: ../../img/user/android_configuration_connection_test_success.en.png + :alt: Connection test successful + :align: center + +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. + +.. image:: ../../img/user/android_configuration_get_feed_credentials.en.png + :alt: Getting the feed credentials + :align: center + +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. + +.. image:: ../../img/user/android_configuration_feed_credentials_automatically_filled_in.en.png + :alt: Getting feed credentials successful + :align: center + +Ora dovrete scorrere fino alla fine del menu delle impostazioni. Ovviamente potrete cambiare le impostazioni in base alle vostre preferenze. +Terminate la configurazione della vostra app premendo il bottone per il salvataggio. + +.. image:: ../../img/user/android_configuration_scroll_bottom.en.png + :alt: Bottom of the settings screen + :align: center + +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í. + +.. image:: ../../img/user/android_configuration_saved_feed_update.en.png + :alt: Settings saved the first time + :align: center + +Alla fine, dopo che la sincronizzazione sará avvenuta con successo, apparirá la lista degli articoli non letti. + +.. image:: ../../img/user/android_unread_feed_synced.en.png + :alt: Filled article list cause feeds successfully synchronized + :align: center + +Limiti conosciuti +----------------- + +Autenticazione a due fattori (2FA) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Attualmente l'applicazione Android non supporta l'autenticazione a due fattori. Dovreste disabilitare questa opzione in modo da far funzionare l'applicazione. + +Quantitá limitata di articoli con wallabag v2 +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +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. + +Crittografia SSL/TLS +~~~~~~~~~~~~~~~~~~~~ + +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. + +Riferimenti +----------- + +- `Codice sorgente dell'applicazione Android `_ +- `Applicazione Android su F-Droid `_ +- `Applicazione Android su Google Play `_ + + + + + + + + + + + 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 @@ + +Articoli +======== + +Salvate il vostro primo articolo +-------------------------------- + +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`_. + +Usando un bookmarklet +^^^^^^^^^^^^^^^^^^^^^ + +Nella pagina ``Howto`` avete una sezione ``Bookmarklet``. Trascinate il link ``bag it!`` sulla barra dei preferiti del vostro browser. + + +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. + +Usando la maniera classica +^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Sulla barra in alto del vostro schermo avete 3 icone. Con la prima, un simbolo "piú", potrete salvare facilmente un articolo. + +.. image:: ../../img/user/topbar.png + :alt: Top bar + :align: center + +Cliccateci sopra per mostrare un nuovo campo, inserite in quest'ultimo la URL dell'articolo e premete il tasto ``Return``. L'articolo é salvato. + +Usando un add-on del browser +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Firefox +""""""" + +Potete scaricare `qui l'addon per Firefox `_. + +Chrome +"""""" + +Potete scaricare `qui l'addon per Chrome `_. + +Usando la vostra applicazione per smartphone +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Android +""""""" + +Potete scaricare `qui l'applicazione per Android `_. + +Windows Phone +""""""""""""" + +Potete scaricare `qui l'applicazione per Windows Phone `_. + +Scaricate i vostri articoli +--------------------------- + +Potete scaricare ogni articolo in vari formati: ePUB, MOBI, PDF, XML, JSON, CSV. + +Sulla vista dell'articolo, cliccate su questa icona, nella barra laterale: + +.. image:: ../../img/user/download_article.png + :alt: download article + :align: center + +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: + +.. image:: ../../img/user/download_articles.png + :alt: download articles + :align: center + +Condividete i vostri articoli +----------------------------- + +Quando leggete un articolo, potete condividerlo. Cliccate semplicemente sul bottone di condivisione: + +.. image:: ../../img/user/share.png + :alt: share article + :align: center + +Ora potete condividere l'articolo: + +- attraverso una URL pubblica (avrete una vista semplificata dell'articolo) +- attraverso un tweet +- nel vostro Shaarli +- attraverso un post su Diaspora* +- su Carrot +- attraverso un'email + +Annotate i vostri articoli +-------------------------- + +in ogni articolo che leggiate potete scrivere delle note. É piú facile da capire con delle immagini. + +Selezionate la parte dell'articolo che volete annotare e cliccate sulla matita: + +.. image:: ../../img/user/annotations_1.png + :alt: Select your text + :align: center + +Scrivete poi la vostra nota: + +.. image:: ../../img/user/annotations_2.png + :alt: Write your annotation + :align: center + +Il testo é ora sottolineato e potrete leggere la vostra nota muovendo il cursore su di esso. + +.. image:: ../../img/user/annotations_3.png + :alt: Read your annotation + :align: center + +Potete creare quante note vogliate. + + 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 @@ +Eseguire il backup di wallabag +============================== + +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. + +Impostazioni base +----------------- + +wallabag memorizza alcuni parametri base (come il server SMTP o il backend del database) nel file `app/config/parameters.yml`. + +Database +-------- + +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. + +Ecco alcuni esempi: + +- MySQL: http://dev.mysql.com/doc/refman/5.7/en/backup-methods.html +- PostgreSQL: https://www.postgresql.org/docs/current/static/backup.html + +SQLite +~~~~~~ + +Per eseguire il backup di un database SQLite, dovete semplicemente copiare la directory `data/db` dalla directory dell'applicazione wallabag. + +Immagini +-------- + +Le immagini recuperate da wallabag sono memorizzate in `web/assets/images` (la memoria delle immagini sará implementata in wallabag 2.2). + 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 @@ +Configurazione +============== + +Ora che siete acceduti, é ora di configurare il vostro account come volete. + +cliccate sul menu ``Configurazione``. Avrete cinque tab: ``Impostazioni``, ``RSS``, ``Informazioni utente``, ``Password`` e ``Regole di tagging``. + +Impostazioni +------------ + +Tema +~~~~ + +wallabag é personalizzabile. Potete scegliere il vostro tema preferito qui. Il tema di default é ``Material``, é il tema usato nelle immagini della documentazione. + +Oggetti per pagina +~~~~~~~~~~~~~~~~~~ + +Potete cambiare il numero di articoli mostrati su ogni pagina. + +Velocitá di lettura +~~~~~~~~~~~~~~~~~~~ + +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. + +Lingua +~~~~~~ + +Potete cambiare la lingua dell'interfaccia di wallabag. + +RSS +--- + +wallabag offre feed RSS per ogni stato dell'articolo: non letto, preferito e archiviato. + +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``. + +Ora avrete tre link, uno per ogni stato: aggiungeteli al vostro lettore RSS preferito. + +Potete anche definire quanti articoli volete nel vostro feed RSS (valore di default: 50)- + +Informazioni dell'utente +------------------------ + +Potete cambiare il vostro nome, il vostro indirizzo email e abilitare l'``Autenticazione a due fattori``. + +Autenticazione a due fattori (2FA) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +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. + +https://it.wikipedia.org/wiki/Autenticazione_a_due_fattori + +Se abilitate la 2FA, ogni volta che vogliate accedere a wallabag, riceverete un codice via email. Dovrete inserire il codice nel seguente modulo. + +.. image:: ../../img/user/2FA_form.png + :alt: Two factor authentication + :align: center + +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. + +Password +-------- + +Qui potete cambiare la password (minimo 8 caratteri) + +Regole di tagging +----------------- + +Se volete assegnare un tag ai nuovi articoli, questa parte della configurazione fa per voi. + +Cosa significa « regole di tagging » ? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +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. + +Come le uso? +~~~~~~~~~~~~ + +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** +e *« lettura corta »* nel campo **Tag**. Molte etichette possono essere aggiunte simultaneamente separandole con una virgola: *« lettura corta, da leggere »*. +Si possono scrivere regole complesse usando gli operatori predefiniti: +se *« readingTime >= 5 AND domainName = "github.com" »* allora etichetta come *« lettura lunga, github »*. + +Quali variabili ed operatori posso usare per scrivere le regole? + +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"``): + +=========== ============================================== ========= =========== +Variabile Significato Operatore Significato +----------- ---------------------------------------------- --------- ----------- +title Titolo dell'articolo <= Minore di… +url URL dell'articolo < Strettamente minore di… +isArchived Se l'articolo é archiviato o no => Maggiore di… +isStarred Se l'articolo é preferito o no > Strettamente maggiore di… +content Il contenuto dell'articolo = Uguale a… +language La lingua dell'aritcolo != Diverso da… +mimetype The entry's mime-type OR Una regola o l'altra +readingTime Il tempo di lettura dell'articolo stimato AND Una regola e l'altra +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" +=========== ============================================== ======== ========== + + + 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 @@ +Creazione di un account e autenticazione +======================================== + +Registrazione +------------- + +Sulla pagina di login, cliccate sul bottone ``Register`` + +.. image:: ../../img/user/registration_form.png + :alt: Registration form + :align: center + +Dovrete completare il modulo. Assicuratevi di inserire un indirizzo email valido, quindi vi invieremo un'email di attivazione. + +.. image:: ../../img/user/sent_email.png + :alt: Email was sent to activate account + :align: center + +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. + +Il vostro account é ora attivo + +.. image:: ../../img/user/activated_account.png + :alt: Welcome on board! + :align: center + +Login +----- + +Il vostro account é ora abilitato, congratulazioni! + +Se siete sul vostro computer personale e volete restare connessi, spuntate la casella ``Keep me logged in``: wallabag vi ricorderá per un anno. + +.. image:: ../../img/user/login_form.png + :alt: Login form + :align: center + + 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 @@ + +Errori durante l'ottenimento degli articoli +=========================================== + +Perché l'ottenimento di un articolo fallisce? +--------------------------------------------- + +Ci possono essere varie ragioni: + +- problema del network +- wallabag non può ottenere il contenuto a causa della struttura del sito web + +Potete provare a risolvere il problema da soli ( in modo che noi possiamo concentrarci nel migliorare wallabag internamente invece di scrivere siteconfig +:) ). + +Potete provare a vedere se funziona qui: `http://f43.me/feed/test `_ (usa quasi lo stesso sistema per ottenere contenuto). + +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). + +Se non funziona, provate a estrarre un site config usando: `http://siteconfig.fivefilters.org/ `_ (seleziona quale parte del contenuto é effettivamente contenuto). Potete `leggere prima questa documentazione `_. + +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. + +Ripetete finché non avrete qualcosa di buono. + +Potete poi inviare una pull request a `https://github.com/fivefilters/ftr-site-config `_ il quale é il repository ufficiale per i file siteconfig. + +Come posso provare a riottenere questo articolo? +------------------------------------------------ + +Se wallabag ha fallito a ottenere l'articolo, potete cliccare sul bottone di ricaricamento (il terzo bottone nella figura sottostante). + +.. image:: ../../img/user/refetch.png + :alt: Refetch content + :align: center + + 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 @@ +Domande frequenti +================= + +Durante l'installazione ho riscontrato l'errore ``Error Output: sh: 1: @post-cmd: not found`` +--------------------------------------------------------------------------------------------- + +Sembra che ci sia un problema con la vostra installazione di ``composer``. Provate a disinstallarlo e reinstallarlo. + +`Leggete la documentazione su composer per sapere come installarlo +`__. + +Non riesco a convalidare il modulo di registrazione +--------------------------------------------------- + +Assicuratevi che tutti i campi siano riempiti correttamente: + +* indirizzo email valido +* stessa password nei due campi + +Non riesco a ricevere la mia mail di attivazione +------------------------------------------------ + +Siete sicuri che il vostro indirizzo email sia corretto? avete controllato la cartella di spam? + +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: + +:: + + firewall-cmd --permanent --add-service=smtp + firewall-cmd --reload + +Infine, se avete SELinux abilitato, impostate la seguente regola: + +``setsebool -P httpd_can_sendmail 1`` + +Quando clicco il link di attivazione, mi appare questo messaggio: ``L'utente con token di conferma "DtrOPfbQeVkWf6N" non esiste``. +---------------------------------------------------------------------------------------------------------------------------------- + +Avete giá attivato il vostro account oppure l'URL dell'email di attivazione é sbagliato. + +Ho dimenticato la mia password +------------------------------ + +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. + +Ho riscontrato l'errore ``failed to load external entity`` cercando di installare wallabag +------------------------------------------------------------------------------------------ + +Come descritto `qui `_, modificate il vostro file ``web/app.php`` ed aggiungete questa linea: ``libxml_disable_entity_loader(false);`` sulla linea 5. + +Questo é un bug di Doctrine / PHP, non possiamo farci nulla. + + 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 @@ +Trovate i vostri articoli grazie ai filtri +------------------------------------------ + +Per trovare facilmente gli articoli, potete usare i filtri. + +.. image:: ../../img/user/topbar.png + :alt: Top bar + :align: center + +Tutti questi filtri possono essere combinati. + +.. image:: ../../img/user/filters.png + :alt: Combine all filters + :align: center + +Stato +----- + +Usate queste caselle per trovare articoli archiviati o preferiti. + +Immagine di anteprima +--------------------- + +Selezionate questo filtro se volete trovare articoli con un'immagine di anteprima. + +Lingua +------ + +wallabag (attraverso graby) puó individuare la lingua di un articolo. É facile per voi trovare articoli scritti in una lingua specifica. + +Tempo di lettura +---------------- + +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. + +Nome di dominio +--------------- + +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. + +Data di creazione +----------------- + +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. + 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 @@ +Migrare da... +============= + +In wallabag 2.x, potete importare dati da: + +- `Pocket <#id1>`_ +- `Readability <#id2>`_ +- `Instapaper <#id4>`_ +- `wallabag 1.x <#id6>`_ +- `wallabag 2.x <#id7>`_ + +Abbiamo anche sviluppato `uno script per eseguire migrazioni tramite la linea di comando <#import-via-command-line-interface-cli>`_. + +Poiché le importazioni possono richiedere molto tempo, abbiamo sviluppato un sistema di compiti asincroni. *inserisci qui link una volta tradotto articolo su asynchronous* + +Pocket +------ + +Creare una nuova applicazione su Pocket +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Per importare dati da Pocket usiamo l'API di Pocket. Dovete creare una nuova applicazione sul loro sito per sviluppatori per continuare. + +* Create una nuova applicazione `sul sito per sviluppatori `_ +* 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 + +Pocket vi dará una **Consumer Key** (per esempio, `49961-985e4b92fe21fe4c78d682c1`). Dovete configurare la ``pocket_consumer_key`` dal menu ``Config``. + +Ora é tutto pronto per migrare da Pocket. + +Importate i vostri dati su wallabag 2.x +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Cliccate sul link `Importa` nel menu, su `Importa contenuti` nella sezione Pocket e poi su ``Connetti a Pocket ed importa i dati`` + +Dovete autorizzare wallabag a interagire con il vostro account Pocket. +I vostri dati saranno importati. L'importazione di dati puó essere un processo esigente per il vostro server. + +Instapaper +---------- + +Esportate i vostri dati di Instapaper +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Sulla pagina delle impostazioni (`https://www.instapaper.com/user `_), cliccate su "Download .CSV file" nella sezione "Export". Verrá scaricato un file CSV (like ``instapaper-export.csv``). + +Importate i vostri dati in wallabag 2.x +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Cliccate sul link `Importa` sul menu, poi su `Importa contenuti` nella sezione di Instapaper, quindi selezionate il vostro file CSV e caricatelo. + +I vostri dati saranno importati. L'importazione di dati puó essere un'operazione esigente per il server. + +wallabag 1.x +------------ + +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. + +.. image:: ../../img/user/export_v1.png + :alt: Exporting from wallabag v1 + :align: center + +.. nota:: + Se avete account multipli nella stessa istanza di wallabag, ogni utente dovrá esportare da v1 ed importare su v2. + +.. nota:: + Se riscontrate problemi durante l'importazione o l'esportazione, non esitate a `chiedere supporto `__. + +Quando avrete ottenuto il file json contenente i vostri articoli, potrete installare wallabag v2 seguendo, se necessario, `la procedura standard *link mancante*. + +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. + +.. image:: ../../img/user/import_wallabagv1.png + :alt: Import from wallabag v1 + :align: center + +wallabag 2.x +------------ + +Dalla istanza di wallabag precedente sulla quale eravate prima, andate su `Tutti gli articoli`, poi esportate questi articoli come json. + +.. image:: ../../img/user/export_v2.png + :alt: Export depuis wallabag v2 + :align: center + +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. + +.. nota:: + Se riscontrate problemi durante l'importazione o l'esportazione, non esitate a `chiedere supporto `__. + +Importate dall'interfaccia a riga di comando (CLI) +-------------------------------------------------- + +Se avete un accesso CLI al vostro server web, potete eseguire questo comando per importare ció che avete esportato da wallabag v1: + +:: + + bin/console wallabag:import 1 ~/Downloads/wallabag-export-1-2016-04-05.json --env=prod + +Rimpiazzate i valori: + +* ``1`` é l'identificatore utente nel database (l'ID del primo utente creato su wallabag é 1) +* ``~/Downloads/wallabag-export-1-2016-04-05.json`` é il percorso del file esportato da wallabag v1 + +Se volete segnare tutti questi articoli come giá letti, potete aggiungere l'opzione ``--markAsRead``. +Per importare un file di wallabag v2, dovete aggiungere l'opzione ``--importer=v2``. + +Come risultato avrete questo messaggio: + +:: + + Start : 05-04-2016 11:36:07 --- + 403 imported + 0 already saved + 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 @@ + + +Installa wallabag +================= + +Requisiti +--------- +wallabag é compatibile con PHP >= 5.5, incluso PHP 7. + +.. nota:: + + Per installare facilmente wallabag vi forniamo un Makefile, dunque avrete bisogno dello strumento make. + +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). + +Installa Composer: + +:: + curl -s http://getcomposer.org/installer | php + +`Qui `__ puoi trovare istruzioni specifiche. + +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. + +- php-session +- php-ctype +- php-dom +- php-hash +- php-simplexml +- php-json +- php-gd +- php-mbstring +- php-xml +- php-tidy +- php-iconv +- php-curl +- php-gettext +- php-tokenizer +- php-bcmath + +wallabag usa PDO per connettersi, per cui avrete bisogno di uno dei seguenti: + +-pdo_mysql +-pdo_sqlite +-pdo_pgsql + +E il corrispondente database server. + +Installazione +------------- + +Su un web server dedicato (raccomandato) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Per installare wallabag stesso dovete eseguire i seguenti comandi: + +:: + + git clone https://github.com/wallabag/wallabag.git + cd wallabag && make install + +Per attivare il server incorporato di PHP e verificare che l’installazione sia andata a buon fine potete eseguire: + +:: + + make run + +E accedere a wallabag all’indirizzo http://ipdeltuoserver:8000 + +.. consiglio:: + + 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 `__ per maggiori informazioni. + +A proposito di hosting condiviso +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +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. + +Abbiamo giá creato un utente: il login e la password sono wallabag. + +.. attenzione: + + 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). + +Eseguite questo comando per scaricare ed estrarre il pacchetto piú aggiornato: + +.. code-block:: bash + + wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package + +Troverete il `hash md5 del pacchetto piú aggiornato sul nostro sito `_. + +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 . + +Installazione con Docker +~~~~~~~~~~~~~~~~~~~~~~~~ + +Offriamo un’immagine Docker per installare wallabag facilmente. Guarda la nostra repository su `Docker Hub `__ per maggiori informazioni. + +Comando per avviare il container + +.. code-block:: bash + + docker pull wallabag/wallabag + + +Host virtuali +------------- + +Configurazione su Apache +~~~~~~~~~~~~~~~~~~~~~~~~ + +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: + +:: + + + ServerName domain.tld + ServerAlias www.domain.tld + + DocumentRoot /var/www/wallabag/web + + AllowOverride None + Order Allow,Deny + Allow from All + + + Options -MultiViews + RewriteEngine On + RewriteCond %{REQUEST_FILENAME} !-f + RewriteRule ^(.*)$ app.php [QSA,L] + + + + # uncomment the following lines if you install assets as symlinks + # or run into problems when compiling LESS/Sass/CoffeScript assets + # + # Options FollowSymlinks + # + + # optionally disable the RewriteEngine for the asset directories + # which will allow apache to simply reply with a 404 when files are + # not found instead of passing the request into the full symfony stack + + + RewriteEngine Off + + + ErrorLog /var/log/apache2/wallabag_error.log + CustomLog /var/log/apache2/wallabag_access.log combined + + +Dopo aver riavviato o ricaricato Apache dovreste essere in grado di accedere a wallabag tramite l’indirizzo http://domain.tld. + +Configurazione su Nginx +~~~~~~~~~~~~~~~~~~~~~~~ + +Assumendo che abbiate installato wallabag nella cartella ``/var/www/wallabag``, ecco una ricetta per l’applicazione: + +:: + + server { + server_name domain.tld www.domain.tld; + root /var/www/wallabag/web; + + location / { + # try to serve file directly, fallback to app.php + try_files $uri /app.php$is_args$args; + } + location ~ ^/app\.php(/|$) { + fastcgi_pass unix:/var/run/php5-fpm.sock; + fastcgi_split_path_info ^(.+\.php)(/.*)$; + include fastcgi_params; + # When you are using symlinks to link the document root to the + # current version of your application, you should pass the real + # application path instead of the path to the symlink to PHP + # FPM. + # Otherwise, PHP's OPcache may not properly detect changes to + # your PHP files (see https://github.com/zendtech/ZendOptimizerPlus/issues/126 + # for more information). + fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name; + fastcgi_param DOCUMENT_ROOT $realpath_root; + # Prevents URIs that include the front controller. This will 404: + # http://domain.tld/app.php/some-path + # Remove the internal directive to allow URIs like this + internal; + } + + # return 404 for all other php files not matching the front controller + # this prevents access to other php files you don't want to be accessible. + location ~ \.php$ { + return 404; + } + + error_log /var/log/nginx/wallabag_error.log; + access_log /var/log/nginx/wallabag_access.log; + } + + +Dopo aver riavviato o ricaricato Nginx dovreste essere in grado di accedere a wallabag tramite l’indirizzo http://domain.tld. + +Configurazione su lighttpd +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +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): + +:: + + server.modules = ( + "mod_fastcgi", + "mod_access", + "mod_alias", + "mod_compress", + "mod_redirect", + "mod_rewrite", + ) + server.document-root = "/var/www/wallabag/web" + server.upload-dirs = ( "/var/cache/lighttpd/uploads" ) + server.errorlog = "/var/log/lighttpd/error.log" + server.pid-file = "/var/run/lighttpd.pid" + server.username = "www-data" + server.groupname = "www-data" + server.port = 80 + server.follow-symlink = "enable" + index-file.names = ( "index.php", "index.html", "index.lighttpd.html") + url.access-deny = ( "~", ".inc" ) + static-file.exclude-extensions = ( ".php", ".pl", ".fcgi" ) + compress.cache-dir = "/var/cache/lighttpd/compress/" + compress.filetype = ( "application/javascript", "text/css", "text/html", "text/plain" ) + include_shell "/usr/share/lighttpd/use-ipv6.pl " + server.port + include_shell "/usr/share/lighttpd/create-mime.assign.pl" + include_shell "/usr/share/lighttpd/include-conf-enabled.pl" + dir-listing.activate = "disable" + + url.rewrite-if-not-file = ( + "^/([^?]*)(?:\?(.*))?" => "/app.php?$1&$2", + "^/([^?]*)" => "/app.php?=$1", + ) + + +Diritti di accesso alle cartelle del progetto +--------------------------------------------- + +Ambiente di test +~~~~~~~~~~~~~~~~ + +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. + +Ambiente di produzione +~~~~~~~~~~~~~~~~~~~~~~ + +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. + +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). + +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. + +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: + +.. code-block:: bash + + chown -R www-data:www-data /var/www/wallabag/var + + +Deve essere tutto uguale per le seguenti cartelle: + +* /var/www/wallabag/bin/ +* /var/www/wallabag/app/config/ +* /var/www/wallabag/vendor/ +* /var/www/wallabag/data/ + +inserendo + +.. code-block:: bash + + chown -R www-data:www-data /var/www/wallabag/bin + chown -R www-data:www-data /var/www/wallabag/app/config + chown -R www-data:www-data /var/www/wallabag/vendor + chown -R www-data:www-data /var/www/wallabag/data/ + +Altrimenti prima o poi incontreremo questi messaggi di errore: + +.. code-block:: bash + + Unable to write to the "bin" directory. + file_put_contents(app/config/parameters.yml): failed to open stream: Permission denied + file_put_contents(/.../wallabag/vendor/autoload.php): failed to open stream: Permission denied + +Regole aggiuntive per SELinux +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +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: + +``getenforce`` + +Questo mostrerá ``Enforcing`` se SELinux é abilitato. Creare un nuovo contesto coinvolge la seguente sintassi: + +``semanage fcontext -a -t `` + +Per esempio: + +``semanage fcontext -a -t httpd_sys_content_t "/var/www/wallabag(/.*)?"`` + +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: + ++-----------------------------------+----------------------------+ +| Percorso completo | Contesto | ++===================================+============================+ +| /var/www/wallabag(/.*)? | ``httpd_sys_content_t`` | ++-----------------------------------+----------------------------+ +| /var/www/wallabag/data(/.*)? | ``httpd_sys_rw_content_t`` | ++-----------------------------------+----------------------------+ +| /var/www/wallabag/var/logs(/.*)? | ``httpd_log_t`` | ++-----------------------------------+----------------------------+ +| /var/www/wallabag/var/cache(/.*)? | ``httpd_cache_t`` | ++-----------------------------------+----------------------------+ + +Dopo aver creato questi contesti, inserite ció che segue per applicare le vostre regole: + +``restorecon -R -v /var/www/wallabag`` + +Potrete controllare i contesti in una cartella scrivendo ``ls -lZ`` e potrete vedere tutte le regole correnti con ``semanage fcontext -l -C``. + +Se state installando il pacchetto latest-v2-package, é necessaria un'ulteriore regola durante la configurazione iniziale: + +``semanage fcontext -a -t httpd_sys_rw_content_t "/var/www/wallabag/var"`` + +Dopo che siate acceduti con successo al vostro wallabag e abbiate completato la configurazione iniziale, questo contesto puó essere rimosso: + +:: + + semanage fcontext -d -t httpd_sys_rw_content_t "/var/www/wallabag/var" + 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 @@ +Qual'é il significato dei parametri? +==================================== + +File `parameters.yml` di default +-------------------------------- + +Ecco l'ultima versione del file `app/config/parameters.yml` di default. Assicuratevi che la vostra rispetti questa. +Se non sapete quale parametro dovete impostare, si prega di lasciare quello di default. + +.. code-block:: yml + + parameters: + database_driver: pdo_sqlite + database_host: 127.0.0.1 + database_port: null + database_name: symfony + database_user: root + database_password: null + database_path: '%kernel.root_dir%/../data/db/wallabag.sqlite' + database_table_prefix: wallabag_ + database_socket: null + mailer_transport: smtp + mailer_host: 127.0.0.1 + mailer_user: null + mailer_password: null + locale: en + secret: ovmpmAWXRCabNlMgzlzFXDYmCFfzGv + twofactor_auth: true + twofactor_sender: no-reply@wallabag.org + fosuser_registration: true + fosuser_confirmation: true + from_email: no-reply@wallabag.org + rss_limit: 50 + rabbitmq_host: localhost + rabbitmq_port: 5672 + rabbitmq_user: guest + rabbitmq_password: guest + redis_scheme: tcp + redis_host: localhost + redis_port: 6379 + redis_path: null + +Significato di ogni parametro +----------------------------- + +.. csv-table:: Parametri del database + :header: "nome", "default", "descrizione" + + "database_driver", "pdo_sqlite", "Dovrebbe essere pdo_sqlite o pdo_mysql o pdo_pgsql" + "database_host", "127.0.0.1", "Host del vostro database (generalmente localhost o 127.0.0.1)" + "database_port", "~", "Porta del vostro database (potete lasciare ``~`` per usare quella di default)" + "database_name", "symfony", "Nome del vostro database" + "database_user", "root", "L'utente che puó scrivere su questo database" + "database_password", "~", "Password di quell'utente" + "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" + "database_table_prefix", "wallabag_", "Tutte le tavole di wallabag avranno quella stringa come prefisso. Potete includere un ``_`` per maggior chiarezza" + "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)" + +.. csv-table:: Configurazione per inviare email da wallabag + :header: "nome", "default", "descrizione" + + "mailer_transport", "smtp", "Il metodo di trasporto esatto usato per consegnare email. Valori validi sono: smtp, gmail, mail, sendmail, null (ció disattiva il mailer)" + "mailer_host", "127.0.0.1", "L'host al quale connettersi quando si usa smtp come metodo di trasporto." + "mailer_user", "~", "Lo username quando si usa smtp come metodo di trasporto." + "mailer_password", "~", "La password quando si usa smtp come metodo di trasporto." + +.. csv-table:: Altre opzioni di wallabag + :header: "nome", "default", "descrizione" + + "locale", "en", "Lingua di default della vostra istanza di wallabag (come en, fr, es, etc.)" + "secret", "ovmpmAWXRCabNlMgzlzFXDYmCFfzGv", "Questa é una stringa che dovrebbe essere unica per la vostra applicazione ed é usata comunemente per aggiungere piú entropia alle operazioni di sicurezza." + "twofactor_auth", "true", "true per abilitare l'autenticazione a due fattori" + "twofactor_sender", "no-reply@wallabag.org", "Email del mittente per ricevere il codice a due fattori" + "fosuser_registration", "true", "true per abilitare la registrazione pubblica" + "fosuser_confirmation", "true", "true per inviare una mail di conferma per ogni registrazione" + "from_email", "no-reply@wallabag.org", "Indirizzo email usato nel campo Da: in ogni email" + "rss_limit", "50", "Limite per i feed RSS" + +.. csv-table:: Configurazione di RabbitMQ + :header: "nome", "default", "descrizione" + + "rabbitmq_host", "localhost", "Host del vostro RabbitMQ" + "rabbitmq_port", "5672", "Porta del vostro RabbitMQ" + "rabbitmq_user", "guest", "Utente che puó leggere le code" + "rabbitmq_password", "guest", "Password di quell'utente" + +.. csv-table:: Configurazione di Redis + :header: "nome", "default", "descrizione" + + "redis_scheme", "tcp", "Specifica il protocollo da usare per comunicare con una istanza di Redis. Valori validi sono: tcp, unix, http" + "redis_host", "localhost", "IP o hostname del server bersaglio (ignorato per lo schema unix)" + "redis_port", "6379", "Porta TCP/IP del server bersaglio (ignorato per lo schema unix)" + "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 @@ +Aggiornate la vostra installazione di wallabag +============================================== + +Troverete qui i differenti modi per aggiornare il vostro wallabag: + +- `da 2.0.x a 2.1.1 <#upgrade-from-2-0-x-to-2-1-1>`_ +- `da 2.1.x a 2.1.y <#upgrading-from-2-1-x-to-2-1-y>`_ +- `da 1.x a 2.x <#from-wallabag-1-x>`_ + +Aggiornate da 2.0.x a 2.1.1 +--------------------------- + +.. attenzione:: + + 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. + +Aggiornamento su un web server dedicato +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +: + + rm -rf var/cache/* + git fetch origin + git fetch --tags + git checkout 2.1.1 --force + SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist + php bin/console doctrine:migrations:migrate --env=prod + php bin/console cache:clear --env=prod + +Aggiornamento su un hosting condiviso +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Fate un backup del file ``app/config/parameters.yml``. +Scaricate la versione 2.1.1 di wallabag: + +.. code-block:: bash + + wget http://framabag.org/wallabag-release-2.1.1.tar.gz && tar xvf wallabag-release-2.1.1.tar.gz + +(hash md5 del pacchetto 2.1.1: ``9584a3b60a2b2a4de87f536548caac93``) + +Estraete l'archivio nella vostra cartella di wallabag e sostituite ``app/config/parameters.yml`` con il vostro. + +Controllate che il vostro ``app/config/parameters.yml`` contenga tutti i parametri richiesti. Potete trovare qui la documentazione sui parametri *link mancante*. + +Se usate SQLite, dovete anche copiare la vostra cartella ``data/`` dentro la nuova installazione. + +Svuotate la cartella ``var/cache``. + +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: + +.. code-block:: sql + + ALTER TABLE `wallabag_entry` ADD `uuid` LONGTEXT DEFAULT NULL; + INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('share_public', '1', 'entry'); + ALTER TABLE `wallabag_oauth2_clients` ADD name longtext COLLATE 'utf8_unicode_ci' DEFAULT NULL; + INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('import_with_redis', '0', 'import'); + INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('import_with_rabbitmq', '0', 'import'); + ALTER TABLE `wallabag_config` ADD `pocket_consumer_key` VARCHAR(255) DEFAULT NULL; + DELETE FROM `wallabag_craue_config_setting` WHERE `name` = 'pocket_consumer_key'; + +Aggiornamento da 2.1.x a 2.1.y +------------------------------ + +Aggiornamento su un web server dedicato +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Per aggiornare la vostra installazione di wallabag ed ottenere l'ultima versione, eseguite il seguente comando nella vostra cartella wallabag: + +:: + + make update + +Aggiornamento su un hosting condiviso +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Fate un backup del file ``app/config/parameters.yml``. + +Scaricate l'ultima versione di wallabag: + +. code-block:: bash + + wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package + +Troverete il `hash md5 dell'ultima versione del pacchetto sul nostro sito `_. + +Estraete l'archivio nella vostra cartella di wallabag e rimpiazzate ``app/config/parameters.yml`` con il vostro. + +Controllate che il vostro ``app/config/parameters.yml`` contenga tutti i parametri richiesti. + +Potete trovare qui la documentazione sui parametri *link mancante*. + +Se usate SQLite, dovete anche copiare la vostra cartella ``data/`` dentro la nuova installazione. + +Svuotate la cartella ``var/cache``. + +Da wallabag 1.x +--------------- + +Non esiste uno script automatico per aggiornare da wallabag 1.x a wallabag 2.x. Dovete: + +- esportare i vostri dati +- installare wallabag 2.x (leggete la documentazione a proposito dell'installazione *link mancante*) +- importate i dati in questa nuova installazione (leggete la documentazione a proposito dell'importazione) -- cgit v1.2.3