Differenze

Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.

--- wiki:pagina_appunti_base [2017/05/03 17:09] – ebertocchi
+++ wiki:pagina_appunti_base [2017/05/03 17:10] (versione attuale) – ebertocchi
@@ Linea 1: / Linea 1: @@
+**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.