Italian documentation added

There are some missing links in various articles. Please let me know how I can fix this :)

docs/ita/developer/asynchronous.rst

@@ -0,0 +1,162 @@
+Compiti Asincroni
+=================
+
+Per avviare compiti asincroni (utile ad esempio per grandi importazioni), Possiamo usare RabbitMQ o Redis.
+
+Installare RabbitMQ per compiti asincroni
+-----------------------------------------
+
+Requisiti
+^^^^^^^^^
+
+Dovete avere RabbitMQ installato sul vostro server.
+
+Installazione
+^^^^^^^^^^^^^
+
+.. code:: bash
+
+  wget https://www.rabbitmq.com/rabbitmq-signing-key-public.asc
+  apt-key add rabbitmq-signing-key-public.asc
+  apt-get update
+  apt-get install rabbitmq-server
+
+Configurazione ed avvio
+^^^^^^^^^^^^^^^^^^^^^^^
+
+.. code:: bash
+
+  rabbitmq-plugins enable rabbitmq_management # (useful to have a web interface, available at http://localhost:15672/ (guest/guest)
+  rabbitmq-server -detached
+
+Fermare RabbitMQ
+^^^^^^^^^^^^^^^^
+
+.. code:: bash
+
+  rabbitmqctl stop
+
+
+Configurare RabbitMQ in wallabag
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Modificate il vostro file ``app/config/parameters.yml`` per modificare la configurazione di RabbitMQ. Quella di default dovrebbe andare bene:
+
+.. code:: yaml
+
+    rabbitmq_host: localhost
+    rabbitmq_port: 5672
+    rabbitmq_user: guest
+    rabbitmq_password: guest
+    rabbitmq_prefetch_count: 10 # read http://www.rabbitmq.com/consumer-prefetch.html
+
+Abilitare RabbitMQ su wallabag
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Su Strumenti, nella sezione **Importa**, abilitate RabbitMQ (con il valore 1).
+
+Avviare RabbitMQ consumer
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Dipendendo da quale servizio vogliate importare, dovrete abilitare uno (o più se volete supportare molti) o più cronjob:
+
+.. code:: bash
+
+  # per importare da Pocket
+  bin/console rabbitmq:consumer -e=prod import_pocket -w
+
+  # per importare da Readability
+  bin/console rabbitmq:consumer -e=prod import_readability -w
+
+  # per importare da Instapaper
+  bin/console rabbitmq:consumer -e=prod import_instapaper -w
+
+  # per importare da wallabag v1
+  bin/console rabbitmq:consumer -e=prod import_wallabag_v1 -w
+
+  # per importare da wallabag v2
+  bin/console rabbitmq:consumer -e=prod import_wallabag_v2 -w
+
+  # per importare da Firefox
+  bin/console rabbitmq:consumer -e=prod import_firefox -w
+
+  # per importare da Chrome
+  bin/console rabbitmq:consumer -e=prod import_chrome -w
+
+Installare Redis per compiti asincroni
+--------------------------------------
+
+Per avviare compiti asincroni (utile ad esempio per grandi importazioni), Possiamo usare Redis.
+
+Requisiti
+^^^^^^^^^
+
+Dovete avere Redis installato sul vostro server.
+
+Installazione
+^^^^^^^^^^^^^
+
+.. code:: bash
+
+  apt-get install redis-server
+
+
+Avvio
+^^^^^
+
+Il server dovrebbe già essere attivo dopo l'installazione, altrimenti potete avviarlo usando:
+
+.. code:: bash
+
+  redis-server
+
+
+Configurare Redis su wallabag
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Modificate il vostro file ``app/config/parameters.yml`` per modificare la configurazione di Redis. Quella di default dovrebbe andare bene:
+
+.. code:: yaml
+
+    redis_host: localhost
+    redis_port: 6379
+
+Abilitare Redis su wallabag
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Su Strumenti, nella sezione **Importa**, abilitate Redis (con il valore 1).
+
+Avviare Redis consumer
+^^^^^^^^^^^^^^^^^^^^^^
+
+Dipendendo da quale servizio vogliate importare, dovrete abilitare uno (o più se volete supportare molti) o più cronjob:
+
+.. code:: bash
+
+  # per importare da Pocket
+  bin/console wallabag:import:redis-worker -e=prod pocket -vv >> /path/to/wallabag/var/logs/redis-pocket.log
+
+  # per importare da Readability
+  bin/console wallabag:import:redis-worker -e=prod readability -vv >> /path/to/wallabag/var/logs/redis-readability.log
+
+  # per importare da Instapaper
+  bin/console wallabag:import:redis-worker -e=prod instapaper -vv >> /path/to/wallabag/var/logs/redis-instapaper.log
+
+  # per importare da wallabag v1
+  bin/console wallabag:import:redis-worker -e=prod wallabag_v1 -vv >> /path/to/wallabag/var/logs/redis-wallabag_v1.log
+
+  # per importare da wallabag v2
+  bin/console wallabag:import:redis-worker -e=prod wallabag_v2 -vv >> /path/to/wallabag/var/logs/redis-wallabag_v2.log
+
+  # per importare da Firefox
+  bin/console wallabag:import:redis-worker -e=prod firefox -vv >> /path/to/wallabag/var/logs/redis-firefox.log
+
+  # per importare da Chrome
+  bin/console wallabag:import:redis-worker -e=prod chrome -vv >> /path/to/wallabag/var/logs/redis-chrome.log
+
+Se volete avviare l'importazione solamente per alcuni messaggi e non tutti, potete specificare questo numero (qui 12) e il programma si fermerà dopo il dodicesimo messaggio:
+
+.. code:: bash
+
+  bin/console wallabag:import:redis-worker -e=prod pocket -vv --maxIterations=12
+

