Indice

Contents

  1. Domande su "Cosa è un Wiki?"
    1. Cosa è un ''Wiki''?
    2. Cosa è un ''MoinMoin''?
    3. A cosa può servire?
    4. Quali sono le principali funzionalità di un Wiki?
    5. Come si confronta con altri strumenti di gruppo, come Notes?
    6. E sulla sicurezza? Non è un Wiki soggetto a cancellazioni complete o vandalismi di un sabotatore?
  2. Domande sul come usare questo Wiki
    1. Scovare e accedere alle informazioni contenute nel Wiki
      1. Come posso fare una ricerca nel Wiki?
      2. Come posso vedere che cosa è stato modificato di recente?
      3. Che cosa sono quei StraniLinkRossi che continuo a trovare un po' dappertutto?
    2. Aggiunta di informazioni al Wiki
      1. Come posso aggiungere qualche cosa al wiki, o correggere un'informazione sbagliata?
      2. Ci sono convenzioni particolari che dovrei seguire quando aggiungo del materiale?
      3. Come posso aggiungere materiale non testuale al Wiki?
      4. Come faccio ad aggiungere un'immagine a una pagina?
      5. Come inserire documenti residenti in una rete locale (intranet)
      6. Dovrei ''firmare'' le mie modifiche?
    3. Aggiungere altri formati al Wiki
      1. Posso inserire codice HTML nel Wiki?
  3. Installazione & Configurazione
    1. Perché la funzione "diff" non funziona?
    2. Come posso attivare l'opzione "DeletePage"?
  4. Amministrazione del Wiki
    1. Cosa devo fare per amministrare il Wiki?
    2. Posso ripristinare una versione precedente di una certa pagina?
    3. Come creo una nuova pagina modello?

Domande su "Cosa è un Wiki?"

Cosa è un ''Wiki''?

Il termine Wiki è un'abbreviazione di WikiWikiWeb. Un Wiki è un insieme di pagine che possono essere modificate in collaborazione con altre persone utilizzando un browser web.

Cosa è un ''MoinMoin''?

Un MoinMoin è un wiki implementato dal programma MoinMoin, scritto in Python.

A cosa può servire?

Ad essere onesto, è utile per qualsiasi scopo vada bene per te. Su Lineo viene usato un wiki nella rete locale con moltissime pagine, che descrivono i vari progetti, le architetture, le idee e così via a disposizione delle persone che vogliono contribuire dei commenti. Alcune pagine sono puramente informative, altre sono un invito alla discussione e al confronto.

In generale, un wiki è uno strumento molto versatile, il cui valore dipende dall'uso che se ne fa. Ad esempio, una pagina in un wiki può servire allo stesso scopo di un verbale di una discussione. Puoi usare una pagina wiki per collaborare con altri ad un progetto.

Svariati Wiki vengono usati internamente dal gruppo di sviluppatori di Zope per tener traccia delle varie idee e dei progetti.

Quali sono le principali funzionalità di un Wiki?

Queste sono alcune delle principali caratteristiche:

Come si confronta con altri strumenti di gruppo, come Notes?

Un Wiki è in grado di svolgere alcuni compiti in maniera semplice, ma ci sono cose che non può fare. La mancanza più sentita è la possibilità di controllare l'accesso al sito, per consentire solo ad un certo gruppo di persone di modificare le informazioni.

E sulla sicurezza? Non è un Wiki soggetto a cancellazioni complete o vandalismi di un sabotatore?

Questa è una domanda importante. In generale, i Wiki NON offrono nessuna sicurezza. (Proprio così!). Pertanto, esiste la possibilità che, sia accidentalmente che volutamente, il wiki venga distrutto o comunque danneggiato in qualche sua parte.

Ci sono due maniere per danneggiare un wiki. Una è la cancellazione, l'altra la manomissione. Il problema della cancellazione non è poi così grave, dal momento che viene mantenuto sia un registro delle modifiche che un archivio delle versioni precedenti di ogni pagina, in un luogo non accessibile agli utenti web. Quando una pagina presenti delle cancellazioni o danneggiamenti, può essere rapidamente ripristinata dall'ultima sua versione precedente in buono stato.

