Un semplice Wiki con DokuWiki: differenze tra le versioni

Vai alla navigazione Vai alla ricerca

Un semplice Wiki con DokuWiki (visualizza wikitesto)

Versione delle 18:23, 19 mag 2015

6 554 byte aggiunti ,  19 mag 2015
m
nessun oggetto della modifica
mNessun oggetto della modifica
 
(26 versioni intermedie di 5 utenti non mostrate)
Riga 1: Riga 1:
{{Versioni compatibili|Squeeze|Wheezy}}
==Introduzione==
==Introduzione==
[http://www.dokuwiki.org DokuWiki] è un semplice motore wiki in PHP, utile quando si vuole approntare un sito interno di supporto, ad esempio per la documentazione aziendale, senza però volersi addentrare nella profondità di installazione e configurazione di un wiki complesso come [http://www.mediawiki.org MediaWiki].
[http://www.dokuwiki.org DokuWiki] è un semplice motore wiki in PHP, utile quando si vuole approntare un sito interno di supporto, ad esempio per la documentazione aziendale, senza però volersi addentrare nella profondità di installazione e configurazione di un wiki complesso come [http://www.mediawiki.org MediaWiki]. Ha una sintassi simile a quella di MediaWiki e questo ne facilita ancora più l'utilizzo per chiunque sia già abituato a scrivere su un Wiki.
==Prerequisiti==
Per poter installare DokuWiki è necessario possedere un web server già configurato e completo di supporto PHP. Si veda ad esempio una di queste guide:
* [[Installare un ambiente LAMP: Linux, Apache2, SSL, MySQL, PHP5]]
* [[LAMP: Linux, Apache, MySQL e PHP| Installare un ambiente LAMP: Linux, Apache, SSL, MySQL, PHP4]]
 
==Installazione==
==Installazione==
DokuWiki è presente nei repository Debian a partire da Debian Etch 4.0. Per installarlo, quindi, è sufficiente il comando:
DokuWiki è presente nei repository Debian a partire da Debian Etch 4.0. Per installarlo, quindi, è sufficiente il comando:
Riga 8: Riga 14:
Fatto ciò, DokuWiki risulterà installato, ma non ancora pronto per l'utilizzo.
Fatto ciò, DokuWiki risulterà installato, ma non ancora pronto per l'utilizzo.
==Configurazione==
==Configurazione==
Per permettere l'accesso al wiki da parte di tutti i PC della LAN occorre modificare il file:
* <code>/etc/apache/conf/dokuwiki.conf</code> se usate Apache
* <code>/etc/apache2/conf.d/dokuwiki.conf</code> se usate Apache2
cambiando la voce <code>127.0.0.0</code> in <code>All</code>. Quindi riavviate Apache per fargli digerire le modifiche:
<pre>
# /etc/init.d/apache restart
</pre>
oppure
<pre>
# /etc/init.d/apache2 restart
</pre>
Per una configurazione completa, che offra anche la possibilità di amministrazione e di effettuare registrazioni utenti e login, occorre abilitare le ACL e apportare qualche cambiamento alla configurazione di default di DokuWiki.<br/>
Innanzitutto abilitiamo l'utente di Apache a leggere e scrivere i file di configurazione di DokuWiki:
<pre>
# chown -R www-data /etc/dokuwiki/
# chown -R www-data /usr/share/dokuwiki/lib/
</pre>
Poi copiamo i template per le abilitazioni degli utenti dove DokuWiki si aspetta di trovarli:
<pre>
# cp /etc/dokuwiki/acl.auth.php.dist /var/lib/dokuwiki/acl/acl.auth.php
# cp /etc/dokuwiki/users.auth.php.dist /var/lib/dokuwiki/acl/users.auth.php
</pre>
Infine copiamo il template per la configurazione locale:
<pre>
# cp /etc/dokuwiki/local.php.dist /etc/dokuwiki/local.php
</pre>
A causa di un bug nell'installer del pacchetto Debian di DokuWiki ([http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=515675 Bug 515675]) è necessario operare ancora qualche modifica alla configurazione di DokuWiki, altrimenti non sarà possibile effettuare il login come Amministratori del Wiki.<br/>
Apriamo innanzitutto il file <code>/etc/dokuwiki/local.php</code> e modifichiamo come segue le linee che riguardano l'uso delle ACL e la definizione dell'Amministratore:
<pre>
$conf['useacl']      = true ;
$conf['superuser']  = '@admin' ;
</pre>
Queste modifiche abilitano l'uso delle ACL all'interno del wiki, rendendo visibile il pulsante di Login nell'interfaccia web, e attribuiscono i poteri di superuser agli utenti membri del gruppo <code>admin</code>.<br/>
A questo punto dobbiamo ancora creare un utente, definito da <code>userID/password</code> e assegnarlo al gruppo <code>admin</code>. Per prima cosa generiamo una password crittata:
<pre>
# grub-md5-crypt
Password:
Retype password:
$1$kT.Wv$1njeMRdelUYwBWEpPJdC3.
</pre>
Poi modifichiamo il file <code>/etc/dokuwiki/users.auth.php</code> creando un nuovo account utente. Il formato della linea che definisce un utente in DokuWiki è:
<pre>
utente:MD5passwordHash:Nome Reale:email:gruppo1,gruppo2
</pre>
Perciò inseriamo nel file una riga come questa, stando attenti a riportare correttamente l'hash MD5 della password che abbiamo generato nel passaggio precedente:
<pre>
ferdy:$1$kT.Wv$1njeMRdelUYwBWEpPJdC3.:Ferdy:ferdy@esempio.com:admin,user
</pre>
Ora possiamo aprire il nostro browser sulla pagina:
<pre>
http://indirizzo.ip.del.server/dokuwiki
</pre>
e fare login con le credenziali appena configurate. Dopo il login il pulsante <code>Admin</code> ci darà accesso all'area dedicata all'amministrazione del Wiki.
==Sintassi di DokuWiki==
===Creazione di una pagina===
Per creare una nuova pagina è sufficiente entrare nella modalità di modifica di una pagina esistente e creare un link (vedi più avanti) ad una pagina inesistente. Cliccando poi sul link la nuova pagina verrà automaticamente creata.
===Testo===
Di seguito sono riportati i principali stili applicabili al testo del wiki:
* Bold
<pre>
**bold**
</pre>
* Italic
<pre>
//italic//
</pre>
* Sottolineato:
<pre>
__sottolineato__
</pre>
* Monospaced:
<pre>
''monospaced''
</pre>
* Pedici:
<pre>
<sub>pedice</sub>
</pre>
* Apici:
<pre>
<sup>apice</sup>
</pre>
* Testo cancellato:
<pre>
<del>testo cancellato</del>
</pre>
===Paragrafi===
I paragrafi vengono generati automaticamente ad ogni riga lasciata bianca.<br/>
Per andare a capo senza creare un nuovo paragrafo è sufficiente utilizzare alla fine della linea due backslash <code>\\</code> seguiti da uno spazio bianco. Ad esempio:
<pre>
Questo è del testo\\
in cui si va a capo
</pre>
===Link===
* '''Link esterni'''
I link esterni sono riconosciuti automaticamente, semplicemente digitando l'indirizzo del sito che si vuole linkare:
<pre>
www.google.it
</pre>
È anche possibile utilizzare del testo come un link:
<pre>
[[www.google.it|Questo testo punta a Google]]
</pre>
* '''Link interni'''
I link interni seguono la stessa sintassi dei precedenti. L'importante è linkare una pagina esistente.
<pre>
[[pagina_del_wiki]]
</pre>
oppure
<pre>
[[pagina_del_wiki|Link alla pagina del wiki]]
</pre>
===Condivisioni Windows/Samba===
DokuWiki supporta anche le condivisioni Windows e Samba:
<pre>
[[\\server\condivisione|Nome della condivisione]]
</pre>
===Sezioni===
DokuWiki supporta tre livelli di titoli/sezioni:
<pre>
==== Livello 3 ====
=== Livello 4 ===
== Livello 5 ==
</pre>
danno origine rispettivamente a:
==== Livello 3 ====
=====Livello 4=====
======Livello 5======
È anche possibile aggiungere una linea orizzontale digitando 4 o più trattini <code>-</code> consecutivi.
===Liste e elenchi===
È possibile creare liste puntate utilizzando il simbolo <code>*</code> all'inizio di ogni elemento della lista.<br/>
È possibile creare elenchi numerati utilizzando il simbolo <code>-</code> all'inizio di ogni elemento della lista.<br/>
È possibile ramificare liste e elenchi includendo gli uni negli altri.
===Tabelle===
Per creare ad esempio una tabella di 4 righe e 3 colonne, in cui la prima riga rappresenta l'intestazione delle celle, si utilizzi la seguente sintassi:
<pre>
^ Heading 1      ^ Heading 2      ^ Heading 3          ^
| Row 1 Col 1    | Row 1 Col 2    | Row 1 Col 3        |
| Row 2 Col 1    | some colspan (note the double pipe) ||
| Row 3 Col 1    | Row 3 Col 2    | Row 3 Col 3        |
</pre>
===Link esterni===
* [http://www.dokuwiki.org Il sito ufficiale di DokuWiki]
* [http://www.dokuwiki.org/syntax La sintassi di dokuWiki]
{{Autori
|Autore = [[Utente:Ferdybassi|Ferdybassi]] 23:58, 23 feb 2010 (CET)
}}
[[Categoria:Web server]]
[[Categoria:CMS]]
HAL 9000
3 581

contributi

Estratto da "https://guide.debianizzati.org/index.php/Speciale:DiffMobile/19560...38645"

Menu di navigazione