====== Scaricare e installare DokuWiki ======



===== Scaricare  =====

Visitare la pagina https://download.dokuwiki.org/ poi:
  * **non premere** direttamente il pulsante ''Download'' (scaricheremmo la versione con traduzioni in tutte le lingue)
  * premere invece il pulsante ''Toggle all'' nella colonna centrale ''Languages''
  * mettere la spunta sulla casella corrispondente a ''it - Italiano''
  * premere il pulsante "start download" in fondo alla pagina
  * il file con estensione ''.tgz'' contenente DokuWiki viene scaricato sul PC (salvarlo senza cercare di aprirlo)
===== Scompattare Dokuwiki sul PC =====

Il file scaricato è un **file compresso** con estensione ''.tgz'' e contiene la cartella con DokuWiki che deve essere scompattata/estratta su PC. Per aprire questo tipo di file possiamo usare i programmi:
  * WinRar
  * 7-zip
Il secondo è più macchinoso perché prevede due passaggi: una prima estrazione per ottenere un file con lo stesso nome ma estensione ".tar" e una seconda per avere la cartella ''dokuwiki''.

===== Connettersi via FTP al sito con FileZilla =====

L'installazione vera e propria di DokuWiki avviene caricando la cartella scompattata nel nostro spazio web. Per farlo è necessario utilizzare un //client FTP//, cioè un software che serve a trasferire file tra computer con il protocollo FTP. In questo corso useremo il software gratuito [[https://filezilla-project.org/|FileZilla]], già installato nei PC del laboratorio.

I **dati richiesti per la connessione FTP** sono riportati nella mail di conferma attivazione o reperibili dal pannello web di AlterVista. Lanciamo FileZilla e inseriamo i dati  per stabilire la connessione al nostro spazio web  utilizzando i campi di testo posti sotto la barra degli strumenti:
  * Host: ftp.//nomeutente//.altervista.org
  * Nome utente: il proprio //nomeutente//
  * Password: la //password//
  * Porta: 21
A questo punto premendo invio o cliccando sul pulsante ''Connessione rapida'' si stabilisce la connessione. FileZilla chiederà se memorizzare la password (è indifferente) e di accettare un certificato che stabilisce l'identità del sito (accettare e mettere la spunta su "Considera sempre sicuro il certificato nelle sessioni future"). Il pulsante ''Connessione rapida'' memorizza i dati per la connessione al nostro sito e la prossima volta che ci servirà connetterci basterà selezionare il sito dal menu a tendina che compare cliccando la freccia a destra del pulsante.

===== Caricare DokuWiki sul sito =====

Una volta che FIleZilla è connesso al sito è possibile spostare file dal PC al server e viceversa. Per farlo si usano le viste ad albero - simili, ma riferite una al PC l'altra al server - poste sotto la finestra dei messaggi. Per caricare la cartella sul server bisogna:
  * verificare che nella vista a destra sia selezionata la cartella principale del server indicata con ''/''
  * individuare la cartella ''dokuwiki'' scompattata in precedenza nella vista a sinistra (basterà navigare tra le cartelle del PC fino ad individuarla, come faremmo con ''Esplora File'' di Windows)
  * cliccare col tasto destro sulla cartella e selezionare ''Upload''

A questo punto si avvia il trasferimento dei file. Il protocollo FTP prevede il trasferimento di un file alla volta, non dell'intera cartella; questo significa che ci vorrà un po' di tempo (5 minuti circa) per caricare i circa 1000 file di Dokuwiki. Nella parte in basso è possibile seguire come procede il trasferimento controllando il numero di file trasferiti e quelli ancora da trasferire. Durante il trasferimento possono verificarsi errori o disconnessioni; in genere il software è in grado di porvi rimedio riconnettendosi automaticamente al server e trasferendo nuovamente i file. Può capitare che compaia una finestra che chiede se sovrascrivere i file; accettare selezionando ''sovrascrivi''.

Quando il trasferimento sarà completato comparirà un messaggio di conferma. A questo punto possiamo chiudere FileZilla e procedere alla configurazione di DokuWiki direttamente dal browser, visitando il nostro sito. 

Prima di passare alla fase successiva è bene fare qualche ultima considerazione:
  * FileZilla può essere usato anche per **cancellare** o **rinominare** file sul server
  * FileZilla ci permette di copiare file e cartelle **dal server al nostro PC**, ad esempio per fare un **backup** o una copia del sito
  * un metodo più rapido per cancellare una cartella è quello di utilizzare il pannello web di AlterVista invece che  FileZilla