3 581
contributi
mNessun oggetto della modifica |
|||
(24 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]. 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. | [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== | ||
Riga 12: | Riga 17: | ||
* <code>/etc/apache/conf/dokuwiki.conf</code> se usate Apache | * <code>/etc/apache/conf/dokuwiki.conf</code> se usate Apache | ||
* <code>/etc/apache2/conf.d/dokuwiki.conf</code> se usate Apache2 | * <code>/etc/apache2/conf.d/dokuwiki.conf</code> se usate Apache2 | ||
cambiando la voce <code>127.0.0.0 | cambiando la voce <code>127.0.0.0</code> in <code>All</code>. Quindi riavviate Apache per fargli digerire le modifiche: | ||
<pre> | <pre> | ||
# /etc/init.d/apache restart | # /etc/init.d/apache restart | ||
Riga 35: | Riga 40: | ||
# cp /etc/dokuwiki/local.php.dist /etc/dokuwiki/local.php | # cp /etc/dokuwiki/local.php.dist /etc/dokuwiki/local.php | ||
</pre> | </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]] |
contributi