Istruzioni per l'uso del sito

(gentile concessione del dr. Andrea Baldassarri)

Introduzione generale

Questo sito e' costruito con una sistema (twiki) pensato per favorire la collaborazione tra utenti. Tutti gli utenti registrati possono modificare le pagine esistenti o crearne di nuove. Non c'e' bisogno di conoscere l'html. I link tra le pagine vengono creati automaticamente e la navigazione e' favorita da tutta una serie di strumenti gia' pronti (ricerca, backreferences etc etc).

L'unico concetto veramente chiave del sistema e' quello della WikiWord. Una WikiWord non e' nient'altro che una parola composta da almeno due parole con l'iniziale maiuscola, attaccate. AdEsempioQuesta e' una WikiWord, e anche QuestA, mentre Questa o questA no. Queste parole non sono trattate come le altre, ma il sistema le interpreta come riferimenti ad altre pagine (o Topic).

Quindi ogni volta che in una pagina scriverete una WikiWord, il sistema linkera' automaticamente la parola alla pagina. Nel caso la pagina non esista ancora, comparira' accanto alla parola un punto interrogativo. Cliccando su esso si procede automaticamente alla creazione della nuova pagina.

Insomma e' piu' facile a farsi che a dirsi.

Come registrarsi

Per poter contribuire alla creazione del sito e' neccessario registrarsi (una volta terminata la fase iniziale di creazione del sito la registrazione di nuovi utenti si potra' bloccare). Registrarsi e' facile: basta cliccare sul link Register presente anche nella pagina iniziale. Il nome dell'utente dovra' essere sotto forma di WikiWord (vedi sopra): ad esempio mettendo NomeCognome (tutto attacato). Sceglietevi una password che possiate ricordare facilmente e il gioco e' fatto.

Come modificare una pagina

Ogni volta che vorrete modificare una pagina, bastera' cliccare sul link Edit che vedete in calce o in testa ad ogni pagina. Si aprira' una finestra di editing dovete potrete scrivere quello che volete. In basso alla pagina di editing ci sono un po' di brevi istruzioni su come abbellire la vostra prosa e alcuni bottoni. I piu' importanti sono:

• Preview che vi mostrera' come apparira' quello che avete scritto
• Save per salvare le modifiche e mettere online la pagina modificata
• Cancel per annullare le modifiche che stavate apportando.

Tenete conto che vengono mantenute tutte le versioni precedenti e l'amministratore (AndreaBaldassarri) puo' sempre annullare manomissioni o modifiche errate.

Come creare una nuova pagina

Per creare una nuova pagina potete scriverne il nome (WikiName) in una pagina esistente (pagina "parent") e poi cliccare sul piccolo punto interrogativo che comparira' a fianco del WikiName una volta salvata la pagina esistente. Fatto cio' si passa all'editing, come per la modifica spiegata sopra.

Elementi di stile

Per abbellire le pagine che scrivete, ma soprattutto per renderla piu' leggibile, potete usare i comandi html, per chi li conosce, oppure utilizzare i semplici comandi di formattazione forniti dal twiki (scelta consigliata). I principali li trovate qui TextFormattingRules e quelli piu' comuni sono riassunti in calce alla pagina di editing.

Inserire formule

Una caratteristica importante che ho installato sul twiki pil e' la possibilita' di inserire formule latex. La sintassi e' %$formula latex$%. Ad esempio %$ f(x)=\frac 2\pi \frac 1{\left(1+x^2\right)^2} $% da come risultato la nota distribuzione:

Attaccare documenti

Oltre al testo, la pagina puo' contenere dei documenti di vario tipo: articoli, programmi, immagini... il prinicipio e' lo stesso usato per gli Attachment delle mail. Basta cliccare l'apposito link Attach presente in testa o in calce e dare le informazioni necessarie all'operazione:

• Nome del file che puo' essere cercato nelle cartelle del computer dal quale state navigando il sito grazie alla funzione Browse...
• Commento, cioe' una breve ma esaustiva descrizione del documento

e procedere spingendo sul bottone Upload file (o cancellare l'operazione con Cancel).

Per default il documento attached sara' mostrato in una lista apposita in fondo alla pagina. Opzionalmente e' possibile nascondere l'attachment, ovvero non mostrarlo nella lista (scelta sconsigliata). Per fare cio', cliccare sulla casella Hide file al momento dell'operazione di Attach.

Piu' utile invece e' inserire automaticamente un link al documento nel testo della pagina. Per fare questo bisogna cliccare nella casella Link al momento dell'Attach. Questo e' particolarmente utile per inserire immagini nella pagina.

Inserire immagini

Per inserire immagini nella pagina bisogna "attaccare" il file dell'immagine alla pagina (vedi sopra) e ricordarsi di cliccare sulla casella Link prima di eseguire l'upload. Questo fara' comparire nel testo della pagina il link all'attachment informato html. A questo punto, editando la pagina si puo' spostare il link nel luogo desiderato, eventualmente modificandolo un po' a seconda dei gusti (cambiare la dimensione, eliminare il titolo, etc etc).

Per spiegare meglio, ho attaccato una foto a questa pagina, cliccando sulla casella Link al momento dell'operazione di attach. Ecco come comparira' il link nella pagina:

   * Logo: <br />
    <img src="%ATTACHURLPATH%/foto.jpg" alt="logo"  width="400" height="266"  />

il cui risulato e':

• Logo:
  

Queste righe possono essere spostate (cut-and-paste) dovunque nel testo della pagina e modificate a piacimento. Ad esempio, cambiando i valori dei campi width e height si possono modificare le dimensioni (per mantenere l'aspetto normale cancellate una delle due voci width o heoght). Ad esempio scrivendo questo:

    <img src="%ATTACHURLPATH%/foto.jpg" alt="logo"  width="100" />

si otterra':

Questo e' tutto. Buon divertimento!