**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'' ,<del>Barrato</del> .

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 ''-'',
  - blabla;
  - blabla;
    - blablabla;
    - blablabla;
  - blabla.
Con due spazi e un ''*'' si inizializza un elenco puntato
  * blabla;
  * blabla;
    * blablabla;
    * blablabla;
  * blabla.

È possibile inserire note a piè di pagina((ciao, sono una nota a piè di pagina)) utilizzando la sintassi ''%%(( nota ))%%''.

Ulteriori note sono riportate [[https://www.dokuwiki.org/start?id=it:editing|qui]] e [[https://www.dokuwiki.org/it:syntax|qui]].
===== Formule =====



Una formula può essere inserita utilizzando la sintassi latex; nel caso non vi sia familiare potete comporre l'equazione online su [[http://www.codecogs.com/latex/eqneditor.php|Codehogs editor]], [[http://arachnoid.com/latex/|Interactive LaTeX Editor]] oppure 
[[http://it.numberempire.com/texequationeditor/equationeditor.php|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 [[wikipaom2015:formule|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 fiore>
{{:wiki:pagina_base_immagine_esempio_fiore.jpg|}}
<caption> Esempio di figura </caption>
</figure>

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
<code>
  <figure etichetta>
  
  
  <caption> didascalia </caption>
  </figure>
</code>
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 [[http://sourceforge.net/projects/ipe7/files/ipe/7.1/|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.

  - Evitare nei limiti del possibile errori di battitura, ortografia, frasi malformulate o di difficile lettura (es. eccessivamente lunghe).
  - Strutturare il testo (es. introdurre sezioni, paragrafi, capoversi, con eventuali titoli) se ciò migliora la fruibilità dello stesso.
  - 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 sistema''N,mm,s,tonn''
  - 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.
  - Riguardo alle lezioni in laboratorio, verificare siano presenti indicazioni sufficienti per replicare passo passo l'esercitazione.
  - 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.
  - Cercare di riportare la lezione in forma completa.
  - 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.
  - 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 {{ref>fiore}}  |


===== 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====
<hidden>
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.
</hidden>

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