Cos'è un wiki?

Un wiki, chiamato anche WikiWiki o WikiWikiWeb, è un insieme di siti web, che non solo possono essere letti, ma anche modificati in modo molto semplice dagli utenti. wikiwiki è una parola hawaiana e significa "veloce".

Il primo WikiWikiWeb fo sviluppato da Ward Cunningham nel 1995. L'idea di contenuti modificabili all'interno del World Wide Web risale all'idea originale dell'inventore del World Wide Web, Tim Berners-Lee.

La via del wiki

• aperto e collaborativo: su molti siti, tutti possono modificare tutto.
• semplice, veloce e flessibile: è possibile inserire e modificare qualsiasi contenuto e sarà disponibile subito. Il contenuto è più importante del design.

• sicuro: MoinMoin ricorda tutte le vecchie versioni delle pagine.

• collegamenti incrociati: le informazioni nel wiki sono altamente collegate.
• accessibile: sono necessari un browser e una connessione a internet per accedere al wiki.
• flessibile: è possibile salvare molti tipi diversi di informazioni, come corsi di apprendimento, letture e molto altro.

Cos'è MoinMoin?

MoinMoin è un software che esegue un wiki.

È disponibile con licenza GPL ed è scritto in Python. Qualsiasi aiuto può essere apportato usando la GPL e Python.

Trovare informazioni

MoinMoin dispone di diversi modi per trovare informazioni all'interno del wiki:

Ricerca

• Il campo ricerca nell'area di navigazione in cima alla pagina

  • Per una ricerca per titolo, inserire del testo nella cesella di ricerca e premere Invio (o fare clic su Titoli).

  • Per una ricerca sul testo, digitare nella casella di testo e fare clic su Testo.

• Voce di menù CercaPagina

  • Comprende gli indici di tutte le pagine ordinate per nome di pagina e le parole nel nome della pagina.
  • Funzioni di ricerca avanzate.

La ricerca per titolo può essere usata anche per navigare le pagine che non si conoscono affatto.

Per maggiori informazioni consultare AiutoSuRicerche.

Esplorazione del wiki

• ModificheRecenti: le ultime modifiche fatte nel wiki.

• NavigaIlSito: il punto di partenza per l'esplorazione del wiki.

• CastelliDiSabbia: il posto dove fare tutti gli esperimenti che si vuole.

• CercaPagina: altri metodi per esplorare il wiki.

• IndiceDeiTitoli: un elenco alfabetico di tutti i nomi delle pagine.

Essere sempre aggiornati

In un wiki molte cose possono cambiare in pochissimo tempo dato che tutti possono modificare, aggiungere o rimuovere pagine.

Per questo motivo è possibile seguire tutti questi cambiamenti dalla pagina ModificheRecenti.

Per ogni modifica vengono riportati:

• un collegamento alla pagina per vedere le differenze
• un collegamento alla pagina modificata e anche alle informazioni per quella pagina
• quando la modifica è stata fatta
• chi ha fatto la modifica
• il commento alla modifica (se presente)

Se è stato eseguito l'accesso al wiki, è possibile impostare un segnalibro temporaneo usando quella pagina. In quel caso, il wiki ricorderà le modifiche già viste e mostrerà solo quelle nuove.

Creare un account wiki

Molte vole è possibile usare un wiki senza dover creare un account (dipende dalle misure di sicurezza utilizzate).

Usare comunque un wiki con un account è facile ed è anche consigliato, in quanto è possibile:

• impostare un segnalibro temporaneo per ModificheRecenti

• personalizzare l'esplorazione
• impostare il proprio fuso orario
• abbonarsi alle pagine e ricevere notifica quando vengono fatte delle modifiche
• molto molto altro.

Per creare un account, basta usare il collegamento Accedi nell'area di navigazione, quindi è necessario inserire:

• un nome (è buona norma usare la forma `NomeCognome`)

• una password (non troppo semplice!)
• la password un'altra volta (per evitare errori di digitazione)
• un indirizzo email (per le notifiche nel caso ci si dimentichi la password)