La manomissione esplicita e intenzionale è invece un problema un po' più difficile da trattare. Esiste la possibilità che qualcuno possa inserire delle informazioni scorrette su una pagina, o che intenzionalmente manometta le informazioni su una pagina esistente (ad esempio, una persona può cambiare le attribuzioni di una pagina in modo tale che risulti sia stato qualcun altro a inserire una certa informazione, oppure alterare il contenuto di un paragrafo in modo da travisarne il significato). Gran parte dei sistemi di collaborazione soffrono di questo problema. Nei Wiki, il problema è ancora maggiore data la totale mancanza di sicurezza. Nella realtà però, i casi di vandalismi sui wiki sono estremamente rari, e possono essere facilmente individuati attivando la notifica via email ad ogni nuovo contributo al sito.

In altre parole, la filosofia del wiki è quella di intervenire manualmente nei rari (ed eccezionali) casi di sabotaggio, piuttosto che studiare e inserire le funzionalità e il sovraccarico (sia nell'implementazione che nell'utilizzo) necessari a prevenire il possibile danno causato da un vandalo.

Domande sul come usare questo Wiki

Scovare e accedere alle informazioni contenute nel Wiki

Come posso fare una ricerca nel Wiki?

Ci sono veramente tante maniere di effettuare ricerche:

Come posso vedere che cosa è stato modificato di recente?

Clicca sul link ModificheRecenti presente in cima a tutte le pagine.

Che cosa sono quei StraniLinkRossi che continuo a trovare un po' dappertutto?

Qualsiasi parola formata da un mix di lettere maiuscole e minuscole che non abbia una pagina associata verrà presentato come un collegamento scritto in rosso.

Aggiunta di informazioni al Wiki

Come posso aggiungere qualche cosa al wiki, o correggere un'informazione sbagliata?

Se vedi qualche cosa su cui vorresti dire la tua, o che vorresti aggiungere o modificare, basta che clicchi sul link ModificaIlTesto in fondo alla pagina, oppure sull'icona in alto. Il contenuto della pagina ti verrà presentato in una pagina del tuo browser, dove potrai effettuare le modifiche che desideri. Il formattatore wiki generalmente "farà la cosa giusta" con qualunque testo ti inserisca. Se vuoi fare le cose eleganti, puoi utilizzare gran parte delle tipologie di formattazione offerte dall'HTML. Vedi la pagina AiutoSuFormattazione per suggerimenti e esempi.

Ci sono convenzioni particolari che dovrei seguire quando aggiungo del materiale?

Veramente non molte. Aiuta molto mantenere una certa consistenza nella formattazione di certe informazioni. Una importante convenzione che aiuta in questo è l'utilizzo delle pagine "Modello".

Il Wiki ha una funzionalità chiamata "Modelli" che ti viene proposta quando crei una nuova pagina. Se tu clicchi su uno dei modelli proposti alla creazione della pagina, allora quella pagina avrà una struttura simile alle altre dello stesso tipo. Ad esempio, quando crei la tua homepage Wiki, dovresti utilizzare la PaginaPersonaleModello.

Come posso aggiungere materiale non testuale al Wiki?

Se quanto vuoi aggiungere è già disponibile su un sito web, aggiungi semplicemente un link appropriato alla pagina wiki. Segui queste indicazioni

Il wiki trasformerà in un link ipertestuale il testo che hai inserito.

