From 8148675cb7ef8081fee0b14307deb869abf0f6e3 Mon Sep 17 00:00:00 2001 From: Sven Fischer Date: Sat, 11 Feb 2017 00:43:04 +0100 Subject: docs 3rd party tools: update java wrapper, add cmd tool to add article --- docs/de/developer/api.rst | 4 ++-- docs/en/developer/api.rst | 4 ++-- docs/fr/developer/api.rst | 4 ++-- 3 files changed, 6 insertions(+), 6 deletions(-) (limited to 'docs') diff --git a/docs/de/developer/api.rst b/docs/de/developer/api.rst index 9d230e31..d374f836 100644 --- a/docs/de/developer/api.rst +++ b/docs/de/developer/api.rst @@ -264,8 +264,8 @@ Drittanbieter Ressourcen Einige Applikationen oder Bibliotheken nutzen unsere API. Hier ist eine nicht abschließende Aufzählung von ihnen: -- `Java wrapper for the wallabag API `_ von Strubbl. +- `Java wrapper for the wallabag API `_ von Dmitriy Bogdanov. - `.NET library for the wallabag v2 API `_ von Julian Oster. - `Python API for wallabag `_ von FoxMaSk, für sein Projekt `Trigger Happy `_. - `A plugin `_ entworfen für `Tiny Tiny RSS `_, das die wallabag v2 API nutzt. Von Josh Panter. -- `Golang wrapper for the wallabag API `_ von Strubbl, für sein Projekt `wallabag-stats Graph `_. +- `Golang wrapper for the wallabag API `_ von Strubbl, für seine Projekte `wallabag-stats Graph `_ und das Kommandozeilentool `wallabag-add-article `_. diff --git a/docs/en/developer/api.rst b/docs/en/developer/api.rst index b6c9ed3f..074da1a7 100644 --- a/docs/en/developer/api.rst +++ b/docs/en/developer/api.rst @@ -263,8 +263,8 @@ Third party resources Some applications or libraries use our API. Here is a non-exhaustive list of them: -- `Java wrapper for the wallabag API `_ by Strubbl. +- `Java wrapper for the wallabag API `_ by Dmitriy Bogdanov. - `.NET library for the wallabag v2 API `_ by Julian Oster. - `Python API for wallabag `_ by FoxMaSk, for his project `Trigger Happy `_. - `A plugin `_ designed for `Tiny Tiny RSS `_ that makes use of the wallabag v2 API. By Josh Panter. -- `Golang wrapper for the wallabag API `_ by Strubbl, for his project `wallabag-stats graph `_. +- `Golang wrapper for the wallabag API `_ by Strubbl, for his projects `wallabag-stats graph `_ and the command line tool `wallabag-add-article `_. diff --git a/docs/fr/developer/api.rst b/docs/fr/developer/api.rst index 8a6e2a13..75faf7d2 100644 --- a/docs/fr/developer/api.rst +++ b/docs/fr/developer/api.rst @@ -263,8 +263,8 @@ Ressources tierces Certaines applications ou bibliothèques utilisent notre API. En voici une liste non exhaustive : -- `Java wrapper for the wallabag API `_ par Strubbl. +- `Java wrapper for the wallabag API `_ par Dmitriy Bogdanov. - `.NET library for the wallabag v2 API `_ par Julian Oster. - `Python API for wallabag `_ par FoxMaSk, pour son projet `Trigger Happy `_. - `Un plugin `_ conçu pour `Tiny Tiny RSS `_ qui utilise l'API wallabag v2. Par Josh Panter. -- `Golang wrapper for the wallabag API `_ par Strubbl, pour son projet `wallabag-stats graphe `_. +- `Golang wrapper for the wallabag API `_ par Strubbl, pour son projets `wallabag-stats graphe `_ et l'outil de ligne de commande `wallabag-add-article `_. -- cgit v1.2.3 From 947ccd075c9974ad5158ac198f4e376385d94c4a Mon Sep 17 00:00:00 2001 From: Kevin Gautreau Date: Tue, 14 Feb 2017 09:24:56 +0100 Subject: Add informations about Apache 2.4 --- docs/en/user/installation.rst | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) (limited to 'docs') diff --git a/docs/en/user/installation.rst b/docs/en/user/installation.rst index 7d3bcf61..7fb81aeb 100644 --- a/docs/en/user/installation.rst +++ b/docs/en/user/installation.rst @@ -149,6 +149,23 @@ Assuming you install wallabag in the ``/var/www/wallabag`` folder and that you w ErrorLog /var/log/apache2/wallabag_error.log CustomLog /var/log/apache2/wallabag_access.log combined + + +.. tip:: Note for Apache 2.4, in the section `` you have to replace the directives : + +:: + + AllowOverride None + Order Allow,Deny + Allow from All + + +by + +:: + + Require All granted + After reloading or restarting Apache, you should now be able to access wallabag at http://domain.tld. -- cgit v1.2.3 From 0ae52976990718c139026c2f2ef39f5d14565734 Mon Sep 17 00:00:00 2001 From: Kevin Gautreau Date: Tue, 14 Feb 2017 15:29:33 +0100 Subject: Doc - informations about Apache 2.4 --- docs/fr/user/installation.rst | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) (limited to 'docs') diff --git a/docs/fr/user/installation.rst b/docs/fr/user/installation.rst index 9ef5ee98..319735af 100644 --- a/docs/fr/user/installation.rst +++ b/docs/fr/user/installation.rst @@ -147,6 +147,24 @@ En imaginant que vous vouliez installer wallabag dans le dossier ``/var/www/wall CustomLog /var/log/apache2/wallabag_access.log combined +.. tip:: Pour Apache 2.4, dans la section `` vous devez remplacer les directives suivantes : + +:: + + AllowOverride None + Order Allow,Deny + Allow from All + + +par + +:: + + Require All granted + + + + Après que vous ayez rechargé/redémarré Apache, vous devriez pouvoir avoir accès à wallabag à l'adresse http://domain.tld. Configuration avec Nginx -- cgit v1.2.3 From c772c473a1002a712b25b7c35922075d4d4116ff Mon Sep 17 00:00:00 2001 From: Sven Fischer Date: Sat, 11 Feb 2017 09:11:55 +0100 Subject: docs: add 3rd party app wallabako for Kobo readers --- docs/de/developer/api.rst | 3 ++- docs/en/developer/api.rst | 3 ++- docs/fr/developer/api.rst | 1 + 3 files changed, 5 insertions(+), 2 deletions(-) (limited to 'docs') diff --git a/docs/de/developer/api.rst b/docs/de/developer/api.rst index d374f836..7a18afde 100644 --- a/docs/de/developer/api.rst +++ b/docs/de/developer/api.rst @@ -254,7 +254,7 @@ cURL Beispiel: Andere Methoden --------------- -Wir werden nicht für jede API Methode Beispiele schreiben. +Wir werden nicht für jede API Methode Beispiele schreiben. Wirf einen Blick in die Liste http://localhost:8000/api/doc, um alle Methode kennenzulernen. @@ -269,3 +269,4 @@ Einige Applikationen oder Bibliotheken nutzen unsere API. Hier ist eine nicht ab - `Python API for wallabag `_ von FoxMaSk, für sein Projekt `Trigger Happy `_. - `A plugin `_ entworfen für `Tiny Tiny RSS `_, das die wallabag v2 API nutzt. Von Josh Panter. - `Golang wrapper for the wallabag API `_ von Strubbl, für seine Projekte `wallabag-stats Graph `_ und das Kommandozeilentool `wallabag-add-article `_. +- Tool, um automatisiert wallabag Artikel auf den lokalen PC oder ebook reader zu laden `wallabako `_ von anarcat. diff --git a/docs/en/developer/api.rst b/docs/en/developer/api.rst index 074da1a7..80c96025 100644 --- a/docs/en/developer/api.rst +++ b/docs/en/developer/api.rst @@ -8,7 +8,7 @@ Requirements * wallabag freshly (or not) installed on http://localhost:8000 * ``httpie`` installed on your computer (`see project website `__). Note that you can also adapt the commands using curl or wget. -* all the API methods are documented here http://localhost:8000/api/doc (on your instance) and `on our example instance `_ +* all the API methods are documented here http://localhost:8000/api/doc (on your instance) and `on our example instance `_ Creating a new API client ------------------------- @@ -268,3 +268,4 @@ Some applications or libraries use our API. Here is a non-exhaustive list of the - `Python API for wallabag `_ by FoxMaSk, for his project `Trigger Happy `_. - `A plugin `_ designed for `Tiny Tiny RSS `_ that makes use of the wallabag v2 API. By Josh Panter. - `Golang wrapper for the wallabag API `_ by Strubbl, for his projects `wallabag-stats graph `_ and the command line tool `wallabag-add-article `_. +- Tool to automatically download Wallabag articles into your local computer or Kobo ebook reader `wallabako `_ by anarcat. diff --git a/docs/fr/developer/api.rst b/docs/fr/developer/api.rst index 75faf7d2..e7bb264f 100644 --- a/docs/fr/developer/api.rst +++ b/docs/fr/developer/api.rst @@ -268,3 +268,4 @@ Certaines applications ou bibliothèques utilisent notre API. En voici une liste - `Python API for wallabag `_ par FoxMaSk, pour son projet `Trigger Happy `_. - `Un plugin `_ conçu pour `Tiny Tiny RSS `_ qui utilise l'API wallabag v2. Par Josh Panter. - `Golang wrapper for the wallabag API `_ par Strubbl, pour son projets `wallabag-stats graphe `_ et l'outil de ligne de commande `wallabag-add-article `_. +- Tool to automatically download Wallabag articles into your local computer or Kobo ebook reader `wallabako `_ par anarcat. -- cgit v1.2.3 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') 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 From 7d1c19c0210e5d75c496f8c1ae10a727be2b9317 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Tue, 14 Feb 2017 20:45:08 +0100 Subject: Doc: translated mobile apps configuration in french --- docs/de/index.rst | 1 + docs/de/user/configuring_mobile.rst | 13 +++++++++++++ docs/en/index.rst | 1 + docs/en/user/configuring_mobile.rst | 14 +++++++------- docs/fr/index.rst | 1 + docs/fr/user/configuring_mobile.rst | 12 ++++++++++++ docs/ita/index.rst | 1 + docs/ita/user/configuring_mobile.rst | 13 +++++++++++++ 8 files changed, 49 insertions(+), 7 deletions(-) create mode 100644 docs/de/user/configuring_mobile.rst create mode 100644 docs/fr/user/configuring_mobile.rst create mode 100644 docs/ita/user/configuring_mobile.rst (limited to 'docs') diff --git a/docs/de/index.rst b/docs/de/index.rst index 1c3e4873..6e725fbe 100644 --- a/docs/de/index.rst +++ b/docs/de/index.rst @@ -33,6 +33,7 @@ Die Dokumentation ist in anderen Sprachen verfügbar : user/errors_during_fetching user/filters user/tags + user/configuring_mobile user/android user/parameters user/backup diff --git a/docs/de/user/configuring_mobile.rst b/docs/de/user/configuring_mobile.rst new file mode 100644 index 00000000..7229aed6 --- /dev/null +++ b/docs/de/user/configuring_mobile.rst @@ -0,0 +1,13 @@ +Configuring mobile apps to work with wallabag +============================================= + +Steps to configure the app +-------------------------- + +- 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. +- 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``. +- It's also going to ask for the aforementioned ``Client ID`` and ``secret``. Please insert those in the text fields, when asked. +- Lastly you need to provide your ``username`` and ``password``. These are the same credentials you use to login in to wallabag. + +Please also have a look at `Android `_ page. Especially the section on *known limitations*. + diff --git a/docs/en/index.rst b/docs/en/index.rst index 2e20aee6..89f61d6d 100644 --- a/docs/en/index.rst +++ b/docs/en/index.rst @@ -33,6 +33,7 @@ The documentation is available in other languages: user/errors_during_fetching user/filters user/tags + user/configuring_mobile user/android user/parameters user/backup diff --git a/docs/en/user/configuring_mobile.rst b/docs/en/user/configuring_mobile.rst index 2bcf3bcb..7229aed6 100644 --- a/docs/en/user/configuring_mobile.rst +++ b/docs/en/user/configuring_mobile.rst @@ -1,13 +1,13 @@ -Configuring Mobile Apps to Work With wallabag.it -================================================ +Configuring mobile apps to work with wallabag +============================================= Steps to configure the app ---------------------------- +-------------------------- -- First *create a new client* in the ``Developer`` section. The name of your app doesn't matter as much as the ``Client ID`` and the ``Client secret``. Write these two values down. -- When you download a mobile app, it's going to ask for the server address of the hosted wallabag instance. With wallabag.it that is: ``https://app.wallabag.it``. +- 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. +- 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``. - It's also going to ask for the aforementioned ``Client ID`` and ``secret``. Please insert those in the text fields, when asked. -- Lastly you need to provide your ``username`` and ``password``. These are the same credentials you use to login in to wallabag.it. +- Lastly you need to provide your ``username`` and ``password``. These are the same credentials you use to login in to wallabag. -Please also have a look at `Android `_. Especially the section on *known limitations*. +Please also have a look at `Android `_ page. Especially the section on *known limitations*. diff --git a/docs/fr/index.rst b/docs/fr/index.rst index e3f14b04..99aaa35a 100644 --- a/docs/fr/index.rst +++ b/docs/fr/index.rst @@ -34,6 +34,7 @@ La documentation est disponible dans d'autres langues : user/errors_during_fetching user/filters user/tags + user/configuring_mobile user/android user/parameters user/backup diff --git a/docs/fr/user/configuring_mobile.rst b/docs/fr/user/configuring_mobile.rst new file mode 100644 index 00000000..4036c354 --- /dev/null +++ b/docs/fr/user/configuring_mobile.rst @@ -0,0 +1,12 @@ +Configurer les applications mobile pour wallabag +================================================ + +Étapes pour configurer les applications +--------------------------------------- + +- Tout d'abord, *créez un nouveau client* dans la section ``Gestion des clients API``. Le nom de votre application importe peu. Ce qui nous intéresse, ce sont l'``ID Client`` et la ``clé secrète``. Notez bien ces deux valeurs. +- Quand vous installez une application smartphone, on va vous demander de renseigner l'adresse de votre serveur de wallabag. Par exemple, pour wallabag.it, c'est ``https://app.wallabag.it``. +- Les deux valeurs notées précédemment vous seront également demandées. Insérez-les dans les champs correspondants. +- Enfin, vous devez renseigner votre ``nom d'utilisateur`` et votre ``mot de passe``. Ce sont les mêmes valeurs que lorsque vous vous connectez à wallabag. + +Vous pouvez également regarder du côté de la page `Android `_. Particulièrement la section sur les *limitations connues*. diff --git a/docs/ita/index.rst b/docs/ita/index.rst index 32d175c7..92896fbf 100644 --- a/docs/ita/index.rst +++ b/docs/ita/index.rst @@ -33,6 +33,7 @@ La documentazione è disponibile anche in altre lingue: user/errors_during_fetching user/filters user/tags + user/configuring_mobile user/android user/parameters user/backup 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 @@ +Configuring mobile apps to work with wallabag +============================================= + +Steps to configure the app +-------------------------- + +- 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. +- 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``. +- It's also going to ask for the aforementioned ``Client ID`` and ``secret``. Please insert those in the text fields, when asked. +- Lastly you need to provide your ``username`` and ``password``. These are the same credentials you use to login in to wallabag. + +Please also have a look at `Android `_ page. Especially the section on *known limitations*. + -- cgit v1.2.3 From d60c38edf93d4317734116a3d5e3199875f275ad Mon Sep 17 00:00:00 2001 From: matteocoder Date: Wed, 25 Jan 2017 07:53:01 -0500 Subject: share.rst already integrated inside articles.rst The share.rst file is just a duplicate of a section already present in another file. --- docs/en/user/share.rst | 17 ----------------- 1 file changed, 17 deletions(-) delete mode 100644 docs/en/user/share.rst (limited to 'docs') diff --git a/docs/en/user/share.rst b/docs/en/user/share.rst deleted file mode 100644 index e99e51ab..00000000 --- a/docs/en/user/share.rst +++ /dev/null @@ -1,17 +0,0 @@ -Share articles -============== - -When you're reading an article, you can share it. Just click on the share button: - -.. image:: ../../img/user/share.png - :alt: share article - :align: center - -Now, you can share the article: - -- with a public URL (you'll have a light view of the article) -- with a tweet -- into your Shaarli -- with a post in Diaspora* -- to Carrot -- with an email -- cgit v1.2.3 From e04d656f5aa73d271a6d7866f08f1c21640b68fe Mon Sep 17 00:00:00 2001 From: matteocoder Date: Wed, 25 Jan 2017 07:56:31 -0500 Subject: first_article.rst already inside articles.rst The file is a duplicate of a section already present in articles.rst --- docs/en/user/first_article.rst | 66 ------------------------------------------ 1 file changed, 66 deletions(-) delete mode 100644 docs/en/user/first_article.rst (limited to 'docs') diff --git a/docs/en/user/first_article.rst b/docs/en/user/first_article.rst deleted file mode 100644 index 1400e1e8..00000000 --- a/docs/en/user/first_article.rst +++ /dev/null @@ -1,66 +0,0 @@ -Save your first article -======================= - -The main purpose of wallabag is to save web articles. You have many ways to do it. - -.. note:: - - A quickstart will be displayed in the application until you save your first article. - -By using a bookmarklet ----------------------- - -On the ``Howto`` page, you have a ``Bookmarklet`` tab. Drag and drop the ``bag it!`` -link to your bookmarks bar of your browser. - -Now, each time you're reading an article on the web and you want to save it, -click on the ``bag it!`` link in your bookmarks bar. The article is saved. - -By using the classic form -------------------------- - -In the top bar of your screen, you have 3 icons. With the first one, a plus sign, -you can easily save a new article. - -.. image:: ../../img/user/topbar.png - :alt: Top bar - :align: center - -Click on it to display a new field, paste the article URL inside and press your -``Return`` key. The article is saved. - -By using a browser add-on -------------------------- - -Firefox -~~~~~~~ - -*This addon is not yet available for wallabag v2*. - -Chrome -~~~~~~ - -*This addon is not yet available for wallabag v2*. - -By using your smarphone application ------------------------------------ - -Android -~~~~~~~ - -*This application is not yet available for wallabag v2*. - -Firefox OS -~~~~~~~~~~ - -*This application is not yet available for wallabag v2*. - -Windows Phone -~~~~~~~~~~~~~ - -*This application is not yet available for wallabag v2*. - -iOS -~~~ - -*This application is not yet available for wallabag v2*. -- cgit v1.2.3 From 8b42e75f68dad794438a257e47936d380d55adc1 Mon Sep 17 00:00:00 2001 From: Sven Fischer Date: Wed, 15 Feb 2017 17:11:43 +0100 Subject: add :de: doc user/configuring_mobile --- docs/de/user/configuring_mobile.rst | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) (limited to 'docs') diff --git a/docs/de/user/configuring_mobile.rst b/docs/de/user/configuring_mobile.rst index 7229aed6..7e8303e7 100644 --- a/docs/de/user/configuring_mobile.rst +++ b/docs/de/user/configuring_mobile.rst @@ -1,13 +1,13 @@ -Configuring mobile apps to work with wallabag -============================================= +Konfiguration mobiler Apps für wallabag +======================================= -Steps to configure the app --------------------------- +Schritte zum Konfigurieren der App +---------------------------------- -- 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. -- 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``. -- It's also going to ask for the aforementioned ``Client ID`` and ``secret``. Please insert those in the text fields, when asked. -- Lastly you need to provide your ``username`` and ``password``. These are the same credentials you use to login in to wallabag. +- als erstes *neuen Client erstellen* in dem Abschnitt ``API Client Management`` wählen. Der Name deiner App ist nicht so wichtig wie die ``Client-ID`` und das ``Client-Secret``. Schreib diese zwei Werte auf. +- Wenn du eine mobile App herunterlädst, wird sie dich nach der Server-Adresse deiner wallabag Instanz fragen. Zum Beispiel ist es ``https://app.wallabag.it`` bei wallabag.it. +- Sie wird dich auch nach den zuvor genannten ``Client-ID`` und ``Client-Secret`` fragen. Bitte trage die in die Textfelder ein, wenn du danach gefragt wirst. +- Zuletzt musst du deinen ``Benutzernamen`` und ``Passwort`` bereitstellen. Diese Zugangsdaten sind die gleichen, die du zum Login bei wallabag nutzt. -Please also have a look at `Android `_ page. Especially the section on *known limitations*. +Bitte schaue auch auf die `Android `_ Seite. Insbesondere den Abschnitt *Bekannte Limitierungen*. -- cgit v1.2.3 From 9dd68dae774af657fd05cad38a546cac63a1f2a6 Mon Sep 17 00:00:00 2001 From: Julian Oster Date: Thu, 16 Feb 2017 21:41:19 +0100 Subject: Some changes to :de: translation --- docs/de/user/configuring_mobile.rst | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) (limited to 'docs') diff --git a/docs/de/user/configuring_mobile.rst b/docs/de/user/configuring_mobile.rst index 7e8303e7..ed1d0b75 100644 --- a/docs/de/user/configuring_mobile.rst +++ b/docs/de/user/configuring_mobile.rst @@ -4,10 +4,9 @@ Konfiguration mobiler Apps für wallabag Schritte zum Konfigurieren der App ---------------------------------- -- als erstes *neuen Client erstellen* in dem Abschnitt ``API Client Management`` wählen. Der Name deiner App ist nicht so wichtig wie die ``Client-ID`` und das ``Client-Secret``. Schreib diese zwei Werte auf. -- Wenn du eine mobile App herunterlädst, wird sie dich nach der Server-Adresse deiner wallabag Instanz fragen. Zum Beispiel ist es ``https://app.wallabag.it`` bei wallabag.it. -- Sie wird dich auch nach den zuvor genannten ``Client-ID`` und ``Client-Secret`` fragen. Bitte trage die in die Textfelder ein, wenn du danach gefragt wirst. +- Als Erstes erstellst du einen neuen *neuen Client* in dem Abschnitt ``API Client Management``. Der Name deiner App ist dabei nicht so wichtig wie die ``Client-ID`` und das ``Client-Secret``. Schreib diese zwei Werte auf. +- Wenn du eine mobile App herunterlädst, wird sie dich nach der Server-Adresse deiner wallabag-Instanz fragen. Zum Beispiel ist es ``https://app.wallabag.it`` bei wallabag.it. +- Sie wird dich auch nach den zuvor genannten ``Client-ID`` und ``Client-Secret`` fragen. Bitte trage diese in die Textfelder ein, wenn du danach gefragt wirst. - Zuletzt musst du deinen ``Benutzernamen`` und ``Passwort`` bereitstellen. Diese Zugangsdaten sind die gleichen, die du zum Login bei wallabag nutzt. -Bitte schaue auch auf die `Android `_ Seite. Insbesondere den Abschnitt *Bekannte Limitierungen*. - +Bitte schaue auch auf die `Android `_ Seite und dort insbesondere den Abschnitt *Bekannte Limitierungen*. -- cgit v1.2.3 From 9d8975f6b6e1998cff86a0198b247a5c1708bc59 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Fri, 17 Feb 2017 13:12:09 +0100 Subject: Moved :it: documentation into it folder --- docs/it/conf.py | 55 +++++ docs/it/developer/api.rst | 269 +++++++++++++++++++++++++ docs/it/developer/asynchronous.rst | 162 +++++++++++++++ docs/it/developer/docker.rst | 41 ++++ docs/it/developer/documentation.rst | 12 ++ docs/it/developer/paywall.rst | 52 +++++ docs/it/developer/testsuite.rst | 6 + docs/it/developer/translate.rst | 55 +++++ docs/it/index.rst | 53 +++++ docs/it/requirements.txt | 2 + docs/it/user/android.rst | 107 ++++++++++ docs/it/user/articles.rst | 115 +++++++++++ docs/it/user/backup.rst | 30 +++ docs/it/user/configuration.rst | 104 ++++++++++ docs/it/user/configuring_mobile.rst | 12 ++ docs/it/user/create_account.rst | 38 ++++ docs/it/user/errors_during_fetching.rst | 37 ++++ docs/it/user/faq.rst | 53 +++++ docs/it/user/filters.rst | 45 +++++ docs/it/user/import.rst | 115 +++++++++++ docs/it/user/installation.rst | 333 +++++++++++++++++++++++++++++++ docs/it/user/parameters.rst | 93 +++++++++ docs/it/user/upgrade.rst | 102 ++++++++++ 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 | 53 ----- 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/configuring_mobile.rst | 13 -- 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 ---------- 46 files changed, 1891 insertions(+), 1892 deletions(-) create mode 100644 docs/it/conf.py create mode 100644 docs/it/developer/api.rst create mode 100644 docs/it/developer/asynchronous.rst create mode 100644 docs/it/developer/docker.rst create mode 100644 docs/it/developer/documentation.rst create mode 100644 docs/it/developer/paywall.rst create mode 100644 docs/it/developer/testsuite.rst create mode 100644 docs/it/developer/translate.rst create mode 100644 docs/it/index.rst create mode 100644 docs/it/requirements.txt create mode 100644 docs/it/user/android.rst create mode 100644 docs/it/user/articles.rst create mode 100644 docs/it/user/backup.rst create mode 100644 docs/it/user/configuration.rst create mode 100644 docs/it/user/configuring_mobile.rst create mode 100644 docs/it/user/create_account.rst create mode 100644 docs/it/user/errors_during_fetching.rst create mode 100644 docs/it/user/faq.rst create mode 100644 docs/it/user/filters.rst create mode 100644 docs/it/user/import.rst create mode 100644 docs/it/user/installation.rst create mode 100644 docs/it/user/parameters.rst create mode 100644 docs/it/user/upgrade.rst delete mode 100644 docs/ita/conf.py delete mode 100644 docs/ita/developer/api.rst delete mode 100644 docs/ita/developer/asynchronous.rst delete mode 100644 docs/ita/developer/docker.rst delete mode 100644 docs/ita/developer/documentation.rst delete mode 100644 docs/ita/developer/paywall.rst delete mode 100644 docs/ita/developer/testsuite.rst delete mode 100644 docs/ita/developer/translate.rst delete mode 100644 docs/ita/index.rst delete mode 100644 docs/ita/requirements.txt delete mode 100644 docs/ita/user/android.rst delete mode 100644 docs/ita/user/articles.rst delete mode 100644 docs/ita/user/backup.rst delete mode 100644 docs/ita/user/configuration.rst delete mode 100644 docs/ita/user/configuring_mobile.rst delete mode 100644 docs/ita/user/create_account.rst delete mode 100644 docs/ita/user/errors_during_fetching.rst delete mode 100644 docs/ita/user/faq.rst delete mode 100644 docs/ita/user/filters.rst delete mode 100644 docs/ita/user/import.rst delete mode 100644 docs/ita/user/installation.rst delete mode 100644 docs/ita/user/parameters.rst delete mode 100644 docs/ita/user/upgrade.rst (limited to 'docs') diff --git a/docs/it/conf.py b/docs/it/conf.py new file mode 100644 index 00000000..717b35f1 --- /dev/null +++ b/docs/it/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/it/developer/api.rst b/docs/it/developer/api.rst new file mode 100644 index 00000000..fc19a175 --- /dev/null +++ b/docs/it/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/it/developer/asynchronous.rst b/docs/it/developer/asynchronous.rst new file mode 100644 index 00000000..d753bd23 --- /dev/null +++ b/docs/it/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/it/developer/docker.rst b/docs/it/developer/docker.rst new file mode 100644 index 00000000..f07df20d --- /dev/null +++ b/docs/it/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/it/developer/documentation.rst b/docs/it/developer/documentation.rst new file mode 100644 index 00000000..d4b63bb6 --- /dev/null +++ b/docs/it/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/it/developer/paywall.rst b/docs/it/developer/paywall.rst new file mode 100644 index 00000000..2c4e1bf7 --- /dev/null +++ b/docs/it/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/it/developer/testsuite.rst b/docs/it/developer/testsuite.rst new file mode 100644 index 00000000..fdb72401 --- /dev/null +++ b/docs/it/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/it/developer/translate.rst b/docs/it/developer/translate.rst new file mode 100644 index 00000000..c0b8e265 --- /dev/null +++ b/docs/it/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/it/index.rst b/docs/it/index.rst new file mode 100644 index 00000000..92896fbf --- /dev/null +++ b/docs/it/index.rst @@ -0,0 +1,53 @@ +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/configuring_mobile + 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/it/requirements.txt b/docs/it/requirements.txt new file mode 100644 index 00000000..06fc8973 --- /dev/null +++ b/docs/it/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/it/user/android.rst b/docs/it/user/android.rst new file mode 100644 index 00000000..a82bbef5 --- /dev/null +++ b/docs/it/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/it/user/articles.rst b/docs/it/user/articles.rst new file mode 100644 index 00000000..944b23ef --- /dev/null +++ b/docs/it/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/it/user/backup.rst b/docs/it/user/backup.rst new file mode 100644 index 00000000..548c675b --- /dev/null +++ b/docs/it/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/it/user/configuration.rst b/docs/it/user/configuration.rst new file mode 100644 index 00000000..fbc8687f --- /dev/null +++ b/docs/it/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/it/user/configuring_mobile.rst b/docs/it/user/configuring_mobile.rst new file mode 100644 index 00000000..f0ea54f1 --- /dev/null +++ b/docs/it/user/configuring_mobile.rst @@ -0,0 +1,12 @@ +Configurare le app mobili in modo che funzionino con wallabag +============================================================= + +Passi per configurare l'app +--------------------------- + +- Per prima cosa *create un nuovo client* nella sezione ``API clients management``. Il nome della vostra app non importa quanto il ``Client ID`` ed il ``Client secret``. Segnatevi questi due valori. +- Quando scaricate un'app mobile, questa chiederà l'indirizzo del server dell'istanza di wallabag ospitata. Per esempio, con wallabag.it questo è: ``https://app.wallabag.it``. +- Chiederà anche i sopracitati ``Client ID`` e ``secret``. Si prega di inserirli nei campi di testo, quando richiesto. +- Infine dovrete fornire il vostro ``username`` e la vostra ``password``. Queste sono le stesse credenziali che usate per fare il login in wallabag. + +Si prega anche di guardare la pagina `Android `_. Specialmente la sezione *Limiti conosciuti*. diff --git a/docs/it/user/create_account.rst b/docs/it/user/create_account.rst new file mode 100644 index 00000000..c569962d --- /dev/null +++ b/docs/it/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/it/user/errors_during_fetching.rst b/docs/it/user/errors_during_fetching.rst new file mode 100644 index 00000000..d92b83dc --- /dev/null +++ b/docs/it/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/it/user/faq.rst b/docs/it/user/faq.rst new file mode 100644 index 00000000..decdfab1 --- /dev/null +++ b/docs/it/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/it/user/filters.rst b/docs/it/user/filters.rst new file mode 100644 index 00000000..105cb1d6 --- /dev/null +++ b/docs/it/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/it/user/import.rst b/docs/it/user/import.rst new file mode 100644 index 00000000..c249acfd --- /dev/null +++ b/docs/it/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/it/user/installation.rst b/docs/it/user/installation.rst new file mode 100644 index 00000000..cd6ebbef --- /dev/null +++ b/docs/it/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/it/user/parameters.rst b/docs/it/user/parameters.rst new file mode 100644 index 00000000..da9555e1 --- /dev/null +++ b/docs/it/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/it/user/upgrade.rst b/docs/it/user/upgrade.rst new file mode 100644 index 00000000..86122223 --- /dev/null +++ b/docs/it/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) diff --git a/docs/ita/conf.py b/docs/ita/conf.py deleted file mode 100644 index 717b35f1..00000000 --- a/docs/ita/conf.py +++ /dev/null @@ -1,55 +0,0 @@ -# -*- 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 deleted file mode 100644 index fc19a175..00000000 --- a/docs/ita/developer/api.rst +++ /dev/null @@ -1,269 +0,0 @@ -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 deleted file mode 100644 index d753bd23..00000000 --- a/docs/ita/developer/asynchronous.rst +++ /dev/null @@ -1,162 +0,0 @@ -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 deleted file mode 100644 index f07df20d..00000000 --- a/docs/ita/developer/docker.rst +++ /dev/null @@ -1,41 +0,0 @@ -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 deleted file mode 100644 index d4b63bb6..00000000 --- a/docs/ita/developer/documentation.rst +++ /dev/null @@ -1,12 +0,0 @@ -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 deleted file mode 100644 index 2c4e1bf7..00000000 --- a/docs/ita/developer/paywall.rst +++ /dev/null @@ -1,52 +0,0 @@ -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 deleted file mode 100644 index fdb72401..00000000 --- a/docs/ita/developer/testsuite.rst +++ /dev/null @@ -1,6 +0,0 @@ -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 deleted file mode 100644 index c0b8e265..00000000 --- a/docs/ita/developer/translate.rst +++ /dev/null @@ -1,55 +0,0 @@ -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 deleted file mode 100644 index 92896fbf..00000000 --- a/docs/ita/index.rst +++ /dev/null @@ -1,53 +0,0 @@ -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/configuring_mobile - 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 deleted file mode 100644 index 06fc8973..00000000 --- a/docs/ita/requirements.txt +++ /dev/null @@ -1,2 +0,0 @@ -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 deleted file mode 100644 index a82bbef5..00000000 --- a/docs/ita/user/android.rst +++ /dev/null @@ -1,107 +0,0 @@ -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 deleted file mode 100644 index 944b23ef..00000000 --- a/docs/ita/user/articles.rst +++ /dev/null @@ -1,115 +0,0 @@ - -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 deleted file mode 100644 index 548c675b..00000000 --- a/docs/ita/user/backup.rst +++ /dev/null @@ -1,30 +0,0 @@ -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 deleted file mode 100644 index fbc8687f..00000000 --- a/docs/ita/user/configuration.rst +++ /dev/null @@ -1,104 +0,0 @@ -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/configuring_mobile.rst b/docs/ita/user/configuring_mobile.rst deleted file mode 100644 index 7229aed6..00000000 --- a/docs/ita/user/configuring_mobile.rst +++ /dev/null @@ -1,13 +0,0 @@ -Configuring mobile apps to work with wallabag -============================================= - -Steps to configure the app --------------------------- - -- 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. -- 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``. -- It's also going to ask for the aforementioned ``Client ID`` and ``secret``. Please insert those in the text fields, when asked. -- Lastly you need to provide your ``username`` and ``password``. These are the same credentials you use to login in to wallabag. - -Please also have a look at `Android `_ page. Especially the section on *known limitations*. - diff --git a/docs/ita/user/create_account.rst b/docs/ita/user/create_account.rst deleted file mode 100644 index c569962d..00000000 --- a/docs/ita/user/create_account.rst +++ /dev/null @@ -1,38 +0,0 @@ -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 deleted file mode 100644 index d92b83dc..00000000 --- a/docs/ita/user/errors_during_fetching.rst +++ /dev/null @@ -1,37 +0,0 @@ - -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 deleted file mode 100644 index decdfab1..00000000 --- a/docs/ita/user/faq.rst +++ /dev/null @@ -1,53 +0,0 @@ -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 deleted file mode 100644 index 105cb1d6..00000000 --- a/docs/ita/user/filters.rst +++ /dev/null @@ -1,45 +0,0 @@ -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 deleted file mode 100644 index c249acfd..00000000 --- a/docs/ita/user/import.rst +++ /dev/null @@ -1,115 +0,0 @@ -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 deleted file mode 100644 index cd6ebbef..00000000 --- a/docs/ita/user/installation.rst +++ /dev/null @@ -1,333 +0,0 @@ - - -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 deleted file mode 100644 index da9555e1..00000000 --- a/docs/ita/user/parameters.rst +++ /dev/null @@ -1,93 +0,0 @@ -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 deleted file mode 100644 index 86122223..00000000 --- a/docs/ita/user/upgrade.rst +++ /dev/null @@ -1,102 +0,0 @@ -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 From 5d858d21de326e10b271dc68cae31eea8828da89 Mon Sep 17 00:00:00 2001 From: Julian Oster Date: Fri, 17 Feb 2017 21:52:16 +0100 Subject: Remove word repetition from german translation see https://github.com/wallabag/wallabag/pull/2882#discussion_r101806434 --- docs/de/user/configuring_mobile.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs') diff --git a/docs/de/user/configuring_mobile.rst b/docs/de/user/configuring_mobile.rst index ed1d0b75..c80320c9 100644 --- a/docs/de/user/configuring_mobile.rst +++ b/docs/de/user/configuring_mobile.rst @@ -4,7 +4,7 @@ Konfiguration mobiler Apps für wallabag Schritte zum Konfigurieren der App ---------------------------------- -- Als Erstes erstellst du einen neuen *neuen Client* in dem Abschnitt ``API Client Management``. Der Name deiner App ist dabei nicht so wichtig wie die ``Client-ID`` und das ``Client-Secret``. Schreib diese zwei Werte auf. +- Als Erstes erstellst du einen *neuen Client* in dem Abschnitt ``API Client Management``. Der Name deiner App ist dabei nicht so wichtig wie die ``Client-ID`` und das ``Client-Secret``. Schreib diese zwei Werte auf. - Wenn du eine mobile App herunterlädst, wird sie dich nach der Server-Adresse deiner wallabag-Instanz fragen. Zum Beispiel ist es ``https://app.wallabag.it`` bei wallabag.it. - Sie wird dich auch nach den zuvor genannten ``Client-ID`` und ``Client-Secret`` fragen. Bitte trage diese in die Textfelder ein, wenn du danach gefragt wirst. - Zuletzt musst du deinen ``Benutzernamen`` und ``Passwort`` bereitstellen. Diese Zugangsdaten sind die gleichen, die du zum Login bei wallabag nutzt. -- cgit v1.2.3 From 38fe54199772b4ab127ddfca46893545756038d6 Mon Sep 17 00:00:00 2001 From: Nicolas Frandeboeuf Date: Fri, 17 Feb 2017 10:57:18 +0100 Subject: Alert that 2FA must be authorized in app/config/parameters.yml --- docs/de/user/configuration.rst | 4 +++- docs/en/user/configuration.rst | 4 +++- docs/fr/user/configuration.rst | 4 +++- docs/it/user/configuration.rst | 11 +++++------ 4 files changed, 14 insertions(+), 9 deletions(-) (limited to 'docs') diff --git a/docs/de/user/configuration.rst b/docs/de/user/configuration.rst index 47c60f4c..c0c04bde 100644 --- a/docs/de/user/configuration.rst +++ b/docs/de/user/configuration.rst @@ -66,7 +66,9 @@ Zwei-Faktor-Authentifizierung (2FA) Die Zwei-Faktor-Authentifizierung (2FA) dient dem Identitätsnachweis eines Nutzers mittels der Kombination zweier verschiedener und insbesondere unabhängiger Komponenten (Faktoren). -https://de.wikipedia.org/wiki/Zwei-Faktor-Authentifizierung + https://de.wikipedia.org/wiki/Zwei-Faktor-Authentifizierung + +**Warnung:** Das Aktivieren von 2FA über das Konfigurations-Interface ist nur möglich, wenn vorher in der `app/config/parameters.yml` die `twofactor_auth`-Eigenschaft auf `true` gesetzt wurde (nach der Konfiguration das Leeren des Cache mit `php bin/console cache:clear -e=prod` nicht vergessen). Wenn du 2FA aktivierst, erhälst du jedes Mal, wenn du dich bei wallabag einloggen willst, einen Code per Mail. Du musst den Code in das folgende Formular eingeben. diff --git a/docs/en/user/configuration.rst b/docs/en/user/configuration.rst index caca834f..bba12cb9 100644 --- a/docs/en/user/configuration.rst +++ b/docs/en/user/configuration.rst @@ -68,7 +68,9 @@ Two factor authentication (2FA) Two-factor authentication (also known as 2FA) is a technology patented in 1984 that provides identification of users by means of the combination of two different components. -https://en.wikipedia.org/wiki/Two-factor_authentication + https://en.wikipedia.org/wiki/Two-factor_authentication + +**Warning**: enabling 2FA from the configuration interface is only possible if it has been authorized before in `app/config/parameters.yml` by setting the *twofactor_auth* property to `true` (do not forget to run `php bin/console cache:clear -e=prod` after modification). If you enable 2FA, each time you want to login to wallabag, you'll receive a code by email. You have to put this code on the following form. diff --git a/docs/fr/user/configuration.rst b/docs/fr/user/configuration.rst index 025b05bb..772000c3 100644 --- a/docs/fr/user/configuration.rst +++ b/docs/fr/user/configuration.rst @@ -69,7 +69,9 @@ Double authentification (2FA) L'authentification à deux facteurs (également appelée 2FA) est une technologie brevetée en 1984 qui fournit l'identification des utilisateurs au moyen de la combinaison de deux composants différents . -https://fr.wikipedia.org/wiki/Authentification_forte + https://fr.wikipedia.org/wiki/Authentification_forte + +**Attention**: l'activation de la 2FA depuis l'interface de configuration n'est possible que si elle a au préalable été autorisée dans `app/config/parameters.yml` en passant la propriété *twofactor_auth* à `true` (n'oubliez pas d'exécuter `php bin/console cache:clear -e=prod` après modification). Si vous activez 2FA, à chaque tentative de connexion à wallabag, vous recevrez un code par email. Vous devez renseigner ce code dans le formulaire suivant : diff --git a/docs/it/user/configuration.rst b/docs/it/user/configuration.rst index fbc8687f..3bd3bc91 100644 --- a/docs/it/user/configuration.rst +++ b/docs/it/user/configuration.rst @@ -47,9 +47,11 @@ Potete cambiare il vostro nome, il vostro indirizzo email e abilitare l'``Autent 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. + 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 + https://it.wikipedia.org/wiki/Autenticazione_a_due_fattori + +**Attenzione**: abilitare la 2FA dall'interfaccia di configurazione è possibile solamente se ciò è stato abilitato precedentemente in app/config/parameters.yml impostando la proprietà twofactor_auth su true (non dimenticate di eseguire il comando `php bin/console cache:clear -e=prod` dopo la modifica). Se abilitate la 2FA, ogni volta che vogliate accedere a wallabag, riceverete un codice via email. Dovrete inserire il codice nel seguente modulo. @@ -78,7 +80,7 @@ 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 »*. +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 »*. @@ -99,6 +101,3 @@ mimetype The entry's mime-type OR Una regol 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" =========== ============================================== ======== ========== - - - -- cgit v1.2.3 From e316d4bd34e87867790d31eec25959ea4bd78a20 Mon Sep 17 00:00:00 2001 From: etiess Date: Wed, 22 Feb 2017 11:49:45 +0100 Subject: Update paywall.rst (more details and clear cache) --- docs/fr/developer/paywall.rst | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) (limited to 'docs') diff --git a/docs/fr/developer/paywall.rst b/docs/fr/developer/paywall.rst index c1c410b1..ddba839a 100644 --- a/docs/fr/developer/paywall.rst +++ b/docs/fr/developer/paywall.rst @@ -6,12 +6,16 @@ wallabag peut récupérer le contenu des articles des sites qui utilisent un sys Activer l'authentification pour les paywall ------------------------------------------- -Dans les paramètres internes, section **Article**, activez l'authentification pour les articles derrière un paywall (avec la valeur 1). +Dans les paramètres internes, en tant qu'administrateur de wallabag, section **Article**, activez l'authentification pour les articles derrière un paywall (avec la valeur 1). Configurer les accès dans wallabag ---------------------------------- -Éditez le fichier ``app/config/parameters.yml`` pour modifier les accès aux sites avec paywall. Voici un exemple pour certains sites : +Éditez le fichier ``app/config/parameters.yml`` pour modifier les accès aux sites avec paywall. Par exemple, sous Ubuntu : + +``sudo -u www-data nano /var/www/html/wallabag/app/config/parameters.yml`` + +Voici un exemple pour certains sites (attention, ne pas utiliser la touche "tab", seulement des espaces) : .. code:: yaml @@ -28,7 +32,7 @@ Fichiers de configuration pour parser les articles .. note:: - Lisez `cette documentation `_ pour en savoir plus sur ces fichiers de configuration. + Lisez `cette documentation `_ pour en savoir plus sur ces fichiers de configuration, qui se trouvent dans le répertoire ``vendor/j0k3r/graby-site-config/``. Pour la majorité des sites, ce fichier est déjà configuré : les instructions qui suivent concernent seulement les sites non encore configurés. Chaque fichier de configuration doit être enrichi en ajoutant ``requires_login``, ``login_uri``, ``login_username_field``, ``login_password_field`` et ``not_logged_in_xpath``. @@ -54,3 +58,8 @@ Par exemple : login_password_field: password not_logged_in_xpath: //body[@class="not-logged-in"] + +Dernière étape : nettoyer le cache +---------------------------------- + +Il est nécessaire de nettoyer le cache de wallabag avec la commande suivante (ici sous Ubuntu) : ``sudo -u www-data php /var/www/html/wallabag/bin/console cache:clear -e=prod`` -- cgit v1.2.3 From 5301d664d9459b7b8ef46a0d5c28bb3c1af90f07 Mon Sep 17 00:00:00 2001 From: etiess Date: Thu, 23 Feb 2017 08:54:33 +0100 Subject: Update paywall.rst (EN) with details + clear cache --- docs/en/developer/paywall.rst | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) (limited to 'docs') diff --git a/docs/en/developer/paywall.rst b/docs/en/developer/paywall.rst index 365027b4..153afa6f 100644 --- a/docs/en/developer/paywall.rst +++ b/docs/en/developer/paywall.rst @@ -6,12 +6,16 @@ wallabag can fetch articles from websites which use a paywall system. Enable paywall authentication ----------------------------- -In internal settings, in the **Article** section, enable authentication for websites with paywall (with the value 1). +In internal settings, as a wallabag administrator, in the **Article** section, enable authentication for websites with paywall (with the value 1). Configure credentials in wallabag --------------------------------- -Edit your ``app/config/parameters.yml`` file to edit credentials for each website with paywall. Here is an example for some french websites: +Edit your ``app/config/parameters.yml`` file to edit credentials for each website with paywall. For example, under Ubuntu: + +``sudo -u www-data nano /var/www/html/wallabag/app/config/parameters.yml`` + +Here is an example for some french websites (be careful: don't use the "tab" key, only spaces): .. code:: yaml @@ -28,7 +32,7 @@ Parsing configuration files .. note:: - Read `this part of the documentation `_ to understand the configuration files. + Read `this part of the documentation `_ to understand the configuration files, which are located under ``vendor/j0k3r/graby-site-config/``. For most of the websites, this file is already configured: the following instructions are only for the websites that are not configured yet. Each parsing configuration file needs to be improved by adding ``requires_login``, ``login_uri``, ``login_username_field``, ``login_password_field`` and ``not_logged_in_xpath``. @@ -54,3 +58,8 @@ For example: login_password_field: password not_logged_in_xpath: //body[@class="not-logged-in"] + +Last step: clear the cache +-------------------------- + +It's necessary to clear the wallabag cache with the following command (here under Ubuntu): ``sudo -u www-data php /var/www/html/wallabag/bin/console cache:clear -e=prod`` -- cgit v1.2.3 From a737f4b58eda4836ab25c63e36a3d80aac2ccccf Mon Sep 17 00:00:00 2001 From: Quentin THEURET Date: Thu, 23 Feb 2017 16:09:06 +0100 Subject: Ajout du mod 'rewrite' de Apache --- docs/fr/user/installation.rst | 6 ++++++ 1 file changed, 6 insertions(+) (limited to 'docs') diff --git a/docs/fr/user/installation.rst b/docs/fr/user/installation.rst index 319735af..5d29cb01 100644 --- a/docs/fr/user/installation.rst +++ b/docs/fr/user/installation.rst @@ -107,6 +107,12 @@ Virtual hosts Configuration avec Apache ~~~~~~~~~~~~~~~~~~~~~~~~~ +N'oubliez pas d'activer le mod *rewrite* de Apache + +.. code-block:: bash + + a2enmod rewrite && systemctl reload apache2 + En imaginant que vous vouliez installer wallabag dans le dossier ``/var/www/wallabag`` et que vous utilisiez PHP comme un module Apache, voici un vhost pour wallabag : :: -- cgit v1.2.3 From 0a82d6e23c71d797f5ab6e54ee4f67a6c91a05bf Mon Sep 17 00:00:00 2001 From: Quentin THEURET Date: Thu, 23 Feb 2017 16:10:14 +0100 Subject: Activate 'rewrite' mod of Apache --- docs/en/user/installation.rst | 6 ++++++ 1 file changed, 6 insertions(+) (limited to 'docs') diff --git a/docs/en/user/installation.rst b/docs/en/user/installation.rst index 7fb81aeb..2b730b83 100644 --- a/docs/en/user/installation.rst +++ b/docs/en/user/installation.rst @@ -110,6 +110,12 @@ Virtual hosts Configuration on Apache ~~~~~~~~~~~~~~~~~~~~~~~ +Do not forget to active the *rewrite* mod of Apache + +.. code-block:: bash + + a2enmod rewrite && systemctl reload apache2 + Assuming you install wallabag in the ``/var/www/wallabag`` folder and that you want to use PHP as an Apache module, here's a vhost for wallabag: :: -- cgit v1.2.3 From 3529ce35e43f08ec03be63beeea81406396c686c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Tue, 28 Feb 2017 21:10:24 +0100 Subject: Added german and italian translation --- docs/de/user/installation.rst | 6 ++++++ docs/it/user/installation.rst | 6 ++++++ 2 files changed, 12 insertions(+) (limited to 'docs') diff --git a/docs/de/user/installation.rst b/docs/de/user/installation.rst index cec62d18..0de6b6de 100644 --- a/docs/de/user/installation.rst +++ b/docs/de/user/installation.rst @@ -111,6 +111,12 @@ Virtualhosts Konfiguration von Apache ~~~~~~~~~~~~~~~~~~~~~~~~ +Vergiss nicht, die *rewrite* mod von Apache zu aktivieren. + +.. code-block:: bash + + a2enmod rewrite && systemctl reload apache2 + Angenommen du willst wallabag in das Verzeichnis ``/var/www/wallabag`` installieren und du willst PHP als Apache Modul nutzen, dann ist hier ein vhost für wallabag: :: diff --git a/docs/it/user/installation.rst b/docs/it/user/installation.rst index cd6ebbef..a79a31d3 100644 --- a/docs/it/user/installation.rst +++ b/docs/it/user/installation.rst @@ -110,6 +110,12 @@ Host virtuali Configurazione su Apache ~~~~~~~~~~~~~~~~~~~~~~~~ +Non dimenticate di attivare la mod *rewrite* di Apache + +.. code-block:: bash + + a2enmod rewrite && systemctl reload apache2 + 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: :: -- cgit v1.2.3 From de0ab52a47ea91f7013d0cacd7240ecdc85026ed Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Tue, 28 Mar 2017 11:45:40 +0200 Subject: Updated requirements in documentation --- docs/de/user/installation.rst | 2 +- docs/en/user/installation.rst | 2 +- docs/fr/user/installation.rst | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) (limited to 'docs') diff --git a/docs/de/user/installation.rst b/docs/de/user/installation.rst index cec62d18..1b7f0dee 100644 --- a/docs/de/user/installation.rst +++ b/docs/de/user/installation.rst @@ -4,7 +4,7 @@ Installation von wallabag Voraussetzungen --------------- -wallabag ist kompatibel mit PHP >= 5.5, inkl. PHP 7. +wallabag ist kompatibel mit **PHP >= 5.6**, inkl. PHP 7. .. note:: diff --git a/docs/en/user/installation.rst b/docs/en/user/installation.rst index 7d3bcf61..5b229bda 100644 --- a/docs/en/user/installation.rst +++ b/docs/en/user/installation.rst @@ -4,7 +4,7 @@ Install wallabag Requirements ------------ -wallabag is compatible with PHP >= 5.5, including PHP 7. +wallabag is compatible with **PHP >= 5.6**, including PHP 7. .. note:: diff --git a/docs/fr/user/installation.rst b/docs/fr/user/installation.rst index 9ef5ee98..0884608d 100644 --- a/docs/fr/user/installation.rst +++ b/docs/fr/user/installation.rst @@ -4,7 +4,7 @@ Installer wallabag Pré-requis ------------ -wallabag est compatible avec PHP >= 5.5, PHP 7 inclus. +wallabag est compatible avec **PHP >= 5.6**, PHP 7 inclus. .. note:: -- cgit v1.2.3