Quindi fare clic su Create Profile.

L'account verrà creato e sarà possibile accedere la wiki usando il proprio nome utente e la propria password.

L'accesso è stato effettuato se è visibile il proprio nome utente nell'area di navigazione.

Preferenze utente

Dopo aver creato un account ed effettuato l'accesso, è possibile modificare le proprie impostazioni facendo clic sul collegamento Settings in alto nella pagina.

I valori predefiniti dovrebbero essere validi per tutti, ma potrebbe essere utile modificare:

• il fuso orario (per convertire l'orario UTC con quello della propria zona)
• la dimensione dell'area di modifica (dipende dalla risoluzione dello schermo e dalla dimensione del carattere)
• la lingua preferita (non è necessario con un browser web ben configurato)

Quindi fare clic su Save in fondo alla pagina.

La propria pagina personale

Dopo aver creato un account è possibile vedere il proprio nome nell'area di navigazione, che porta a una pagina con quel titolo: la propria pagina personale!

Facendo clic su questo collegamento, è possibile vedere une delle tante caratteristiche peculiari di un wiki: invece di ricevere un errore del tipo 404 not found quando viene richiesta una pagina inesistente, il wiki aiuta a creare la pagina stessa.

Seguendo le istruzioni visualizzate, il wiki mostrerà un modello di base con cui creare la propria pagina personale.

È possibile modificare questo modello, aggiungere altre informazioni e quindi salvare la pagina facendo clic su Save Changes.

L'editor del wiki

Lo abbiamo visto durante la creazione della pagina personale: l'editor testuale di MoinMoin. Non è solo limitato a quello, è possibile modificare qualsiasi altra pagina nel wiki.

Basta semplicemente fare clic su Edit nell'area di navigazione e MoinMoin presenterà l'editor di testo per quella pagina.

La versione precedente della pagina viene sempre salvata e può essere ripristinata in caso di necessità.

È molto importante usare spesso la funzione Preview mentre si modifica una pagina, dato che, facendo questo, viene creata una copia di sicurezza del lavoro attuale.

Una volta completate le modifiche è utile inserire un commento appropriato (che apparirà in ModificheRecenti e nella cronologia della pagina) e fare clic su Save Changes

Nel caso in cui ci siano due persone che modificano una pagina allo stesso tempo, la prima persona può salvare senza alcun problema. La seconda persona riceverà un avviso e dovrà unire le modifiche fatte anche dall'altra. Se si vuole modificare una pagina da soli è utile indicarlo in cima alla pagina.

Mai tornare indietro alla finestra dell'editor col pulsante indietro del browser dopo una modifica, potrebbe causare conflitti con le versioni salvate. Usare il pulsante per la modifica.

Se non si vuole salvare la pagina, ma si vogliono annullare le modifiche, è necessario usare il pulsante Cancel, indicando così a MoinMoin che la pagina non è più in modifica.

Maggiori informazioni possono essere trovate in AiutoSuModificaPagina.

Scorciatoie

Le normali scorciatoie funzionano anche nell'editor:

• Maiusc + freccia per selezionare

• Ctrl + C per copiare

• Ctrl + X per tagliare

• Ctrl + V per incollare

• Ctrl + Z per annullare

• Ctrl + Y per ripetere

Mouse

È anche possibile selezionare col mouse e usare le funzionalità di modifica del browser.

Linux / X11: un doppio clic col pulsante sinistro seleziona e copia una parola e un clic col pulsante centrale funziona da incolla.

Formattazione del testo

MoinMoin non utilizza HTML (HyperText Markup Language usato comunemente per i siti web), ma utilizza una forma tutta sua, MoinMoin Wiki Markup Language.

HTML

<h1>Titolo</h1>
<p>Questo è un collegamento alla mia pagina personale: <a href="/NomeCognome">NomeCognome</a></p>
<p>Un elenco:
<ul>
 <li>foo</li>
 <li>bar</li>
</ul>
</p>

MoinMoin wiki

= Titolo =
Questo è un collegamento alla mia pagina personale: NomeCognome

Un elenco:
 * foo
 * bar

La sintassi di MoinMoin verrà spiegata in dettaglio nelle pagine successive.

Paragrafi

Il metodo più facile per inserire del testo in un wiki è simile a quanto si fa con un elaboratore di testi.

Basta scrivere.

L'unica differenza è che è necessario premere Invio due volte per creare un paragrafo:

Testo da inserire nell'editor

Primo paragrafo.
Ancora il primo paragrafo.

Secondo paragrafo.

Terzo paragrafo.

Come viene visualizzato

Primo paragrafo. Ancora il primo paragrafo.

Secondo paragrafo.

Terzo paragrafo.

Righe per dividere

Input

Prima parte.
----
Seconda parte.

Come viene reso

Prima parte.

Seconda parte.

Titoli

Input

= Titolo di primo livello con il carattere "=" =
== Secondo ==
=== Terzo ===
==== Quarto ====
... (fino al sesto)

Come viene visualizzato

Titolo di primo livello con il carattere "="

Secondo

Terzo

Quarto

... (fino al sesto)

Se un titolo non viene visualizzato correttamente solitamente dipende:

• dalla presenza di un carattere di spazio invisibile dopo l'ultimo "="
• dal numero di caratteri "=" all'inizio o alla fine che non corrispondono

Elenchi

Elenco puntato

Input

I miei animali:
 * Cane
 * Gatto
  * Topo

Come viene visualizzato

I miei animali:

• Cane
• Gatto
  • Topo

Elenco numerato

Input

Cose da fare:
 1. Dar da mangiare al cane
 1. Dar da mangiare al gatto
  1. Liberare il topo

Come viene visualizzato

Cose da fare:

1. Dar da mangiare al cane
2. Dar da mangiare al gatto
   1. Liberare il topo

MoinMoin può contare da solo!

Il numero di spazi iniziali determina il livello gerarchico dell'elenco.

Per ulteriori informazioni consultare AiutoSuListe.

Stile del testo

Ulteriori informazioni presso AiutoSuModificaPagina.

Tabelle

Semplice tabella

 || uno || due || tre ||
 || quattro || cinque || sei ||

• uno	due	tre
  quattro	cinque	sei

Stile generale

 ||||||<tablewidth="80%">'''Titolo'''||
 ||Cella 1||Cella 2||Cella 3||
 ||<rowspan=2> Due righe||||<bgcolor="#AAAAFF"> Due colonne||
 ||<rowbgcolor="#FFFFAA">Cella 2||Cella 3||

• Titolo
  Cella 1	Cella 2	Cella 3
  Due righe	Due colonne
  	Cella 2	Cella 3

Larghezza cella

 || Corta ||<:99%> Lunga ||

• Corta

  Lunga

Più righe e colonne

 ||<|2> 2 righe || riga 1 ||
 || riga 2 ||
 ||<-2> riga 3, 2 colonne ||

• 2 righe	riga 1
  	riga 2
  riga 3, 2 colonne

Allineamento

 ||<(50%> sinistra ||<^|3> alto ||<v|3> basso ||
 ||<:> centro ||
 ||<)> destra ||

• sinistra	alto	basso
  centro
  destra

Colori

 ||<#FF0000> rosso ||<#00FF00> verde ||<#0000FF> blu ||

• rosso

  verde

  blu

Collegamenti interni

Una delle più importanti caratteristiche del wiki è la possibilità di creare collegamenti interni verso altre pagine wiki.

NomiWiki ("CamelCase")

Se vengono ScritteParoleAssieme come NomeCognome o CamelCase o MoinMoin in modo tale che ci siano due lettere maiuscole, MoinMoin creerà automaticamente un collegamento a una pagina con lo stesso nome.

Tutto questo è molto semplice dato che non è necessaria alcuna formattazione wiki, ma la sintassi diversa non è facile per tutti e per questo è presente un'alternativa chiamata "collegamento libero".

Input

CamelCaseIt !CamelCaseMaSenzaCollegamento

Come viene visualizzato

CamelCaseIt CamelCaseMaSenzaCollegamento

Collegamenti liberi

Per collegare pagine che non sono in CamelCase o se non si vuole usare la sintassi CamelCase, è possibile creare collegamenti come segue:

Input

Un [[collegamento libero]] e un'[[altra pagina|altra pagina]].

Come viene visualizzato

Un collegamento libero e un'altra pagina.

Ricerca dei collegamenti

Facendo clic sul nome della pagina nell'area di navigazione, il wiki cercherà le pagine che portano a quella pagina.

Questo può essere usato per i cosiddetti "badge". Basta scrivere:

DaFare: chiamare il cliente...

DaFare è in CamelCase e porta quindi alla pagina omonima.

Ma è possibile fare clic sul nome della pagina DaFare e trovare tutte le pagina che comprendono DaFare.

Collegamenti esterni

È possibile, ovviamente, collegare anche contenuti esterni al wiki e presenti su Internet.

Input

http://example.net/

[[http://moinmoin.in/|MoinMoin Wiki]]

ftp://example.org/pub/

{{http://static.moinmo.in/logos/moinmoin.png}}

Come viene visualizzato

http://example.net/

MoinMoin Wiki

ftp://example.org/pub/

Come si può notare, `...` imposta un collegamento all'obiettivo, `` include l'obiettivo, molto utile per le immagini.

Allegati

Con MoinMoin è possibile allegare file a una pagina wiki.

Input

[[attachment:lettera.txt]]

{{attachment:foto.jpg}}

Come viene visualizzato

lettera.txt

Fin tanto che i file non sono caricati nella pagina:

• i collegamenti sono solitamente grigi (dello stesso colore delle pagine wiki non esistenti)
• un'immagine alternativa, come una graffetta, è visualizzata per le immagini allegate non esistenti

È possibile fare clic su di essa per caricare un file dal proprio computer attraverso il browser web. Una volta fatto questo:

• i collegamenti sono blu (dipende dal colore del tema)
• l'immagine appare

Simboli

MoinMoin supporta anche alcuni simboli grafici come i cosiddetti smiley (faccine) come quelli che compaiono nelle chat o nelle email:

Per maggiori informazioni consultare AiutoSuFaccine.

I quattro capitoli che seguono contengono informazioni avanzate. Se non sono di interesse è possibile saltarli.

Contenuto dinamico

MoinMoin è creato secondo moduli, cosicché le funzionalità sono estendibili utilizzando dei plug-in. Macro, processori, azioni, etcetera possono essere create e incluse o installate come un plug-in.

Macro

Una macro è usata come formattazione wiki ed elabora alcuni parametri per generare un output che viene visualizzato nella pagina.

Processori

Un processore è usato come formattazione wiki ed elabora alcuni parametri e un blocco di testo multi-riga per generare un output che viene visualizzato nella pagina.

Azioni

Un'azione è solitamente chiamata utilizzando il menù (o una macro) e genera un pagina HTML da sola.

Macro

Una macro viene utilizzata usando la sintassi `<<NOME_MACRO(parametri)>>`. I parametri variano da macro a macro e possono anche non essere usati.

Input

<<TableOfContents>>
----
Del testo con una nota a piè pagina.<<FootNote(Questa è la nota a piè pagina.)>>

|| <<MonthCalendar>> || <<MonthCalendar(,2008,1)>> ||
----
Un certo momento nel mondo: <<DateTime(2008-01-26T23:03:25Z)>>

Come viene visualizzato

Del testo con una nota a piè pagina.¹

Un certo momento nel mondo: 2008-01-26 23:03:25

Processori di codice

Input

 {{{#!python
 def hello(name):
     print "Ciao %s" % name
 }}}

Come viene visualizzato

•    1  def hello(name):
     2      print "Ciao %s" % name
  

Azioni

Alcuni esempi di azioni disponibili:

• l'azione informazioni nell'area di navigazione
• una parte della funzione di ricerca

• gli allegati (l'azione AttachFile).

• tutto quello che è presente nel menù delle azioni

L'editor grafico

In alternativa all'inserimento della formattazione del wiki usando l'editor testuale, MoinMoin dispone di un editor grafico WYSISYG (Waht You See Is What You Get, ndr. quello che vedi è quello che ottieni), simile a molti elaboratori di testo.

Requisiti tecnici: una versione aggiornata di un browser web Mozilla/Firefox/Netscape o Internet Explorer con JavaScript attivato.

È possibile impostare l'editor preferito nelle proprie preferenze, ma è possibile passare da uno all'altro mentre si fanno le modifiche.

Vantaggi dell'editor grafico:

• più bello
• più semplice

Svantaggi dell'editor grafico:

• più lungo a caricare
• molto meno flessibile
• non è ancora privo di errori

Creare pagine

Il metodo più facile e veloce per creare una pagina consiste nel:

• pensare un buon nome per una pagina

• modificare una pagina appropriata, aggiungere un collegamento alla nuova pagina e salvarla
• fare clic sul collegamento alla nuova pagina
• preparasi alla modifica usando:
  • una pagina vuota
  • un modello di una pagina (un elenco dei modelli disponibili viene visualizzato sulla sinistra)

  • l'elenco delle pagine con nomi simili, consultando che non sia già presente una pagina con un nome simile

• iniziare la modifica e infine salvare la pagina

In questo modo ci si assicura che la nuova pagina sia sempre accessibile da un collegamento in pagina già esistente.

Wiki etiquette

È molto importante nei wiki pubblici, dove molte persone collaborano assieme e che spesso non si conoscono, comportarsi benevolmente con gli altri, fintantoché nessuno si è comportato in malo modo con voi.

Quindi, se qualcuno cancella una frase scritta da voi, potrebbe essere stata sbagliata o non adatta a quella pagina.

Allo stesso modo, è utile dimostrare un comportamento benevolo e non falsificare le opinioni scritte da altre persone. Mai modificare o cancellare qualche cosa se non se ne è sicuri.

La pagina personale dovrebbe essere considerata come "proprietà" dell'utente e non dovrebbe mai essere modificata, a parte il lasciare messaggi all'utente.

Applicazioni

Un wiki è utile per svariate applicazioni dato che non ci sono molti prerequisiti per usarlo e il contenuto può essere qualsiasi. È possibile usarlo per qualsiasi cosa.

Esempi

• note personali (invece di sprecare carta)
• protocolli di conferenze
• cose da fare
• notizie, comunicazioni asincrone
• creazione collaborativa di documentazione
• contenitore di idee
• raccolta di collegamenti
• alternativa efficiente alle email o al telefono
• molto altro

Strutture nel wiki

Livelli gerarchici

Diversi siti web utilizzano una struttura a rami con molti livelli gerarchici

Nei wiki i collegamenti sono molto usati. Una struttura semplice è solitamente usata per semplificare le cose:

• tutti gli argomenti principali sono raccolti nelle pagine principali
• solo se un argomento ha diversi sotto-argomenti vengono usate sotto-pagine

  Le sotto-pagine sono definite come `PaginaPrincipale/SottoPagina`

Convenzioni

Un wiki può dare molta libertà agli utenti, non ci sono maschere di input come nei database, ma è comunque possibile, in principio, fare quello che si vuole e come si vuole.

Ovviamente è utile evitare il caos più totale.

Ecco perché è utile pensare a una struttura e a delle convenzioni, come:

• la creazione di una struttura di base per le pagine
• definizione di una convenzione per i nomi delle pagine

• decidere se usare i CamelCase o i collegamenti liberi

• definire le categorie più importanti

Per i wiki più vecchi, solitamente, viene portata avanti la struttura esistente.