1

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

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

(!) 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

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:

(!) 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:

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

/!\ Quindi fare clic su Sukurti profilį. /!\

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 Nuostatos in alto nella pagina.

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

Quindi fare clic su Išsaugoti 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 Išsaugoti pakeitimus.

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 Redaguoti 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 Peržiūrėti 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 Išsaugoti pakeitimus

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 Atšaukti, 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:

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:

Elenchi

Elenco puntato

Input

I miei animali:
 * Cane
 * Gatto
  * Topo

Come viene visualizzato

I miei animali:

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

Sintassi del wiki

Come viene visualizzato

''corsivo''

corsivo

'''grassetto'''

grassetto

'''''grassetto corsivo'''''

grassetto corsivo

__sottolineato__

sottolineato

--(barrato)--

barrato

`spaziatura fissa`

spaziatura fissa

(!) Ulteriori informazioni presso AiutoSuModificaPagina.

Tabelle

Semplice tabella

 || 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||

Larghezza cella

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

Più righe e colonne

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

Allineamento

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

Colori

 ||<#FF0000> rosso ||<#00FF00> verde ||<#0000FF> 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/

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

(!) 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

[PRIDĖTI]

(!) Fin tanto che i file non sono caricati nella pagina:

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

Simboli

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

{1} {2} {3}

{1} {2} {3}

/!\ (!) (./) {X} {i} {OK}

/!\ (!) (./) {X} {i} {OK}

{*} {o}

{*} {o}

:) B-) :( X-(

:) B-) :( X-(

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.1

<< <  2024 / 12 >  >>
Pr An Tr Kt Pn Št Sk
            1
2 3 4 5 6 7 8
9 10 11 12 13 14 15
16 17 18 19 20 21 22
23 24 25 26 27 28 29
30 31          

<< <  2008 / 1 >  >>
Pr An Tr Kt Pn Št Sk
  1 2 3 4 5 6
7 8 9 10 11 12 13
14 15 16 17 18 19 20
21 22 23 24 25 26 27
28 29 30 31      


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

Azioni

Alcuni esempi di azioni disponibili:

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:

Svantaggi dell'editor grafico:

Creare pagine

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

(!) 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

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:

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. B-)

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

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