diff --git a/.travis.yml b/.travis.yml index 8c8093bf4..77872f493 100644 --- a/.travis.yml +++ b/.travis.yml @@ -24,7 +24,6 @@ cache: - $HOME/.npm php: - - 5.5 - 5.6 - 7.0 - 7.1 @@ -44,7 +43,6 @@ matrix: - php: 7.0 env: CS_FIXER=run VALIDATE_TRANSLATION_FILE=run ASSETS=build DB=sqlite allow_failures: - - php: 7.1 - php: nightly # exclude v1 branches diff --git a/CHANGELOG.md b/CHANGELOG.md index a87f1d82d..c5096fdf0 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,26 @@ ## Changelog +### 2.2.2 2017/03/02 + +- [#2950](https://github.com/wallabag/wallabag/pull/2950) Fixed symlinks issue during release creation (@nicosomb) +- [#2832](https://github.com/wallabag/wallabag/pull/2832) Search by term: extend to entries url (@Kdecherf) +- [#2830](https://github.com/wallabag/wallabag/pull/2830) Fixed rendering of entry title in Twig views (@Kdecherf) +- [#2892](https://github.com/wallabag/wallabag/pull/2892) Updated spanish translation (@ngosang) +- [#2915](https://github.com/wallabag/wallabag/pull/2915) Import: we now skip messages when user is null (@nicosomb) +- [#2905](https://github.com/wallabag/wallabag/pull/2905) Alert that 2FA must be authorized in app/config/parameters.yml (@nicofrand) +- [#2832](https://github.com/wallabag/wallabag/pull/2832) Search by term: extend to entries url (@Kdecherf) +- [#2878](https://github.com/wallabag/wallabag/pull/2878) Added italian documentation (@matteocoder) +- [#2860](https://github.com/wallabag/wallabag/pull/2860) Documentation: update java wrapper, add cmd tool to add article (@Strubbl) +- [#2874](https://github.com/wallabag/wallabag/pull/2874) Added informations about Apache 2.4 (@kgaut) +- [#2869](https://github.com/wallabag/wallabag/pull/2869) Added log for restricted access value (@j0k3r) +- [#2846](https://github.com/wallabag/wallabag/pull/2846) Fixed misspells in polish translation (@mruminski) +- [#2842](https://github.com/wallabag/wallabag/pull/2842) Update RulerZ (@K-Phoen) +- [#2841](https://github.com/wallabag/wallabag/pull/2841) Show active list in the left menu during search (@Kdecherf) +- [#2788](https://github.com/wallabag/wallabag/pull/2788) Documentation on how to configure mobile apps to work with wallabag (@Zettt) +- [#2839](https://github.com/wallabag/wallabag/pull/2839) Fixed `composer.phar: not found` in update script (@foxmask) +- [#2818](https://github.com/wallabag/wallabag/pull/2818) Fix nav-panel-search height (@Kdecherf) +- [#2824](https://github.com/wallabag/wallabag/pull/2824) Renamed Developer section to API client management (@nicosomb) + ### 2.2.1 2017/01/31 - [#2809](https://github.com/wallabag/wallabag/pull/2809) Fixed duplicate entry for share_public in craue_setting_table and added documentation about migration (@nicosomb) diff --git a/README.md b/README.md index f96e2b8c7..1b20e5d1c 100644 --- a/README.md +++ b/README.md @@ -8,6 +8,8 @@ Click, save and read it when you can. It extracts content so that you can read i More information on our website: [wallabag.org](https://wallabag.org). +If you do not have your own server, consider [the wallabag.it hosting solution](https://wallabag.it). + ![wallabag logo](https://raw.githubusercontent.com/wallabag/logo/master/_default/typo-horizontal/png/sm/logo-typo-horizontal-black-no-bg-no-border-sm.png) # Install wallabag diff --git a/app/Resources/CraueConfigBundle/translations/CraueConfigBundle.es.yml b/app/Resources/CraueConfigBundle/translations/CraueConfigBundle.es.yml index dbec0e818..c338836d6 100644 --- a/app/Resources/CraueConfigBundle/translations/CraueConfigBundle.es.yml +++ b/app/Resources/CraueConfigBundle/translations/CraueConfigBundle.es.yml @@ -1,7 +1,7 @@ -# settings_changed: Configuration updated -download_pictures: Descargar imágenes +settings_changed: Configuración actualizada +download_pictures: Descargar imágenes en el servidor carrot: Activar compartir con Carrot -diaspora_url: Diaspora URL, si el servicio está activado +diaspora_url: URL de Diaspora, si el servicio está activado export_epub: Activar exportación a ePub export_mobi: Activar exportación a .mobi export_pdf: Activar exportación a PDF @@ -9,11 +9,11 @@ export_csv: Activar exportación a CSV export_json: Activar exportación a JSON export_txt: Activar exportación a TXT export_xml: Activar exportación a XML -# import_with_rabbitmq: Enable RabbitMQ to import data asynchronously -# import_with_redis: Enable Redis to import data asynchronously -shaarli_url: Shaarli URL, si el servicio está activado +import_with_rabbitmq: Activar RabbitMQ para importar datos de forma asíncrona +import_with_redis: Activar Redis para importar datos de forma asíncrona +shaarli_url: URL de Shaarli, si el servicio está activado share_diaspora: Activar compartir con Diaspora -share_mail: Activar compartir con email +share_mail: Activar compartir con Email share_shaarli: Activar compartir con Shaarli share_twitter: Activar compartir con Twitter share_unmark: Activar compartir con Unmark.it @@ -24,12 +24,12 @@ entry: "artículo" export: "exportar" import: "importar" misc: "misc" -modify_settings: "modificar configuración" -piwik_host: Host de tu website de Piwik (sin http:// o https://) -piwik_site_id: ID de tu website de Piwik +modify_settings: "guardar" +piwik_host: Host de tu website en Piwik (sin http:// o https://) +piwik_site_id: ID de tu website en Piwik piwik_enabled: Activar Piwik -demo_mode_enabled: "Activar modo demo (sólo usado para la demo de wallabag)" +demo_mode_enabled: "Activar modo demo (sólo usado en la demo pública de wallabag)" demo_mode_username: "Nombre de usuario demo" -# share_public: Allow public url for entries -# download_images_enabled: Download images locally -# restricted_access: Enable authentication for websites with paywall +share_public: Permitir URL pública para los artículos +download_images_enabled: Descargar imágenes localmente +restricted_access: Activar autenticación para websites con paywall diff --git a/app/Resources/CraueConfigBundle/translations/CraueConfigBundle.pl.yml b/app/Resources/CraueConfigBundle/translations/CraueConfigBundle.pl.yml index 744031e8e..1203e1593 100644 --- a/app/Resources/CraueConfigBundle/translations/CraueConfigBundle.pl.yml +++ b/app/Resources/CraueConfigBundle/translations/CraueConfigBundle.pl.yml @@ -1,4 +1,4 @@ -# settings_changed: Configuration updated +settings_changed: Konfiguracja zaktualizowana download_pictures: Pobierz obrazy na swój serwer carrot: Włącz udostępnianie dla Carrot diaspora_url: Adres URL Diaspora, jeżeli usługa jest włączona @@ -24,12 +24,12 @@ entry: "artykuł" export: "eksport" import: "import" misc: "różne" -modify_settings: "zatwierdz" +modify_settings: "zatwierdź" piwik_host: Host twojej strony Piwik (bez http:// lub https://) piwik_site_id: ID twojej strony Piwik piwik_enabled: Włacz Piwik demo_mode_enabled: "Włacz tryb demo? (używany wyłącznie dla publicznej demonstracji Wallabag)" demo_mode_username: "Użytkownik Demonstracyjny" share_public: Zezwalaj na publiczny adres url dla wpisow -# download_images_enabled: Download images locally -# restricted_access: Enable authentication for websites with paywall +download_images_enabled: Pobierz obrazy lokalnie +restricted_access: Włącz autoryzację dla stron z paywallem diff --git a/app/config/config.yml b/app/config/config.yml index 4e802c988..d72311120 100644 --- a/app/config/config.yml +++ b/app/config/config.yml @@ -30,7 +30,7 @@ framework: assets: ~ wallabag_core: - version: 2.2.1 + version: 2.2.2 paypal_url: "https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=9UBA65LG3FX9Y&lc=gb" languages: en: 'English' diff --git a/composer.json b/composer.json index b919f446c..ed0e30c19 100644 --- a/composer.json +++ b/composer.json @@ -28,7 +28,7 @@ "issues": "https://github.com/wallabag/wallabag/issues" }, "require": { - "php": ">=5.5.9", + "php": ">=5.6.0", "ext-pcre": "*", "ext-dom": "*", "ext-curl": "*", @@ -58,7 +58,7 @@ "jms/serializer-bundle": "~1.1", "nelmio/api-doc-bundle": "~2.7", "mgargano/simplehtmldom": "~1.5", - "tecnickcom/tc-lib-pdf": "dev-master", + "wallabag/tcpdf": "^6.2", "simplepie/simplepie": "~1.3.1", "willdurand/hateoas-bundle": "~1.0", "htmlawed/htmlawed": "~1.1.19", @@ -130,7 +130,7 @@ "config": { "bin-dir": "bin", "platform": { - "php": "5.5.9" + "php": "5.6.0" } }, "minimum-stability": "dev", diff --git a/docs/de/developer/api.rst b/docs/de/developer/api.rst index 9d230e31c..7a18afde9 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. @@ -264,8 +264,9 @@ 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 `_. +- Tool, um automatisiert wallabag Artikel auf den lokalen PC oder ebook reader zu laden `wallabako `_ von anarcat. diff --git a/docs/de/index.rst b/docs/de/index.rst index 1c3e4873b..6e725fbe3 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/configuration.rst b/docs/de/user/configuration.rst index 47c60f4c9..c0c04bde1 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/de/user/configuring_mobile.rst b/docs/de/user/configuring_mobile.rst new file mode 100644 index 000000000..c80320c95 --- /dev/null +++ b/docs/de/user/configuring_mobile.rst @@ -0,0 +1,12 @@ +Konfiguration mobiler Apps für wallabag +======================================= + +Schritte zum Konfigurieren der App +---------------------------------- + +- 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. + +Bitte schaue auch auf die `Android `_ Seite und dort insbesondere den Abschnitt *Bekannte Limitierungen*. diff --git a/docs/de/user/installation.rst b/docs/de/user/installation.rst index cec62d182..8393455af 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:: @@ -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/en/developer/api.rst b/docs/en/developer/api.rst index b6c9ed3fc..80c960256 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 ------------------------- @@ -263,8 +263,9 @@ 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 `_. +- Tool to automatically download Wallabag articles into your local computer or Kobo ebook reader `wallabako `_ by anarcat. diff --git a/docs/en/developer/paywall.rst b/docs/en/developer/paywall.rst index 365027b47..153afa6fc 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`` diff --git a/docs/en/index.rst b/docs/en/index.rst index 2e20aee62..89f61d6d7 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/configuration.rst b/docs/en/user/configuration.rst index caca834f2..bba12cb9c 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/en/user/configuring_mobile.rst b/docs/en/user/configuring_mobile.rst index 2bcf3bcb2..7229aed68 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/en/user/first_article.rst b/docs/en/user/first_article.rst deleted file mode 100644 index 1400e1e8e..000000000 --- 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*. diff --git a/docs/en/user/installation.rst b/docs/en/user/installation.rst index 7d3bcf619..2c4b8749f 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:: @@ -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: :: @@ -149,6 +155,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. diff --git a/docs/en/user/share.rst b/docs/en/user/share.rst deleted file mode 100644 index e99e51ab3..000000000 --- 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 diff --git a/docs/fr/developer/api.rst b/docs/fr/developer/api.rst index 8a6e2a136..e7bb264fb 100644 --- a/docs/fr/developer/api.rst +++ b/docs/fr/developer/api.rst @@ -263,8 +263,9 @@ 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 `_. +- Tool to automatically download Wallabag articles into your local computer or Kobo ebook reader `wallabako `_ par anarcat. diff --git a/docs/fr/developer/paywall.rst b/docs/fr/developer/paywall.rst index c1c410b1e..ddba839a8 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`` diff --git a/docs/fr/index.rst b/docs/fr/index.rst index e3f14b048..99aaa35a6 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/configuration.rst b/docs/fr/user/configuration.rst index 025b05bb1..772000c34 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/fr/user/configuring_mobile.rst b/docs/fr/user/configuring_mobile.rst new file mode 100644 index 000000000..4036c3544 --- /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/fr/user/installation.rst b/docs/fr/user/installation.rst index 9ef5ee982..9dcb0efbd 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:: @@ -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 : :: @@ -147,6 +153,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 diff --git a/docs/it/conf.py b/docs/it/conf.py new file mode 100644 index 000000000..717b35f14 --- /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 000000000..fc19a175d --- /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 000000000..d753bd234 --- /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 000000000..f07df20d0 --- /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 000000000..d4b63bb6b --- /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 000000000..2c4e1bf7c --- /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 000000000..fdb724011 --- /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 000000000..c0b8e2655 --- /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 000000000..92896fbf6 --- /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 000000000..06fc89733 --- /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 000000000..a82bbef5c --- /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 000000000..944b23eff --- /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 000000000..548c675b1 --- /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 000000000..3bd3bc91f --- /dev/null +++ b/docs/it/user/configuration.rst @@ -0,0 +1,103 @@ +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 + +**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. + +.. 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 000000000..f0ea54f13 --- /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 000000000..c569962d6 --- /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 000000000..d92b83dc0 --- /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 000000000..decdfab1a --- /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 000000000..105cb1d67 --- /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 000000000..c249acfda --- /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 000000000..a79a31d3a --- /dev/null +++ b/docs/it/user/installation.rst @@ -0,0 +1,339 @@ + + +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 +~~~~~~~~~~~~~~~~~~~~~~~~ + +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: + +:: + + + 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 000000000..da9555e1c --- /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 000000000..861222234 --- /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/scripts/release.sh b/scripts/release.sh index e118b87ed..bfb65684c 100644 --- a/scripts/release.sh +++ b/scripts/release.sh @@ -12,6 +12,7 @@ mkdir $TMP_FOLDER/$RELEASE_FOLDER git clone git@github.com:wallabag/wallabag.git -b $VERSION $TMP_FOLDER/$RELEASE_FOLDER/$VERSION cd $TMP_FOLDER/$RELEASE_FOLDER/$VERSION && SYMFONY_ENV=$ENV composer up -n --no-dev cd $TMP_FOLDER/$RELEASE_FOLDER/$VERSION && php bin/console wallabag:install --env=$ENV +cd $TMP_FOLDER/$RELEASE_FOLDER/$VERSION && php bin/console assets:install --env=$ENV --symlink --relative cd $TMP_FOLDER/$RELEASE_FOLDER && tar czf wallabag-$VERSION.tar.gz --exclude="var/cache/*" --exclude="var/logs/*" --exclude="var/sessions/*" --exclude=".git" $VERSION echo "MD5 checksum of the package for wallabag $VERSION" md5 $TMP_FOLDER/$RELEASE_FOLDER/wallabag-$VERSION.tar.gz diff --git a/src/Wallabag/CoreBundle/Helper/HttpClientFactory.php b/src/Wallabag/CoreBundle/Helper/HttpClientFactory.php index 8891887b6..1ac8feb17 100644 --- a/src/Wallabag/CoreBundle/Helper/HttpClientFactory.php +++ b/src/Wallabag/CoreBundle/Helper/HttpClientFactory.php @@ -6,6 +6,7 @@ use Graby\Ring\Client\SafeCurlHandler; use GuzzleHttp\Client; use GuzzleHttp\Cookie\CookieJar; use GuzzleHttp\Event\SubscriberInterface; +use Psr\Log\LoggerInterface; /** * Builds and configures the Guzzle HTTP client. @@ -19,6 +20,7 @@ class HttpClientFactory private $cookieJar; private $restrictedAccess; + private $logger; /** * HttpClientFactory constructor. @@ -26,12 +28,14 @@ class HttpClientFactory * @param \GuzzleHttp\Event\SubscriberInterface $authenticatorSubscriber * @param \GuzzleHttp\Cookie\CookieJar $cookieJar * @param string $restrictedAccess this param is a kind of boolean. Values: 0 or 1 + * @param LoggerInterface $logger */ - public function __construct(SubscriberInterface $authenticatorSubscriber, CookieJar $cookieJar, $restrictedAccess) + public function __construct(SubscriberInterface $authenticatorSubscriber, CookieJar $cookieJar, $restrictedAccess, LoggerInterface $logger) { $this->authenticatorSubscriber = $authenticatorSubscriber; $this->cookieJar = $cookieJar; $this->restrictedAccess = $restrictedAccess; + $this->logger = $logger; } /** @@ -39,8 +43,10 @@ class HttpClientFactory */ public function buildHttpClient() { + $this->logger->log('debug', 'Restricted access config enabled?', array('enabled' => (int) $this->restrictedAccess)); + if (0 === (int) $this->restrictedAccess) { - return null; + return; } // we clear the cookie to avoid websites who use cookies for analytics diff --git a/src/Wallabag/CoreBundle/Repository/EntryRepository.php b/src/Wallabag/CoreBundle/Repository/EntryRepository.php index b9532fa25..4071301de 100644 --- a/src/Wallabag/CoreBundle/Repository/EntryRepository.php +++ b/src/Wallabag/CoreBundle/Repository/EntryRepository.php @@ -106,8 +106,9 @@ class EntryRepository extends EntityRepository $qb->andWhere('e.isArchived = true'); } + // We lower() all parts here because PostgreSQL 'LIKE' verb is case-sensitive $qb - ->andWhere('e.content LIKE :term OR e.title LIKE :term')->setParameter('term', '%'.$term.'%') + ->andWhere('lower(e.content) LIKE lower(:term) OR lower(e.title) LIKE lower(:term) OR lower(e.url) LIKE lower(:term)')->setParameter('term', '%'.$term.'%') ->leftJoin('e.tags', 't') ->groupBy('e.id'); diff --git a/src/Wallabag/CoreBundle/Resources/config/services.yml b/src/Wallabag/CoreBundle/Resources/config/services.yml index 036735ec8..51d6ab47b 100644 --- a/src/Wallabag/CoreBundle/Resources/config/services.yml +++ b/src/Wallabag/CoreBundle/Resources/config/services.yml @@ -74,6 +74,7 @@ services: - "@bd_guzzle_site_authenticator.authenticator_subscriber" - "@wallabag_core.guzzle.cookie_jar" - '@=service(''craue_config'').get(''restricted_access'')' + - '@logger' wallabag_core.guzzle.cookie_jar: class: GuzzleHttp\Cookie\FileCookieJar diff --git a/src/Wallabag/CoreBundle/Resources/translations/messages.es.yml b/src/Wallabag/CoreBundle/Resources/translations/messages.es.yml index 8ae1c400e..3d65c311b 100644 --- a/src/Wallabag/CoreBundle/Resources/translations/messages.es.yml +++ b/src/Wallabag/CoreBundle/Resources/translations/messages.es.yml @@ -1,7 +1,7 @@ security: login: - page_title: '¡Bienvenido a wallabag !' - keep_logged_in: 'Manténgame conectado' + page_title: '¡Bienvenido a wallabag!' + keep_logged_in: 'Permanecer conectado' forgot_password: '¿Se ha olvidado de su contraseña?' submit: 'Conectarse' register: 'Registrarse' @@ -9,7 +9,7 @@ security: password: 'Contraseña' cancel: 'Cancelar' resetting: - description: "Introduzca su dirección del correo electrónico y le enviaremos las instrucciones para reiniciar la contraseña" + description: "Introduzca su dirección de correo electrónico y le enviaremos las instrucciones para reiniciar la contraseña." register: page_title: 'Crear una cuenta' go_to_account: 'Acceder su cuenta' @@ -19,19 +19,19 @@ menu: unread: 'Sin leer' starred: 'Favoritos' archive: 'Archivo' - all_articles: 'Todos artículos' + all_articles: 'Todos los artículos' config: 'Configuración' tags: 'Etiquetas' internal_settings: 'Configuración interna' import: 'Importar' howto: 'Ayuda' - # developer: 'API clients management' + developer: 'Configuración de clientes API' logout: 'Desconectarse' about: 'Acerca de' search: 'Buscar' - save_link: 'Archivar un enlace' + save_link: 'Guardar un enlace' back_to_unread: 'Volver a los artículos sin leer' - # users_management: 'Users management' + users_management: 'Configuración de usuarios' top: add_new_entry: 'Añadir un nuevo artículo' search: 'Buscar' @@ -42,11 +42,11 @@ menu: footer: wallabag: - elsewhere: 'Lleve wallabag consigo' + elsewhere: 'Lleva wallabag contigo' social: 'Social' - powered_by: 'funciona por' + powered_by: 'funciona con' about: 'Acerca de' - # stats: Since %user_creation% you read %nb_archives% articles. That is about %per_day% a day! + stats: Desde el %user_creation% has leído %nb_archives% artículos. ¡Eso hace unos %per_day% por día! config: page_title: 'Configuración' @@ -64,96 +64,96 @@ config: items_per_page_label: 'Número de artículos por página' language_label: 'Idioma' reading_speed: - label: 'Velocidad de leer' - help_message: 'Se puede usar las técnicas para calcular su velocidad de leer:' + label: 'Velocidad de lectura' + help_message: 'Puede utilizar herramientas en línea para calcular su velocidad de lectura:' 100_word: 'Leo ~100 palabras por minuto' 200_word: 'Leo ~200 palabras por minuto' 300_word: 'Leo ~300 palabras por minuto' 400_word: 'Leo ~400 palabras por minuto' action_mark_as_read: - # label: 'Where do you to be redirected after mark an article as read?' - # redirect_homepage: 'To the homepage' - # redirect_current_page: 'To the current page' - # pocket_consumer_key_label: Consumer key for Pocket to import contents - # android_configuration: Configure your Android application - # help_theme: "wallabag is customizable. You can choose your prefered theme here." - # help_items_per_page: "You can change the number of articles displayed on each page." - # help_reading_speed: "wallabag calculates a reading time for each article. You can define here, thanks to this list, if you are a fast or a slow reader. wallabag will recalculate the reading time for each article." - # help_language: "You can change the language of wallabag interface." - # help_pocket_consumer_key: "Required for Pocket import. You can create it in your Pocket account." + label: '¿Dónde quieres ser redirigido después de marcar un artículo como leído?' + redirect_homepage: 'A la página de inicio' + redirect_current_page: 'A la página actual' + pocket_consumer_key_label: Clave de consumidor para importar contenidos de Pocket + android_configuration: Configura tu aplicación Android + help_theme: "wallabag es personalizable. Puedes elegir tu tema preferido aquí." + help_items_per_page: "Puedes cambiar el número de artículos mostrados en cada página." + help_reading_speed: "wallabag calcula un tiempo de lectura para cada artículo. Puedes definir aquí, gracias a esta lista, si eres un lector rápido o lento. wallabag recalculará el tiempo de lectura para cada artículo." + help_language: "Puedes cambiar el idioma de la interfaz de wallabag." + help_pocket_consumer_key: "Requerido para la importación desde Pocket. Puedes crearla en tu cuenta de Pocket." form_rss: - description: 'Los feeds RSS de wallabag permiten leer los artículos guardados con su lector RSS favorito. Necesita generar un token primero' - token_label: 'RSS token' - no_token: 'No token' + description: 'Los feeds RSS de wallabag permiten leer los artículos guardados con su lector RSS favorito. Primero necesitas generar un token.' + token_label: 'Token RSS' + no_token: 'Sin token' token_create: 'Crear token' token_reset: 'Reiniciar token' - rss_links: 'URL de su feed RSS' + rss_links: 'URLs de feeds RSS' rss_link: unread: 'sin leer' starred: 'favoritos' - archive: 'archivo' + archive: 'archivados' rss_limit: 'Límite de artículos en feed RSS' form_user: - two_factor_description: "Con la autentificación de dos factores recibirá código mediante email en cada nueva conexión que no sea de confianza" + two_factor_description: "Con la autenticación en dos pasos recibirá código por e-mail en cada nueva conexión que no sea de confianza." name_label: 'Nombre' - email_label: 'Direccion e-mail' - twoFactorAuthentication_label: 'Autentificación de dos factores' - # help_twoFactorAuthentication: "If you enable 2FA, each time you want to login to wallabag, you'll receive a code by email." + email_label: 'Dirección de e-mail' + twoFactorAuthentication_label: 'Autenticación en dos pasos' + help_twoFactorAuthentication: "Si activas la autenticación en dos pasos, cada vez que quieras iniciar sesión en wallabag recibirás un código por e-mail." delete: - # title: Delete my account (a.k.a danger zone) - # description: If you remove your account, ALL your articles, ALL your tags, ALL your annotations and your account will be PERMANENTLY removed (it can't be UNDONE). You'll then be logged out. - # confirm: Are you really sure? (THIS CAN'T BE UNDONE) - # button: Delete my account + title: Eliminar mi cuenta (Zona peligrosa) + description: Si eliminas tu cuenta, TODOS tus artículos, TODAS tus etiquetas, TODAS tus anotaciones y tu cuenta serán eliminadas de forma PERMANENTE (no se puede deshacer). Después serás desconectado. + confirm: ¿Estás completamente seguro? (NO SE PUEDE DESHACER) + button: Eliminar mi cuenta reset: - # title: Reset area (a.k.a danger zone) - # description: By hiting buttons below you'll have ability to remove some informations from your account. Be aware that these actions are IRREVERSIBLE. - # annotations: Remove ALL annotations - # tags: Remove ALL tags - # entries: Remove ALL entries - # confirm: Are you really really sure? (THIS CAN'T BE UNDONE) + title: Reiniciar mi cuenta (Zona peligrosa) + description: Pulsando los botones de abajo puedes eliminar información de tu cuenta. Ten en cuenta que estas acciones son IRREVERSIBLES. + annotations: Eliminar TODAS las anotaciones + tags: Eliminar TODAS las etiquetas + entries: Eliminar TODOS los artículos + confirm: ¿Estás completamente seguro? (NO SE PUEDE DESHACER) form_password: - # description: "You can change your password here. Your new password should by at least 8 characters long." + description: "Puedes cambiar la contraseña aquí. Tu nueva contraseña debe tener al menos 8 caracteres." old_password_label: 'Contraseña actual' new_password_label: 'Nueva contraseña' - repeat_new_password_label: 'Confirmar la nueva contraseña' + repeat_new_password_label: 'Confirmar nueva contraseña' form_rules: if_label: 'si' - then_tag_as_label: 'Etiquete como' - delete_rule_label: 'Borre' - # edit_rule_label: 'edit' + then_tag_as_label: 'etiquetar como' + delete_rule_label: 'borrar' + edit_rule_label: 'editar' rule_label: 'Regla' tags_label: 'Etiquetas' faq: - title: 'FAQ' - tagging_rules_definition_title: '¿Qué significa reglas de etiquetado autómaticas?' - tagging_rules_definition_description: 'Son las reglas usadas por Wallabag para etiquetar automáticamente los nuevos artículos.
Cada vez que un nuevo artículo sea añadido, todas las reglas de etiquetado automáticas serán usadas para etiquetarlo, ayudándole a clasificar automáticamente los artículos.' + title: 'Preguntas frecuentes' + tagging_rules_definition_title: '¿Qué significa « reglas de etiquetado automático »?' + tagging_rules_definition_description: 'Son las reglas usadas por wallabag para etiquetar automáticamente los nuevos artículos.
Cada vez que un artículo sea añadido, todas las reglas de etiquetado automático serán usadas para etiquetarlo, ayudándote a clasificar automáticamente tus artículos.' how_to_use_them_title: '¿Cómo se utilizan?' - how_to_use_them_description: 'Supongamos que quiere etiquetar nuevos artículos como « lectura corta » cuando el tiempo de leer sea menos de 3 minutos.
En ese caso, debe poner « tiempo de leer <= 3 » en el Regla campo y « lectura corta » en el Etiquetas campo.
Algunas etiquetas se pueden ser añadidas al mismo tiempo por separarlas con una coma: « lectura corta, debe leer »
Reglas complejas se pueden ser escritas por usar operadores predefinidos: si « tiempo de leer >= 5 Y nombre del dominio = "github.com" » entonces etiquete como « lectura larga, github »' + how_to_use_them_description: 'Supongamos que quiere etiquetar los artículos nuevos como « lectura corta » cuando el tiempo de lectura sea menos de 3 minutos.
En ese caso, debe poner « readingTime <= 3 » en el campo Regla y « lectura corta » en el campo Etiquetas.
Se pueden añadir varias etiquetas al mismo tiempo separadas por comas: « lectura corta, lectura obligada »
Se pueden escribir reglas complejas utilizando los operadores predefinidos: si « readingTime >= 5 AND domainName = "github.com" » entonces etiqueta como « lectura larga, github »' variables_available_title: '¿Qué variables y operadores se pueden utilizar para escribir las reglas?' - variables_available_description: 'Las siguientes variables y operadores se pueden utilizar para crear las reglas de etiquetado automáticas:' + variables_available_description: 'Las siguientes variables y operadores se pueden utilizar para crear reglas de etiquetado automático:' meaning: 'Significado' variable_description: label: 'Variable' - title: 'Titúlo del artículo' + title: 'Título del artículo' url: 'URL del artículo' - isArchived: 'El artículo está guardado o no' - isStarred: 'Si el artículo es un favorito o no' + isArchived: 'Si artículo está archivado o no' + isStarred: 'Si el artículo está en favoritos o no' content: "El contenido del artículo" language: "El idioma del artículo" - mimetype: "Tipo MIME del artículo" + mimetype: "El tipo MIME del artículo" readingTime: "El tiempo estimado de lectura del artículo, en minutos" - domainName: 'El dominio del artículo' + domainName: 'El nombre de dominio del artículo' operator_description: label: 'Operador' - less_than: 'Menos que…' - strictly_less_than: 'Estrictámente menos que…' - greater_than: 'Más que…' - strictly_greater_than: 'Estrictámente mas que…' - equal_to: 'Egual a…' + less_than: 'Menor que…' + strictly_less_than: 'Estrictamente menor que…' + greater_than: 'Mayor que…' + strictly_greater_than: 'Estrictamente mayor que…' + equal_to: 'Igual a…' not_equal_to: 'Diferente de…' or: 'Una regla U otra' and: 'Una regla Y la otra' - matches: 'Pruebe si un sujeto corresponde a una búsqueda (insensible a mayusculas).
Ejemplo : título coincide "football"' + matches: 'Prueba si un sujeto corresponde a una búsqueda (insensible a mayusculas).
Ejemplo : title matches "fútbol"' entry: page_titles: @@ -161,32 +161,32 @@ entry: starred: 'Artículos favoritos' archived: 'Artículos archivados' filtered: 'Artículos filtrados' - # filtered_tags: 'Filtered by tags:' - # filtered_search: 'Filtered by search:' - # untagged: 'Untagged entries' + filtered_tags: 'Filtrado por etiquetas:' + filtered_search: 'Filtrado por búsqueda:' + untagged: 'Artículos sin etiquetas' list: number_on_the_page: '{0} No hay artículos.|{1} Hay un artículo.|]1,Inf[ Hay %count% artículos.' reading_time: 'tiempo estimado de lectura' reading_time_minutes: 'tiempo estimado de lectura: %readingTime% min' reading_time_less_one_minute: 'tiempo estimado de lectura: < 1 min' - # number_of_tags: '{1}and one other tag|]1,Inf[and %count% other tags' + number_of_tags: '{1}y una etiqueta más|]1,Inf[y %count% etiquetas más' reading_time_minutes_short: '%readingTime% min' reading_time_less_one_minute_short: '< 1 min' original_article: 'original' - toogle_as_read: 'Marcar como leído/ no leído' - toogle_as_star: 'Marcar como favorito/ no favorito' - delete: 'Suprimir' + toogle_as_read: 'Marcar como leído / no leído' + toogle_as_star: 'Marcar como favorito / no favorito' + delete: 'Eliminar' export_title: 'Exportar' filters: title: 'Filtros' - status_label: 'Estatus' + status_label: 'Estado' archived_label: 'Archivado' starred_label: 'Favorito' unread_label: 'Sin leer' - preview_picture_label: 'Hay una foto' - preview_picture_help: 'Foto de preview' + preview_picture_label: 'Tiene imagen de previsualización' + preview_picture_help: 'Imagen de previsualización' language_label: 'Idioma' - # http_status_label: 'HTTP status' + http_status_label: 'Código de estado HTTP' reading_time: label: 'Duración de lectura en minutos' from: 'de' @@ -208,12 +208,12 @@ entry: set_as_starred: 'Marcar como favorito' view_original_article: 'Artículo original' re_fetch_content: 'Redescargar el contenido' - delete: 'Suprimir' + delete: 'Eliminar' add_a_tag: 'Añadir una etiqueta' share_content: 'Compartir' - share_email_label: 'Dirección e-mail' - # public_link: 'public link' - # delete_public_link: 'delete public link' + share_email_label: 'e-mail' + public_link: 'enlace público' + delete_public_link: 'eliminar enlace público' download: 'Descargar' print: 'Imprimir' problem: @@ -225,32 +225,32 @@ entry: created_at: 'Fecha de creación' new: page_title: 'Guardar un nuevo artículo' - placeholder: 'http://website.com' + placeholder: 'http://sitioweb.com' form_new: - url_label: Url + url_label: URL search: - # placeholder: 'What are you looking for?' + placeholder: '¿Qué estás buscando?' edit: page_title: 'Editar un artículo' title_label: 'Título' - url_label: 'Url' - is_public_label: 'Es Público' + url_label: 'URL' + is_public_label: 'Es público' save_label: 'Guardar' public: - # shared_by_wallabag: "This article has been shared by wallabag" + shared_by_wallabag: "Este artículo se ha compartido con wallabag" about: page_title: 'Acerca de' top_menu: - who_behind_wallabag: 'Equipo del desarrollo de wallabag' + who_behind_wallabag: 'Quién está detrás de wallabag' getting_help: 'Pedir ayuda' helping: 'Ayudar a wallabag' contributors: 'Colaboradores' - third_party: 'Librerías de terceros' + third_party: 'Bibliotecas de terceros' who_behind_wallabag: developped_by: 'Desarrollado por' website: 'Sitio web' - many_contributors: 'Y muchos otros colaboradores ♥ en Github' + many_contributors: 'Y otros muchos colaboradores ♥ en Github' project_website: 'Sitio web del proyecto' license: 'Licencia' version: 'Versión' @@ -259,306 +259,306 @@ about: bug_reports: 'Reporte de errores' support: 'en GitHub' helping: - description: 'wallabag es libre y gratuito. Usted puede ayudarnos :' + description: 'wallabag es software libre y gratuito. Usted puede ayudarnos :' by_contributing: 'contribuyendo al proyecto :' by_contributing_2: 'nuestras necesidades están en un ticket' - by_paypal: 'via Paypal' + by_paypal: 'vía Paypal' contributors: description: 'Gracias a los colaboradores de la aplicación web de wallabag' third_party: - description: 'Aquí está la lista de las dependencias utilizadas por wallabag (con sus licencias) :' + description: 'Aquí está la lista de bibliotecas de terceros utilizadas por wallabag (con sus licencias) :' package: 'Paquete' license: 'Licencia' howto: page_title: 'Ayuda' - page_description: 'Hay muchas maneras para guardar un artículo:' tab_menu: - # add_link: "Add a link" - # shortcuts: "Use shortcuts" + add_link: "Añadir un artículo" + shortcuts: "Utilizar atajos de teclado" + page_description: 'Hay muchas maneras de guardar un artículo:' top_menu: - browser_addons: 'Extensiones de navigador' + browser_addons: 'Extensiones de navegador' mobile_apps: 'Aplicaciones para smartphone' bookmarklet: 'Bookmarklet' form: description: 'Gracias a este formulario' browser_addons: - firefox: 'Extensión Firefox' - chrome: 'Extensión Chrome' - opera: 'Extensión Opera' + firefox: 'Extensión para Firefox' + chrome: 'Extensión para Chrome' + opera: 'Extensión para Opera' mobile_apps: android: - via_f_droid: 'via F-Droid' - via_google_play: 'via Google Play' - ios: 'por la tienda de iTunes' - windows: 'por la tienda de Microsoft' + via_f_droid: 'en F-Droid' + via_google_play: 'en Google Play' + ios: 'en la tienda de iTunes' + windows: 'en la tienda de Microsoft' bookmarklet: - description: 'Desplazar y soltar este link en la barra de marcadores :' + description: 'Arrastra y suelta este enlace en la barra de marcadores:' shortcuts: - # page_description: Here are the shortcuts available in wallabag. - # shortcut: Shortcut - # action: Action - # all_pages_title: Shortcuts available in all pages - # go_unread: Go to unread - # go_starred: Go to starred - # go_archive: Go to archive - # go_all: Go to all entries - # go_tags: Go to tags - # go_config: Go to config - # go_import: Go to import - # go_developers: Go to developers - # go_howto: Go to howto (this page!) - # go_logout: Logout - # list_title: Shortcuts available in listing pages - # search: Display the search form - # article_title: Shortcuts available in entry view - # open_original: Open original URL of the entry - # toggle_favorite: Toggle star status for the entry - # toggle_archive: Toggle read status for the entry - # delete: Delete the entry - # material_title: Shortcuts available with Material theme only - # add_link: Add a new link - # hide_form: Hide the current form (search or new link) - # arrows_navigation: Navigate through articles - # open_article: Display the selected entry + page_description: Estos son los atajos de teclado disponibles en wallabag. + shortcut: Atajo de teclado + action: Acción + all_pages_title: Atajos de teclado disponibles en todas las páginas + go_unread: Ir a sin leer + go_starred: Ir a favoritos + go_archive: Ir a archivados + go_all: Ir a todos los artículos + go_tags: Ir a etiquetas + go_config: Ir a configuración + go_import: Ir a importar + go_developers: Ir a desarrolladores + go_howto: Ir a ayuda (esta página) + go_logout: Desconectar + list_title: Atajos de teclado disponibles en las páginas de listados + search: Mostrar el formulario de búsqueda + article_title: Atajos de teclado disponibles en el artículo + open_original: Abrir la URL original de un artículo + toggle_favorite: Marcar como favorito / no favorito el artículo + toggle_archive: marcar como leído / no leído el artículo + delete: Borrar el artículo + material_title: Atajos de teclado disponibles solo en el tema Material + add_link: Añadir un nuevo artículo + hide_form: Ocultar el formulario actual (búsqueda o nuevo artículo) + arrows_navigation: Navegar por los artículos + open_article: Mostrar el artículo seleccionado quickstart: - page_title: 'Comienzo rápido' - # more: 'More…' + page_title: 'Inicio rápido' + more: 'Más…' intro: - title: 'Bienvenido a wallabag !' - paragraph_1: "Le acompañaremos a su visita de wallabag y le mostraremos algunas características que le pueden interesar." - paragraph_2: '¡Síganos!' + title: '¡Bienvenido a wallabag!' + paragraph_1: "Le acompañaremos en su visita a wallabag y le mostraremos algunas características que le pueden interesar." + paragraph_2: '¡Síguenos!' configure: title: 'Configure la aplicación' - # description: 'In order to have an application which suits you, have a look into the configuration of wallabag.' - language: 'Cambie el idioma y el diseño de la aplicación' + description: 'Para que la aplicación se ajuste a tus necesidades, echa un vistazo a la configuración de wallabag.' + language: 'Cambie el idioma y el diseño' rss: 'Activar los feeds RSS' - tagging_rules: 'Escribir reglas para etiquetear automaticamente sus artículos' + tagging_rules: 'Escribe reglas para etiquetar automáticamente tus artículos' admin: title: 'Administración' - description: 'Como administrador, tiene privilegios por wallabag. Se puede:' + description: 'Como administrador, tiene algunos privilegios en wallabag. Puedes:' new_user: 'Crear un nuevo usuario' - analytics: 'Configure analíticas' - sharing: 'Active unos parámetros de compartir artículos' - export: 'Configure exportación' - import: 'Configure importación' + analytics: 'Configurar analíticas' + sharing: 'Activar algunos parámetros de compartir artículos' + export: 'Configurar exportación' + import: 'Configurar importación' first_steps: title: 'Primeros pasos' - # description: "Now wallabag is well configured, it's time to archive the web. You can click on the top right sign + to add a link." - new_article: 'Guarde su primer artículo' - unread_articles: '¡Y clasifíquelo!' + description: "Ahora que wallabag está bien configurado, es el momento de archivar la web. Puedes hacer clic en el signo + de la parte superior derecha para añadir un artículo." + new_article: 'Guarda tu primer artículo' + unread_articles: '¡Y clasifícalo!' migrate: title: 'Migrar de un servicio existente' - description: "¿Está usando otro servicio? Le ayudaremos a migrar sus datos a wallabag." + description: "¿Estás usando otro servicio? Le ayudaremos a migrar sus datos a wallabag." pocket: 'Migrar desde Pocket' wallabag_v1: 'Migrar desde wallabag v1' wallabag_v2: 'Migrar desde wallabag v2' readability: 'Migrar desde Readability' instapaper: 'Migrar desde Instapaper' developer: - title: 'Promotores' - # description: 'We also thought to the developers: Docker, API, translations, etc.' - create_application: 'Cree su tercera aplicación' - # use_docker: 'Use Docker to install wallabag' + title: 'Desarrolladores' + description: 'Nosotros también pensamos en los desarrolladores: Docker, API, traducciones, etc.' + create_application: 'Cree su aplicación de terceros' + use_docker: 'Utilice Docker para instalar wallabag' docs: title: 'Documentación completa' - # description: "There are so much features in wallabag. Don't hesitate to read the manual to know them and to learn how to use them." - annotate: 'Anote su artículo' - export: 'Convierta sus artículos a ePub o a PDF' - search_filters: 'Aprenda a utilizar el buscador y los filtros para encontrar el artículo que le interese' - fetching_errors: '¿Qué puedo hacer si un artículo encuentra errores por la búsqueda?' + description: "Hay muchas funcionalidades en wallabag. No dudes en leer el manual para conocerlas y aprender a utilizarlas." + annotate: 'Anotar en un artículo' + export: 'Convertir tus artículos a ePUB o PDF' + search_filters: 'Aprender a utilizar el buscador y los filtros para encontrar artículos' + fetching_errors: '¿Qué puedo hacer si se encuentran errores mientras se descarga un artículo?' all_docs: '¡Y muchos más artículos!' support: title: 'Apoyo' - description: 'Si necesita ayuda, estamos disponibles para usted.' + description: 'Si necesitas ayuda, estamos a tu disposición.' github: 'En GitHub' - email: 'Por email' + email: 'Por e-mail' gitter: 'En Gitter' tag: page_title: 'Etiquetas' list: number_on_the_page: '{0} No hay ninguna etiqueta.|{1} Hay una etiqueta.|]1,Inf[ Hay %count% etiquetas.' - # see_untagged_entries: 'See untagged entries' + see_untagged_entries: 'Ver artículos sin etiquetas' new: - # add: 'Add' - # placeholder: 'You can add several tags, separated by a comma.' + add: 'Añadir' + placeholder: 'Puedes añadir varias etiquetas, separadas por una coma.' import: page_title: 'Importar' - page_description: 'Bienvenido al útil de migración de wallabag. Seleccione el servicio previo del que usted quiera migrar.' + page_description: 'Bienvenido a la herramienta de importación de wallabag. Seleccione el servicio desde el que desea migrar.' action: import_contents: 'Importar los contenidos' form: mark_as_read_title: '¿Marcar todos como leídos?' mark_as_read_label: 'Marcar todos artículos importados como leídos' - file_label: 'Fichero' - save_label: 'Importar el fichero' + file_label: 'Archivo' + save_label: 'Subir el archivo' pocket: page_title: 'Importar > Pocket' - description: "Va a importar sus datos de Pocket. Pocket no nos permite descargar el contenido de su servicio, así que el contenido de cada artículo será redescargado por wallabag." + description: "Importa todos tus datos de Pocket. Pocket no nos permite descargar el contenido desde su servicio, de manera que el contenido de cada artículo será redescargado por wallabag." config_missing: description: "La importación de Pocket no está configurada." - admin_message: 'Debe definir %keyurls%una clava del API Pocket%keyurle%.' - user_message: 'El administrador de su servidor debe definir una clave API Pocket.' - authorize_message: 'Puede importar sus datos desde su cuenta de Pocket. Sólo tiene que oprimir el botón para autorizar que wallabag se conecte a getpocket.com.' - connect_to_pocket: 'Conéctese a Pocket para importar los datos' + admin_message: 'Debe definir %keyurls%una clave del API Pocket%keyurle%.' + user_message: 'El administrador de su servidor debe definir una clave del API Pocket.' + authorize_message: 'Puede importar sus datos desde su cuenta de Pocket. Sólo tiene que hacer clic el botón para autorizar que wallabag se conecte a getpocket.com.' + connect_to_pocket: 'Conectar a Pocket e importar los datos' wallabag_v1: page_title: 'Importar > Wallabag v1' - description: 'Va a importar sus artículos de wallabag v1. En su configuración de wallabag v1, oprima "Exportar JSON" dentro de la sección "Exportar sus datos de wallabag". Usted tendrá un fichero "wallabag-export-1-xxxx-xx-xx.json".' - how_to: 'Seleccione el fichero de su exportación de wallabag v1 y oprima el botón para subirlo y importarlo.' + description: 'Importa todos tus artículos de wallabag v1. En la configuración de wallabag v1, haga clic en "Exportar JSON" dentro de la sección "Exportar datos de wallabag". Obtendrás un archivo llamado "wallabag-export-1-xxxx-xx-xx.json".' + how_to: 'Seleccione el archivo exportado de wallabag v1 y haga clic en el botón para subirlo e importarlo.' wallabag_v2: page_title: 'Importar > Wallabag v2' - description: 'Va a importar sus artículos de otra instancia de wallabag v2. Vaya a Todos los artículos, entonces, en la barra lateral, oprima en "JSON". Usted tendrá un fichero "All articles.json"' + description: 'Importa todos tus artículos de wallabag v2. En la sección Todos los artículos, en la barra lateral, haga clic en "JSON". Obtendrás un archivo llamado "All articles.json".' readability: page_title: 'Importar > Readability' - # description: 'This importer will import all your Readability articles. On the tools (https://www.readability.com/tools/) page, click on "Export your data" in the "Data Export" section. You will received an email to download a json (which does not end with .json in fact).' - # how_to: 'Please select your Readability export and click on the below button to upload and import it.' + description: 'Importa todos tus artículos de Readability. En la página de herramientas (https://www.readability.com/tools/), haga clic en "Exportar tus datos" en la sección "Exportar datos". Recibirás un e-mail para descargar un JSON (que no tiene extensión .json).' + how_to: 'Seleccione el archivo exportado de Readability y haga clic en el botón para subirlo e importarlo.' worker: - # enabled: "Import is made asynchronously. Once the import task is started, an external worker will handle jobs one at a time. The current service is:" - # download_images_warning: "You enabled downloading images for your articles. Combined with classic import it can take ages to proceed (or maybe failed). We strongly recommend to enable asynchronous import to avoid errors." + enabled: "La importación se realiza de forma asíncrona. Una vez que la tarea de importación ha comenzado, un trabajador externo se encargará de los artículos uno a uno. El servicio actual es:" + download_images_warning: "Tienes activado descargar imágenes de los artículos. Esto justo con la importación clásica de artículos puede tardar mucho tiempo en ser procesado (o incluso fallar). Recomendamos encarecidamente habilitar la importación asíncrona para evitar errores." firefox: page_title: 'Importar > Firefox' - # description: "This importer will import all your Firefox bookmarks. Just go to your bookmarks (Ctrl+Maj+O), then into \"Import and backup\", choose \"Backup...\". You will obtain a .json file." - # how_to: "Please choose the bookmark backup file and click on the button below to import it. Note that the process may take a long time since all articles have to be fetched." + description: "Importa todos tus marcadores de Firefox. En la ventana de marcadores (Ctrl+Mayus+O), en \"Importar y respaldar\", elige \"Copiar...\". Obtendrás un archivo .json." + how_to: "Seleccione el archivo exportado de Firefox y haga clic en el botón para subirlo e importarlo. Tenga en cuenta que este proceso puede tardar ya que se tienen que descargar todos los artículos." chrome: page_title: 'Importar > Chrome' - # description: "This importer will import all your Chrome bookmarks. The location of the file depends on your operating system :
  • On Linux, go into the ~/.config/chromium/Default/ directory
  • On Windows, it should be at %LOCALAPPDATA%\\Google\\Chrome\\User Data\\Default
  • On OS X, it should be at ~/Library/Application Support/Google/Chrome/Default/Bookmarks
Once you got there, copy the Bookmarks file someplace you'll find.
Note that if you have Chromium instead of Chrome, you'll have to correct paths accordingly.

" - # how_to: "Please choose the bookmark backup file and click on the button below to import it. Note that the process may take a long time since all articles have to be fetched." + description: "Importa todos tus marcadores de Chrome. La ubicación del archivo depende de tu sistema operativo :
  • En Linux, ~/.config/chromium/Default/
  • En Windows, %LOCALAPPDATA%\\Google\\Chrome\\User Data\\Default
  • En OS X, ~/Library/Application Support/Google/Chrome/Default/Bookmarks
Una vez estés en ese directorio, copia el archivo de favoritos (bookmarks) en algún sitio fácil de encontrar.
Ten en cuenta que si utilizas Chromium en vez de Chrome, la ubicación del archivo cambia.

" + how_to: "Seleccione el archivo exportado de Chrome y haga clic en el botón para subirlo e importarlo. Tenga en cuenta que este proceso puede tardar ya que se tienen que descargar todos los artículos." instapaper: page_title: 'Importar > Instapaper' - # description: 'This importer will import all your Instapaper articles. On the settings (https://www.instapaper.com/user) page, click on "Download .CSV file" in the "Export" section. A CSV file will be downloaded (like "instapaper-export.csv").' - # how_to: 'Please select your Instapaper export and click on the below button to upload and import it.' + description: 'Importa todos tus artículos de Instapaper. En la página de preferencias (https://www.instapaper.com/user), haz clic en "Descargar archivo .CSV" en la sección "Exportar". Obtendrás un archivo CSV llamado "instapaper-export.csv".' + how_to: 'Seleccione el archivo exportado de Instapaper y haga clic en el botón para subirlo e importarlo.' pinboard: page_title: "Importar > Pinboard" - # description: 'This importer will import all your Instapaper articles. On the backup (https://pinboard.in/settings/backup) page, click on "JSON" in the "Bookmarks" section. A JSON file will be downloaded (like "pinboard_export").' - # how_to: 'Please select your Pinboard export and click on the below button to upload and import it.' + description: 'Importa todos tus artículos de Pinboard. En la página de backup (https://pinboard.in/settings/backup), haz clic en "JSON" en la sección "Marcadores". Obtendrás un archivo JSON llamado "pinboard_export".' + how_to: 'Seleccione el archivo exportado de Pinboard y haga clic en el botón para subirlo e importarlo.' developer: - # page_title: 'API clients management' - welcome_message: 'Bienvenido a wallabag API' + page_title: 'Gestión de clientes API' + welcome_message: 'Bienvenido al API de wallabag' documentation: 'Documentación' how_to_first_app: 'Cómo crear mi primera aplicación' - full_documentation: 'Ver documentación de API entera' - list_methods: 'Hacer una lista de métodos API' + full_documentation: 'Ver documentación completa del API' + list_methods: 'Lista con los métodos del API' clients: title: 'Clientes' create_new: 'Crear un nuevo cliente' existing_clients: - title: 'Clientes actuales' - field_id: 'identificación del cliente' - field_secret: 'Cliente secreto' - field_uris: 'Redirigir los URI' - field_grant_types: 'Conceder manera permitida' - no_client: 'No cliente todavía.' + title: 'Clientes existentes' + field_id: 'Identificador del cliente' + field_secret: 'Secreto del cliente' + field_uris: 'URIs de redirección' + field_grant_types: 'Permisos concedidos' + no_client: 'Todavía no hay clientes.' remove: - warn_message_1: 'Se puede quitar este cliente. ¡Está acción no se puede ser irreversible !' - warn_message_2: "Si lo elimine, cada aplicación configurada con ese cliente no se puede ser autorizada por su wallbag." - action: 'Quite este cliente' + warn_message_1: 'Tienes permiso para eliminar el cliente %name%. ¡Está acción es IRREVERSIBLE!' + warn_message_2: "Si lo eliminas, cada aplicación configurada con ese cliente no podrá autenticarse en wallabag." + action: 'Eliminar el cliente %name%' client: - # page_title: 'API clients management > Nuevo cliente' - page_description: 'Va a crear un nuevo cliente. Por favor, llene el campo abajo para URI redirigido de su aplicación.' + page_title: 'Gestión de clientes API > Nuevo cliente' + page_description: 'Está a punto de crear un nuevo cliente. Por favor, rellene el campo de abajo con la URI de redirección de su aplicación.' form: - # name_label: 'Name of the client' - redirect_uris_label: 'los URI redirigidos' + name_label: 'Nombre del cliente' + redirect_uris_label: 'URIs de redirección' save_label: 'Crear un nuevo cliente' - action_back: 'Atrás' + action_back: 'Volver' client_parameter: - # page_title: 'API clients management > Parámetros del cliente' - page_description: 'Aquí hay sus parámetros del cliente.' - # field_name: 'Client name' - field_id: 'Identificación del cliente' - field_secret: 'Cliente secreto' - back: 'Atrás' - read_howto: 'Leer el howto "Crear mi primera aplicación"' + page_title: 'Gestión de clientes API > Parámetros del cliente' + page_description: 'Aquí están los parámetros del cliente.' + field_name: 'Nombre del cliente' + field_id: 'Identificador del cliente' + field_secret: 'Secreto del cliente' + back: 'Volver' + read_howto: 'Lea la guía "Crear mi primera aplicación"' howto: - # page_title: 'API clients management > Cómo crear mi primera aplicación' + page_title: 'Gestión de clientes API > Cómo crear mi primera aplicación' description: - paragraph_1: 'Los siguientes comandos se usan el HTTPie library. Esté seguro de que se instalen en sus sistema antes de usarlos.' - paragraph_2: 'Necesita un token para comunicar entre su tercera aplicación y wallabag API.' - paragraph_3: 'Para crear este token, necesita to create a new client.' - paragraph_4: 'Ahora, cree su token (reemplace cliente_id, cliente_secreto, usuario y contraseñ con las buenas entradas):' - paragraph_5: 'Este API devolverá una respuestas así:' - paragraph_6: 'El acceso_token es útil para hacer una llamada al final API. Por ejempolo:' - paragraph_7: 'Esta llamada devolverá todos los artículos para su usuario.' - paragraph_8: 'Si quiere ver todos los fines de API, se puede ver a nuestra documentación API.' - back: 'Atrás' + paragraph_1: 'Los siguientes comandos hacen uso de la biblioteca HTTPie. Compruebe que está instalada en su sistema antes de usarla.' + paragraph_2: 'Necesitas un token para establecer la comunicación entre una aplicación de terceros y la API de wallabag.' + paragraph_3: 'Para crear este token, necesitas crear un nuevo cliente.' + paragraph_4: 'Ahora crea tu token (reemplace client_id, client_secret, username y password con los valores generados):' + paragraph_5: 'Este API devolverá una respuesta como esta:' + paragraph_6: 'El access_token es útil para llamar a los métodos del API. Por ejemplo:' + paragraph_7: 'Esta llamada devolverá todos los artículos de tu usuario.' + paragraph_8: 'Si quiere ver todos los métodos del API, puede verlos en nuestra documentación del API.' + back: 'Volver' user: - # page_title: Users management - # new_user: Create a new user - # edit_user: Edit an existing user - # description: "Here you can manage all users (create, edit and delete)" - # list: - # actions: Actions - # edit_action: Edit - # yes: Yes - # no: No - # create_new_one: Create a new user + page_title: Gestión de usuarios + new_user: Crear un usuario + edit_user: Editar un usuario existente + description: "Aquí puedes gestionar todos los usuarios (crear, editar y eliminar)" + list: + actions: Acciones + edit_action: Editar + yes: Sí + no: No + create_new_one: Crear un usuario form: username_label: 'Nombre de usuario' - # name_label: 'Name' + name_label: 'Nombre' password_label: 'Contraseña' - repeat_new_password_label: 'Confirmar la nueva contraseña' + repeat_new_password_label: 'Confirmar la contraseña' plain_password_label: '????' - email_label: 'Email' - # enabled_label: 'Enabled' - # last_login_label: 'Last login' - # twofactor_label: Two factor authentication - # save: Save - # delete: Delete - # delete_confirm: Are you sure? - # back_to_list: Back to list + email_label: 'E-mail' + enabled_label: 'Activado' + last_login_label: 'Último inicio de sesión' + twofactor_label: Autenticación en dos pasos + save: Guardar + delete: Eliminar + delete_confirm: ¿Estás seguro? + back_to_list: Volver a la lista error: - # page_title: An error occurred + page_title: Ha ocurrido un error flashes: config: notice: config_saved: 'Configuración guardada.' password_updated: 'Contraseña actualizada' - password_not_updated_demo: "En modo demo, no puede cambiar la contraseña del usuario." - user_updated: 'Su información personal ha sido actualizada' - rss_updated: 'La configuración de los feeds RSS ha sido actualizada' - tagging_rules_updated: 'Regla de etiquetado borrada' - tagging_rules_deleted: 'Regla de etiquetado actualizada' - rss_token_updated: 'RSS token actualizado' - # annotations_reset: Annotations reset - # tags_reset: Tags reset - # entries_reset: Entries reset + password_not_updated_demo: "En el modo demo, no puede cambiar la contraseña del usuario." + user_updated: 'Información actualizada' + rss_updated: 'Configuración RSS actualizada' + tagging_rules_updated: 'Regla de etiquetado actualizada' + tagging_rules_deleted: 'Regla de etiquetado eliminada' + rss_token_updated: 'Token RSS actualizado' + annotations_reset: Anotaciones reiniciadas + tags_reset: Etiquetas reiniciadas + entries_reset: Artículos reiniciados entry: notice: - entry_already_saved: 'Entrada ya guardada por %fecha%' - entry_saved: 'Entrada guardada' - # entry_saved_failed: 'Entry saved but fetching content failed' - entry_updated: 'Entrada actualizada' - entry_reloaded: 'Entrada recargada' - # entry_reloaded_failed: 'Entry reloaded but fetching content failed' + entry_already_saved: 'Artículo ya guardado el %fecha%' + entry_saved: 'Artículo guardado' + entry_saved_failed: 'Artículo guardado pero falló la descarga del contenido' + entry_updated: 'Artículo actualizado' + entry_reloaded: 'Artículo redescargado' + entry_reloaded_failed: 'Artículo redescargado pero falló la descarga del contenido' entry_archived: 'Artículo archivado' entry_unarchived: 'Artículo desarchivado' - entry_starred: 'Artículo guardado en los favoritos' - entry_unstarred: 'Artículo retirado de los favoritos' - entry_deleted: 'Artículo suprimido' + entry_starred: 'Artículo marcado como favorito' + entry_unstarred: 'Artículo desmarcado como favorito' + entry_deleted: 'Artículo eliminado' tag: notice: tag_added: 'Etiqueta añadida' import: notice: - failed: 'Importación reprobada, por favor inténtelo de nuevo.' - failed_on_file: 'Se ocurre un error por procesar importación. Por favor verifique su archivo importado.' - summary: 'Resúmen importado: %importado% importado, %saltados% ya guardado.' - # summary_with_queue: 'Import summary: %queued% queued.' + failed: 'Importación fallida, por favor, inténtelo de nuevo.' + failed_on_file: 'Ocurrió un error al procesar la importación. Por favor, verifique el archivo importado.' + summary: 'Resúmen de la importación: %imported% importados, %skipped% ya guardados.' + summary_with_queue: 'Resúmen de la importación: %queued% encolados.' error: - # redis_enabled_not_installed: Redis is enabled for handle asynchronous import but it looks like we can't connect to it. Please check Redis configuration. - # rabbit_enabled_not_installed: RabbitMQ is enabled for handle asynchronous import but it looks like we can't connect to it. Please check RabbitMQ configuration. + redis_enabled_not_installed: Redis está activado para gestionar la importación asíncrona pero parece que no se puede conectar. Por favor, comprueba la configuración de Redis. + rabbit_enabled_not_installed: RabbitMQ está activado para gestionar la importación asíncrona pero parece que no se puede conectar. Por favor, comprueba la configuración de RabbitMQ. developer: notice: - client_created: 'Nuevo cliente creado.' - client_deleted: 'Cliente suprimido' + client_created: 'Creado el cliente %name%.' + client_deleted: 'Eliminado el cliente %name%' user: notice: - # added: 'User "%username%" added' - # updated: 'User "%username%" updated' - # deleted: 'User "%username%" deleted' + added: 'Añadido el usuario "%username%"' + updated: 'Actualizado el usuario "%username%"' + deleted: 'Eliminado el usuario "%username%"' diff --git a/src/Wallabag/CoreBundle/Resources/translations/messages.it.yml b/src/Wallabag/CoreBundle/Resources/translations/messages.it.yml index bb0ed48db..992ff71cb 100644 --- a/src/Wallabag/CoreBundle/Resources/translations/messages.it.yml +++ b/src/Wallabag/CoreBundle/Resources/translations/messages.it.yml @@ -344,7 +344,7 @@ quickstart: export: "Configura l'esportazione" import: "Configura l'importazione" first_steps: - title: 'Pimi passi' + title: 'Primi passi' # description: "Now wallabag is well configured, it's time to archive the web. You can click on the top right sign + to add a link." new_article: 'Salva il tuo primo contenuto' unread_articles: 'E classificalo!' diff --git a/src/Wallabag/CoreBundle/Resources/views/base.html.twig b/src/Wallabag/CoreBundle/Resources/views/base.html.twig index 289458d4f..020d8efc6 100644 --- a/src/Wallabag/CoreBundle/Resources/views/base.html.twig +++ b/src/Wallabag/CoreBundle/Resources/views/base.html.twig @@ -3,7 +3,7 @@ - + {% block head %} diff --git a/src/Wallabag/CoreBundle/Resources/views/themes/material/Entry/_card_full_image.html.twig b/src/Wallabag/CoreBundle/Resources/views/themes/material/Entry/_card_full_image.html.twig index 91a1bac0d..58757158a 100644 --- a/src/Wallabag/CoreBundle/Resources/views/themes/material/Entry/_card_full_image.html.twig +++ b/src/Wallabag/CoreBundle/Resources/views/themes/material/Entry/_card_full_image.html.twig @@ -11,8 +11,8 @@
- - {{ entry.title | e | raw | striptags | truncate(80, true, '…') }} + + {{ entry.title | striptags | truncate(80, true, '…') | raw }} diff --git a/src/Wallabag/CoreBundle/Resources/views/themes/material/Entry/_card_list.html.twig b/src/Wallabag/CoreBundle/Resources/views/themes/material/Entry/_card_list.html.twig index bb9b64ce0..3ba6253ab 100644 --- a/src/Wallabag/CoreBundle/Resources/views/themes/material/Entry/_card_list.html.twig +++ b/src/Wallabag/CoreBundle/Resources/views/themes/material/Entry/_card_list.html.twig @@ -2,7 +2,7 @@
- + {{ entry.title| striptags | truncate(120, true, '…') | raw }} diff --git a/src/Wallabag/CoreBundle/Resources/views/themes/material/Entry/_card_no_preview.html.twig b/src/Wallabag/CoreBundle/Resources/views/themes/material/Entry/_card_no_preview.html.twig index ed916e798..eb1586597 100644 --- a/src/Wallabag/CoreBundle/Resources/views/themes/material/Entry/_card_no_preview.html.twig +++ b/src/Wallabag/CoreBundle/Resources/views/themes/material/Entry/_card_no_preview.html.twig @@ -2,8 +2,8 @@
- - {{ entry.title | e | raw | striptags | truncate(80, true, '…') }} + + {{ entry.title | striptags | truncate(80, true, '…') | raw }} diff --git a/src/Wallabag/CoreBundle/Resources/views/themes/material/Entry/_card_preview.html.twig b/src/Wallabag/CoreBundle/Resources/views/themes/material/Entry/_card_preview.html.twig index d23be4d09..fb5301c80 100644 --- a/src/Wallabag/CoreBundle/Resources/views/themes/material/Entry/_card_preview.html.twig +++ b/src/Wallabag/CoreBundle/Resources/views/themes/material/Entry/_card_preview.html.twig @@ -13,8 +13,8 @@ more_vert - - {{ entry.title | e | striptags | truncate(80, true, '…') | raw }} + + {{ entry.title | striptags | truncate(80, true, '…') | raw }} @@ -29,8 +29,8 @@
clear - - {{ entry.title | e | raw | striptags | truncate(80, true, '…') }} + + {{ entry.title | striptags | truncate(80, true, '…') | raw }} diff --git a/src/Wallabag/CoreBundle/Resources/views/themes/material/Entry/entry.html.twig b/src/Wallabag/CoreBundle/Resources/views/themes/material/Entry/entry.html.twig index 15428b923..c35080830 100644 --- a/src/Wallabag/CoreBundle/Resources/views/themes/material/Entry/entry.html.twig +++ b/src/Wallabag/CoreBundle/Resources/views/themes/material/Entry/entry.html.twig @@ -1,6 +1,6 @@ {% extends "WallabagCoreBundle::layout.html.twig" %} -{% block title %}{{ entry.title|e|raw }} ({{ entry.domainName|removeWww }}){% endblock %} +{% block title %}{{ entry.title|striptags|raw }} ({{ entry.domainName|removeWww }}){% endblock %} {% block body_class %}entry{% endblock %} @@ -118,14 +118,14 @@ {% endif %} {% if craue_setting('share_twitter') %}
  • - + twitter
    • {% endif %} {% if craue_setting('share_shaarli') %}
  • - + shaarli @@ -133,7 +133,7 @@ {% endif %} {% if craue_setting('share_diaspora') %}
  • - + diaspora* @@ -141,7 +141,7 @@ {% endif %} {% if craue_setting('share_unmark') %}
  • - + unmark.it @@ -149,7 +149,7 @@ {% endif %} {% if craue_setting('carrot') %}
  • - + Carrot @@ -157,7 +157,7 @@ {% endif %} {% if craue_setting('share_mail') %}
  • -
    • @@ -209,7 +209,7 @@ {% block content %}
    -

    {{ entry.title|e|raw }} ✎

    +

    {{ entry.title|striptags|raw }} ✎

    {% if entry.previewPicture is not null %} -
    {{ entry.title|raw }}
    +
    {{ entry.title|striptags|e('html_attr') }}
    {% endif %} diff --git a/src/Wallabag/ImportBundle/Consumer/AbstractConsumer.php b/src/Wallabag/ImportBundle/Consumer/AbstractConsumer.php index fc175f671..992ce1adb 100644 --- a/src/Wallabag/ImportBundle/Consumer/AbstractConsumer.php +++ b/src/Wallabag/ImportBundle/Consumer/AbstractConsumer.php @@ -46,7 +46,8 @@ abstract class AbstractConsumer if (null === $user) { $this->logger->warning('Unable to retrieve user', ['entry' => $storedEntry]); - return false; + // return true to skip message + return true; } $this->import->setUser($user); diff --git a/src/Wallabag/UserBundle/Resources/translations/wallabag_user.es.yml b/src/Wallabag/UserBundle/Resources/translations/wallabag_user.es.yml new file mode 100644 index 000000000..eb867a763 --- /dev/null +++ b/src/Wallabag/UserBundle/Resources/translations/wallabag_user.es.yml @@ -0,0 +1,11 @@ +# Two factor mail +auth_code: + on: 'on' + mailer: + subject: 'código de autenticación de wallabag' + body: + hello: "Hola %user%," + first_para: "Debido a que tienes activada la autenticación en dos pasos y acabas de iniciar sesión en un nuevo dispositivo (ordenador, teléfono, etc.), hemos enviado un código para validar tu conexión." + second_para: "Este es el código:" + support: "Por favor, no dudes en contactarnos si tienes algún problema:" + signature: "El equipo de wallabag" diff --git a/tests/Wallabag/CoreBundle/Controller/EntryControllerTest.php b/tests/Wallabag/CoreBundle/Controller/EntryControllerTest.php index 06ed2db60..3eb6d47fb 100644 --- a/tests/Wallabag/CoreBundle/Controller/EntryControllerTest.php +++ b/tests/Wallabag/CoreBundle/Controller/EntryControllerTest.php @@ -1093,5 +1093,29 @@ class EntryControllerTest extends WallabagCoreTestCase $crawler = $client->submit($form, $data); $this->assertCount(0, $crawler->filter('div[class=entry]')); + + // test url search on list of all articles + $crawler = $client->request('GET', '/all/list'); + + $form = $crawler->filter('form[name=search]')->form(); + $data = [ + 'search_entry[term]' => 'domain', // the search will match an entry with 'domain' in its url + ]; + + $crawler = $client->submit($form, $data); + + $this->assertCount(1, $crawler->filter('div[class=entry]')); + + // same as previous test but for case-sensitivity + $crawler = $client->request('GET', '/all/list'); + + $form = $crawler->filter('form[name=search]')->form(); + $data = [ + 'search_entry[term]' => 'doMain', // the search will match an entry with 'domain' in its url + ]; + + $crawler = $client->submit($form, $data); + + $this->assertCount(1, $crawler->filter('div[class=entry]')); } } diff --git a/tests/Wallabag/ImportBundle/Consumer/AMQPEntryConsumerTest.php b/tests/Wallabag/ImportBundle/Consumer/AMQPEntryConsumerTest.php index 856954a64..a989ec7fd 100644 --- a/tests/Wallabag/ImportBundle/Consumer/AMQPEntryConsumerTest.php +++ b/tests/Wallabag/ImportBundle/Consumer/AMQPEntryConsumerTest.php @@ -183,7 +183,9 @@ JSON; $message = new AMQPMessage($body); - $consumer->execute($message); + $res = $consumer->execute($message); + + $this->assertTrue($res); } public function testMessageWithEntryProcessed() diff --git a/tests/Wallabag/ImportBundle/Consumer/RedisEntryConsumerTest.php b/tests/Wallabag/ImportBundle/Consumer/RedisEntryConsumerTest.php index 3b92f7596..78bd83ba3 100644 --- a/tests/Wallabag/ImportBundle/Consumer/RedisEntryConsumerTest.php +++ b/tests/Wallabag/ImportBundle/Consumer/RedisEntryConsumerTest.php @@ -182,7 +182,7 @@ JSON; $res = $consumer->manage($body); - $this->assertFalse($res); + $this->assertTrue($res); } public function testMessageWithEntryProcessed()