Indice

Copiaincollate la sorgente di questa pagina entro la vostra pagina vuota. Vi introdurrà alla sintassi dokuwiki. Dopo aver familiarizzato con il programma, potete eliminare questi appunti e utilizzare lo schema di lezione in fondo.

Ricordatevi di compilare anche la lista degli argomenti trattati alla terza colonna dell'indice generale!

INTRO A DOKUWIKI (TOGLIMI!)

Sintassi di base

La sintassi dokuwiki arricchisce il testo con simboli di formattazione, tipo Grassetto , Corsivo , Sottolineato , Codice ,Barrato .

Un capoverso è preceduto da una riga vuota. In assenza di una riga vuota il testo continua di seguito.

Un punto di elenco numerato si inizializza con una indentazione di due spazi e un -,

  1. blabla;
  2. blabla;
    1. blablabla;
    2. blablabla;
  3. blabla.

Con due spazi e un * si inizializza un elenco puntato

È possibile inserire note a piè di pagina1) utilizzando la sintassi (( nota )).

Ulteriori note sono riportate qui e qui.

Formule

Una formula può essere inserita utilizzando la sintassi latex; nel caso non vi sia familiare potete comporre l'equazione online su Codehogs editor, Interactive LaTeX Editor oppure Lattice Equation Editor e copiaincollare il risultato tra due $$, es.

$$ a x^2 + b x + c = 0 $$

oppure tra due $ se si vuole una formula tipo $ x^2 $ in linea con il testo. Più dettagli al link interno formule.

Immagini e file

Una immagine o un file può essere allegato alla pagina cliccando sull'icona a forma di quadretto, selezionando un file, procedendo con l'upload, e cliccando sul nome del file a fine upload per inserirlo nel testo.

Figure 1: Esempio di figura

Si consiglia di utilizzare nomi file che riducano le possibilità di omonimie, es. inserendo un prefisso legato alla specifica lezione tipo PTlez001_screenshot1.png. In passato un gruppo ha sovrascritto i file screenshot1.png, screenshot2.png, utilizzati in lezioni altrui. Evitatelo.

La sintassi

  <figure etichetta>
  
  
  <caption> didascalia </caption>
  </figure>

definisce una didascalia e una etichetta per la figura, utile quest'ultima per riferimenti entro il testo (vedere la lista dei simboli a fondo pagina). Non è obbligatorio utilizzare didascalie e etichette.

È possibile disegnare le figure a mano e caricare sul wiki la scansione delle stesse. Controindicazione principale è che sono difficilmente modificabili.

Io (Enrico Bertocchi) personalmente utilizzo IPE per produrre la grafica vettoriale; è un programma non immediatamente comodo. Possibili alternative sono Libreoffice Draw, Inkscape o SVG edit.

Ripeto, potete disegnare le figure a mano e caricare sul wiki la scansione delle stesse.

Per gli screenshot consiglierei formati png, gif o jpeg; eviterei i bmp per motivi di dimensione (non sono compressi) e gli stessi jpeg in quanto l'algoritmo di compressione è ottimizzato per le fotografie.

Per agevolare la stampa del wiki è possibile portare MSC.Mentat a fondo bianco prima di acquisire gli screenshot, in particolare utilizzando

UTILS -> POSTSCRIPT.SETTINGS ->PREDEFINED COLORMAPS.2

si porta a fondo bianco l'area del modello e con

CONFIGURATION.DEVICE -> MENU COLORS -> COLOR TABLE.GRAY

si porta a fondo bianco/chiaro l'area dei menu.

Regole di composizione ovvie e non

Regole di composizione della lezione, che possono risultare banali.

  1. Evitare nei limiti del possibile errori di battitura, ortografia, frasi malformulate o di difficile lettura (es. eccessivamente lunghe).
  2. Strutturare il testo (es. introdurre sezioni, paragrafi, capoversi, con eventuali titoli) se ciò migliora la fruibilità dello stesso.
  3. Controllare le formule e assicurarsi che i simboli utilizzati siano definiti entro il testo. Compilare una tabella dei simboli a fondo pagina. Associare ai valori numerici eventuali unità di misura, utilizzando come preferenziale il sistemaN,mm,s,tonn
  4. Nei grafici, indicare sempre chiaramente la natura degli assi coordinati e delle curve rappresentate; negli schemi di struttura indicare gli assi coordinati se rilevanti; evidenziare con frecce e cerchiature i dettagli notevoli di figure complesse.
  5. Riguardo alle lezioni in laboratorio, verificare siano presenti indicazioni sufficienti per replicare passo passo l'esercitazione.
  6. Nel caso alcuni passaggi della trattazione risultino non chiari, chiedere aiuto al docente (ricevimento lunedì dalle 15 alle 18, o concordato via mail). In ogni caso notificare la natura dubbia del passaggio al lettore (e al docente che proverà a provvedere) con una nota a piè di pagina.
  7. Cercare di riportare la lezione in forma completa.
  8. Gli approfondimenti e le rielaborazioni personali sono più che benvenuti; è opportuno tuttavia che la natura originale degli stessi sia notificata ai fruitori ad esempio con nota a fondo pagina.
  9. Noto che il docente può risultare caotico nell'esposizione, cercare nei limiti del possibile di trattare gli argomenti secondo un filo logico, rielaborandoli nel caso in una sequenza ragionata.

esempio di schema di lezione


Titolo/macroargomento della lezione

blablabla

Argomento 1 o titolo paragrafo 1

blablabla

Titolo sottoparagrafo

blablabla

Argomento 2 o titolo paragrafo 2

blablabla

Argomento 3 o titolo paragrafo 3

blablabla

Lista dei simboli

$u$,$v$,$w$ spostamenti in direzione x,y,z rispettivamente
$\alpha$ fattore di scala dell'elemento triangolare, vedi Figura 1

Riferimenti

Qui potete inserire link a pagine wiki di anni precedenti, o a materiale di riferimento.

Autori, note e ringraziamenti

Tabella di monitoraggio carico orario

Fai click per rendere visibile ⇲

Fai click per nascondere ⇱

Ore-uomo richieste per la compilazione della pagina.

Autore/Revisore Prima stesura Prima revisione Seconda stesura Revisione finale Totale
de Pippis 4 0.5 4.5
de Plutis 2 1 3
Uomo Ape
Piedone 3 2 5
Revisore 1 2 0.5 2.5
Revisore 2 1 1 2
Revisore 3 2.5 1.5 4
Revisore 4
Totale 9 5.5 3.5 3 21

La sezione relativa ai revisori è da compilarsi a cura del curatore.

PATTUME

Spostare qui il materiale caricato dal docente non utilizzato a lezione o non inerente alla trattazione.

1)
ciao, sono una nota a piè di pagina