Puoi abbellire il link inserendo delle parole descrittive dentro le parentesi quadre. Queste parole saranno visualizzate nel link stesso, che sarà comunque associato all'URL prescelto. Ecco un esempio: 

  [http://il.tuo.link/acaso.html Questo sarà il testo del link]

produce:

Questo sarà il testo del link

Come faccio ad aggiungere un'immagine a una pagina?

Puoi includere l'URL dell'immagine nella pagina. Esempio: 

http://c2.com/sig/inter/wikibase.gif

produce

http://c2.com/sig/inter/wikibase.gif

Come inserire documenti residenti in una rete locale (intranet)

Se stai usando MoinMoin in una intranet, può essere utilile inserire dei link a documenti condivisi disponibili a chiunque acceda al tuo wiki. Ad esempio: 

[file://nomeserver/path/completo/al/file/nomefile.txt Clicca qui per leggere nomefile.txt]

Puoi anche collegare dei file il cui nome contiene degli spazi, inserendo manualmente nell'URL il codice dello spazio secondo le specifiche HTML (%20): 

[file://nomeserver/path/completo/al/file/nomefile%20con%20spazi.txt Clicca qui per leggere nomefile con spazi.txt]

Altra opzione, forse ancora più interessante da utilizzare, è l'azione AttachFile, presente dalla versione 0.11 di MoinMoin.

Dovrei ''firmare'' le mie modifiche?

Se sono significative, o se desideri che gli altri sappiano che le hai aggiunte tu, allora si. Metti semplicemente il tuo nome o l'indirizzo email dopo il tuo commento. E' pratica comune far rientrare il tuo contributo in modo tale che sia chiaro a quale paragrafo ti stai riferendo. Inoltre, aiuta rendere in italico la tua affermazione, in modo tale che risalti di più nella pagina.

In altri casi però è più appropriato lasciare anonima la tua modifica. La correzione di errori di sintassi, di formattazione o comunque alterazioni banali sono esempi per i quali non è necessario (e addirittura scoraggiato) firmare la propria modifica.

Aggiungere altri formati al Wiki

Posso inserire codice HTML nel Wiki?

Se vuoi aggiungere una singola riga di HTML, usa la macro HTML. Per farlo, passa l'istruzione HTML come parametro della macro HTML, tipo:

`<<HTML(<font size=+12>Carattere più grande</font>)>>`

This would show up on the page as: `<<HTML(<font size=+12>Carattere più grande</font>)>>`

E' anche possibile inserire un documento HTML in una pagina aggiungendo #format html come prima riga della pagina. Se quella riga è presente allora l'intera pagina verrà interpretata come HTML (rendendo perciò un tantino più difficile inserire dei link alle altre pagine!). Assicurati di inserire solo la porzione BODY della pagina (senza alcun header HTML o qualsiasi altra cosa fuori dal BODY, inclusa la tag <BODY> stessa).

Installazione & Configurazione

Perché la funzione "diff" non funziona?

La funzione "diff" necessita di due cose per poter funzionare correttamente:

Come posso attivare l'opzione "DeletePage"?

"DeletePage" non è attivata di default, dal momento che viene usata prevalentemente in ambienti intranet, ed è un pochino pericolosa su un wiki pubblico. Per consentire questa e altre azioni considerate pericolose, aggiungi qualcosa di simile al tuo wikiconfig.py: 

allowed_actions=['DeletePage']

Amministrazione del Wiki

Cosa devo fare per amministrare il Wiki?

C'è un sacco di informazioni amministrative nella pagina ModificheRecenti, incluso il numero di pagine, di macro e di azioni installate.

Io di solito creo una pagina "AdminPage" dove metto delle macro a questo scopo, così come informazioni relative alla posizione fisica effettiva delle pagine, le macro per scovare le PagineOrfane e altre cose utili all'amministratore del wiki.

Posso ripristinare una versione precedente di una certa pagina?

Non direttamente. E' facile farlo (se hai i permessi di scrittura sulla directory dove sono tenute fisicamente le pagine wiki). Di solito però dovrai richiedere all'amministratore di ripristinare la pagina per te. Questo allo scopo di prevenire l'improbabile caso di qualcuno che tenti di sabotare il wiki.

Per chi sta leggendo questa pagina (che non è probabilmente il tuo sabotatore), ecco un modo per ripristinare una pagina:

  1. clicca sulla piccola "i" nell'angolo superiore destro (PageInfo).

  2. clicca si "mostra" della versione che vuoi ripristinare.
  3. sostituisci, nell'indirizzo mostrato dal browser, il testo "action=recall" con "action=raw".

  4. Copia il testo che ti viene mostrato e incollalo nella pagina desiderata dopo aver cliccato su "ModificaIlTesto".

Come creo una nuova pagina modello?

I modelli sono pagine che ti vengono proposte automaticamente quando crei un nuova pagina. Qualunque pagina il cui nome termini con la parola Modello verrà automaticamente aggiunta alla lista. Così, se vuoi avere una certa uniformità in un certo tipo di pagine (intestazioni, organizzazione, ecc.), crea semplicemente una pagina con il nome che termina con Modello: quando creerai pagine di questo tipo, seleziona il modello desiderato: il wiki inserirà il contenuto iniziale della pagina, che potrai quindi completare a piacere. Le pagine Modello sono a tutti gli effetti pagine wiki, modificabili nella solita maniera.

Per creare una pagina Modello, crea una nuova pagina chiamata <qualchecosa>Modello.