docs/ita/developer/docker.rst

@@ -0,0 +1,41 @@
+Eseguite wallabag in docker-compose
+===================================
+
+Per eseguire la vostra propria istanza di sviluppo di wallabag, dovreste usare i file docker compose preconfigurati.
+
+Requisiti
+---------
+
+Assicuratevi di avere `Docker
+<https://docs.docker.com/installation/ubuntulinux/>` e  `Docker
+Compose <https://docs.docker.com/compose/install/>`__  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!

docs/ita/developer/documentation.rst

@@ -0,0 +1,12 @@
+Contribuite a questa documentazione
+===================================
+
+Le fonti della nostra documentazione sono qui https://github.com/wallabag/wallabag/tree/master/docs
+
+Usiamo `ReadTheDocs
+<https://readthedocs.org>`__ per generarla.
+
+Le pagine sono scritte nel formato `Restructured Text
+<https://en.wikipedia.org/wiki/ReStructuredText>`__. 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 <https://raw.githubusercontent.com/wallabag/wallabag/master/docs/en/index.rst>`__ per aggiungere un link nella barra laterale.

docs/ita/developer/paywall.rst

@@ -0,0 +1,52 @@
+Articoli dietro ad un paywall
+=============================
+
+wallabag puó acquisire articoli da siti web che usano un sistema paywall
+
+Abilitate l'autenticazione paywall
+----------------------------------
+
+Su impostazioni interne, nella sezione **Articolo**, abilitate l'autenticazione per siti con paywall (con il valore 1).
+
+Configurate le credenziali in wallabag
+--------------------------------------
+
+Modificate il vostro file ``app/config/parameters.yml`` per modificare le credenziali per ogni sito con paywall. Ecco un esempio di alcuni siti francesi:
+
+.. code:: yaml
+
+    sites_credentials:
+        mediapart.fr: {username: "myMediapartLogin", password: "mypassword"}
+        arretsurimages.net: {username: "myASILogin", password: "mypassword"}
+
+.. note::
+
+    These credentials will be shared between each user of your wallabag instance.
+
+Fate il parsing dei file di configurazione
+------------------------------------------
+
+Leggete `questa parte della documentazione *link mancante*` per capire i file di configurazione.
+
+Ogni file di configurazione del parsing deve essere migliorato aggiungendo ``requires_login``, ``login_uri``, ``login_username_field``, ``login_password_field`` e ``not_logged_in_xpath``.
+
+Fate attenzione, il modulo di login deve essere nel contenuto della pagina quando wallabag lo carica. É impossibile per wallab essere autenticato su un sito dove il modulo di login é caricato dopo la pagina (da ajax per esempio).
+
+``login_uri`` é l'URL di azione del modulo (l'attributo ``action`` del modulo).
+``login_username_field`` é l'attributo ``name`` nel campo di login.
+``login_password_field`` é l'attributo ``name`` nel campo password.
+
+Per esempio:
+
+.. code::
+
+    title://div[@id="titrage-contenu"]/h1[@class="title"]
+    body: //div[@class="contenu-html"]/div[@class="page-pane"]
+
+    requires_login: yes
+
+    login_uri: http://www.arretsurimages.net/forum/login.php
+    login_username_field: username
+    login_password_field: password
+
+    not_logged_in_xpath: //body[@class="not-logged-in"]

docs/ita/developer/testsuite.rst

@@ -0,0 +1,6 @@
+Testsuite
+=========
+Per assicurare la qualità di sviluppo di wallabag, abbiamo scritto i test con `PHPUnit <https://phpunit.de>`_.
+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 <http://ant.apache.org>`_. Poi, eseguite il comando ``make test``.

docs/ita/developer/translate.rst

@@ -0,0 +1,55 @@
+Tradurre wallabag
+=================
+
+wallabag web app
+----------------
+
+File per la traduzione
+~~~~~~~~~~~~~~~~~~~~~~
+
+..  note::
+  
+     Visto che wallabag é principalmente sviluppato da un team francese, si prega di considerare che la traduzione francese é la più aggiornata, e si prega di copiarla e di creare la vostra propria traduzione.
+     
+Potete trovare qui i file per la traduzione:
+https://github.com/wallabag/wallabag/tree/master/src/Wallabag/CoreBundle/Resources/translations.
+
+Dovrete creare ``messages.CODE.yml`` e ``validators.CODE.yml``, dove CODE é il codice ISO 639-1 della vostra lingua (`guardate wikipedia <https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes>`__).
+
+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
+<https://github.com/wallabag/wallabag/blob/master/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.
+