Differenze

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

--- note:dokuwiki [2016/01/10 17:53] – modifica esterna 127.0.0.1
+++ note:dokuwiki [2016/09/06 13:02] (versione attuale) – eliminata admin
@@ Linea 1: / Linea 1: @@
-====== Note su Dokuwiki ======
-===== Installazione =====
-Dokuwiki 2012-10-13 "Adora Belle" (da ''Amministrazione'' -> ''raccolta dati'' o ''VERSIONE'' in FTP).
-Installato nella sottodirectory ''ti'' della root. Per portare a termine l'installazione su altervista.org bisogna cambiare i permessi (''chmod -R g+w'') prima di copiare via FTP.
-Imposto titolo, lingua, ACL. Cambio ''dmode''/''fmode'' (664/775) per non avere problemi nella cancellazione dei file anche se probabilmente non è necessario. Disabilito la registrazione automatica e imposto l'URL rewrite tramite ''.htaccess'' (vedi doc).
-Cancello ''install.php'' e ''.htaccess.dist''.
-Modifico le impostazioni ACL per permettere la lettura a tutti.
-/*
-Installo il plugin ''odt'' per esportare in formato OpenOffice. L'installazione col plugin manager fallisce. L'installazione manuale va a buon fine ma bisogna rinominare ''info.txt'' in ''plugin.info.txt'' perché il plugin manager mostri le informazioni correttamente.
-Creo un template ''default_odt'' identico a quello standard ma con ''main.php'' modificato per inserire il bottone ''Export to ODT'' per esportare in formato OpenOffice. Anche in questo caso bisogna cambiare i permessi prima di copiare i file o il template non funziona.
-Installato il plugin ''asciimath'' per le formule.
-*/
-Con altervista.org bisogna installare i plugin vanno installati a mano. Installo:
-  * ''comment'' per commentare parti del sorgente pagina
-===== Backup =====
-La soluzione più semplice è un veloce backup via FTP **solo delle pagine** con ''lftp''. Ho creato uno script in ''bin/backupTic'' che esegue il comando (ce n'è una copia nella directory dei backup).
-<code>
-#!/bin/sh
-backupPath=/home/leo/Documenti/lavoro/iti/2011-2012/tecnologia\ informatica/wiki/backup/pagineFTP/
-oggi=`date +%F`
-[ -d "$backupPath/$oggi" ] || mkdir "$backupPath/$oggi"
-cd "$backupPath/$oggi"
-lftp -e "mirror ti/data/pages && exit" -u user,password controlli.altervista.org
-</code>
-**NB** Le immagini e gli altri media non vengono copiati in questo modo.
-Il backup via plugin non funziona con altervista.org.
-===== Gestione del Wiki =====
-La configurazione di default è nel file ''dokuwiki.php'' che non viene alterato.
-Tutti i parametri diversi dal default sono nel file ''local.php''.
-Almeno inizialmente possono contribuire al wiki solo gli utenti registrati e la registrazione automatica è bloccata.
-Aggiunto un URL interwiki e la relativa icona per Wikipedia Italia (upload di ''interwiki.local.conf'' e ''wpi.gif''). Perché la modifica abbia effetto bisogna pulire la cache.
-Gli indirizzi email vengono mascherati (esadecimale) per contrastare lo spam.
-/*
-Esportazione in formato OpenOffice tramite il plugin [[doku>plugin:odt|odt]] e il template ''default_odt'' (modificato come da istruzioni del plugin).
-*/
-==== Tips ====
-  * Per svuotare la **cache** cambiare (e ripristinare, volendo) un parametro della configurazione.
-  * **Rinominare** e **spostare** le pagine è difficile (il plugin pagemove non funziona). La procedura più semplice è duplicare le pagine, metter un link alla nuova pagina in quella vecchia e sistemare i backlink. Poi per **cancellare** una pagina eliminare tutto il contenuto e salvare.
-  * Per ottenere il nome di una **sezione** editarla e salvare. Nella barra dell'indirizzo del browser comparirà il nome della sezione.
-  * [[doku>accesskeys|Scorciatoie da tastiera]].
-  * Testare tutto sulla vecchia installazione prima.
-==== TODO ====
-  * Implementare le ACL per permettere contributi esterni.
-===== Stile =====
-==== Struttura e organizzazione dei contenuti ====
-Il wiki ha una pagina principale, e delle categorie, accessibili dall'indice (pulsante in basso a destra).
-In ogni pagina viene creato un indice automaticamente utilizzando i titoli delle sezioni con intestazione da 1 a 3. I titoli delle sezioni, per loro natura, non sono link. All'interno di ogni sezione si può però linkare a una pagina.
-Per sua natura un Wiki non si presta a una lettura lineare mentre un corso è in genere strutturato linearmente. Per creare un collegamento
-esplicito tra un argomento e quello successivo si può mettere un link alla pagina seguente o a quella superiore.
-==== Linee guida ====
-  * Struttura pagine: Accorpare in una pagina tutti gli argomenti di un capitolo e sfruttare la ''TOC'' (soluzione printer friendly)
-  * Indice: a mano: link alle pagine (capitoli), link alle sezioni delle varie pagine (paragrafi)
-  * Numerazione: numerazione dei capitoli e dei paragrafi come nel libro di testo
-  * Navigazione: aggiungere un link all'indice in fondo a ogni pagina
-  * Riferimenti: aggiungere una sezione riferimenti ogni volta che è utile e link a wikipedia
-  * Forma: impersonale
-  * Pagine incomplete: nascondere la parte incompleta col plugin ''folded'' o commentarla col plugin ''comment''
-Vedi anche i [[doku>tips:good_style|tips di dokuwiki]].
-**NB** L'uso dei link alle sezioni non è ben documentato ed è facile rompere i link (basta modificare il titolo di una sezione). Usarli con cautela.
-==== Convenzioni tipografiche ====
-Formattazione:
-  * per l'enfasi uso il **grassetto**
-  * in alternativa, per le cose meno importanti, il __sottolineato__
-  * per i nomi di file, i parametri, i bottoni e simili il ''monospace''
-==== Figure, grafici, formule, immagini ====
-=== Formato immagini ===
-Da wikipedia [[wp>Wikipedia:Preparing_images_for_upload|consigli]] su formato e dimensione dei file. Vedi anche [[wp>Wikipedia:Graphics_tutorials|qui]].
-Il formato ''SVG'', raccomandato per diagrammi e grafici, non è supportato direttamente. Usando il plugin è comunque complicato.
-Il ''JPEG'' va evitato tranne che per le foto.
-Per i grafici usare ''PNG'' (lossless ma comunque efficace).
-/*
-=== Programmi ===
-  * XCircuit per disegni di circuiti (elettrici e logici). Salva in formato ''PS'' o ''EPS'', poi si converte con:
-  convert -density 200 immagine.ps immagine.png    <---- converte in PNG
-  mogrify -resize 250x250 immagine.png             <---- scala (larghezza e altezza massima)
-  * __Gimp__ per conversioni (da ''PS'' a ''PNG'' e altro)
-  * __Inkscape__ per la grafica vettoriale ''SVG'', i diagrammi e le conversioni da ''PS'' a ''SVG''
-  * __Dia__ per diagrammi di flusso, e circuiti (ma le librerie sono incomplete e in generale non è granché)
-  * __OpenOffice__ per esportare dai lucidi già fatti
-  * __FidocadJ__ per logica a contatti
-  * __gnuplot__ (e suoi frontend), __openoffice__, per i grafici cartesiani
-Per esportare le immagini dai lucidi bisogna selezionarle e convertirle in bitmap con OpenOffice Impress, poi ridimensionarle (''convert -resize'').
-Per i grafici cartesiani si può usare openoffice calc, poi bisogna esportare in pdf (e usare convert e tagliare) o incollare in draw e esportare in png.
-=== Formule ===
-Ci sono varie opzioni. La più semplice è installare il plugin ''asciimath'' e usare la sintassi ''asciimathML'' stile:
-<code>$$x^2$$ or $$a_(mn)$$ or $$a_{mn}$$ or $$(x+1)/y$$ or $$sqrtx$$</code>
-che produce questo output: $$x^2$$ or $$a_(mn)$$ or $$a_{mn}$$ or $$(x+1)/y$$ or $$sqrtx$$
-Il problema è che non funziona su tutti i browser (per Explorer 7 serve il plugin PlayMath o TechExplorer).
-==== TODO ====
-  * <del>Creare una pagina con le categorie</del> C'è già il bottone ''indice'' per questo
-  * <del>Assegnare una categoria a ogni capitolo</del> Non c'è bisogno visto che ogni capitolo è in una sola pagina
-  * <del>Usare anche l'//italico//?</del> No, poco efficace. Si vede poco
-  * <del>Usare il __sottolineato__?</del> Sì, enfasi minore
-  * <del>Provare nuovi template meno confusi ("meno wiki")</del> Il risultato non è granché, meglio tenere il default
-  * <del>Installare il plugin ''folded'' o il plugin ''hidden'' per nascondere parti della pagina.</del> Installato ''folded''
-  * Usare delle immagini per le forumle?
-*/