Entrambe le parti precedenti la revisioneRevisione precedenteProssima revisione | Revisione precedente |
avanzate [2017/03/16 08:38] – [Formule] admin | avanzate [2020/07/03 15:58] (versione attuale) – modifica esterna 127.0.0.1 |
---|
* per aggiornare DokuWiki, **dopo aver fatto una backup**, sovrascrivere la cartella scaricando l'ultima versione del software e caricandola con FileZilla (la cartella con le pagine, le immagini e la configurazione //non dovrebbero// andare perse) | * per aggiornare DokuWiki, **dopo aver fatto una backup**, sovrascrivere la cartella scaricando l'ultima versione del software e caricandola con FileZilla (la cartella con le pagine, le immagini e la configurazione //non dovrebbero// andare perse) |
| |
Informazioni più dettagliate si trovano nelle pagine del sito ufficiale: [[doku>faq:backup]] e [[ddoku>install:upgrade]]. | Informazioni più dettagliate si trovano nelle pagine del sito ufficiale: [[doku>faq:backup]] e [[doku>install:upgrade]]. |
| |
Non dimentichiamo mai che **"il backup è quella cosa che andava fatta prima"** | Non dimentichiamo mai che **"il backup è quella cosa che andava fatta prima"** |
===== Plugin consigliati e installazione via FTP ===== | ===== Plugin consigliati e installazione via FTP ===== |
| |
Le limitazioni del servizio di hosting non permettono di installare i plugin direttamente dal sito. Bisogna allora: | Le limitazioni del servizio di hosting non permettono di installare i plugin direttamente dalla pagina di amministrazione del sito. Bisogna allora: |
* cercare i plugin nella [[doku>plugins|pagina]] del sito ufficiale | * cercare i plugin nella [[doku>plugins|pagina]] del sito ufficiale |
* leggere la relativa pagina, in particolare le note sull'installazione del plugin | * leggere la relativa pagina dedicata al plugin e in particolare le note sull'installazione |
* scaricare il plugin nel PC | * scaricare il plugin nel PC |
* scompattarlo e rinominare la cartella come indicato | * scompattarlo e rinominare la cartella come indicato (DokuWiki segnala l'errore nel caso e suggerisce come rinominare il file) |
* caricare la cartella del plugin via FTP con FileZilla (i plugin vanno nella cartella ''dokuwiki/lib/plugins/'' del server) | * caricare la cartella del plugin sul server con FileZilla (i plugin vanno nella cartella ''dokuwiki/lib/plugins/'' del server) |
* controllare che il plugin sia presente nella pagina delle extensions ed eventualmente configurarlo nella pagina di configurazione del Wiki | * controllare che il plugin sia presente nella pagina delle extensions |
| |
Plugin raccomandati: | Plugin raccomandati: |
* [[doku>plugin:cookielaw]], per la conformità con la (stupida) legge EU sui cookie | * [[doku>plugin:cookielaw|cookielaw]], per la conformità con la (stupida) legge EU sui cookie |
* [[doku>plugin:comment]], per fare in modo che una sezione della pagina sorgente non venga visualizzata nella corrispondente pagina wiki (utile per le bozze) | * [[doku>plugin:comment|comment]], per fare in modo che una sezione della pagina sorgente non venga visualizzata nella corrispondente pagina wiki (utile per le bozze) |
* [[doku>plugin:folded]] per nascondere parte della pagina e renderla visibile con un click (utile per domande e risposta prima nascosta, poi visibile) | * [[doku>plugin:folded|folded]] per nascondere parte della pagina e renderla visibile con un click (utile per domande e risposta prima nascosta, poi visibile) |
* [[doku>plugin:mathjax]], per le formule | * [[doku>plugin:mathjax|mathjax]], per le formule |
* [[doku>plugin:vshare]], per inserire video all'interno delle pagine (vedi https://leonardocanducci.org/wiki/sta/arduino_7 per un esempio) | * [[doku>plugin:vshare|vshare]], per inserire video all'interno delle pagine (vedi [[https://leonardocanducci.org/wiki/sta/arduino_7|questa pagina]] per un esempio) |
| |
===== Immagini ===== | ===== Immagini ===== |
E' possibile anche inserire immagini senza caricarle nel proprio sito ma "linkandole" da altri siti web, tuttavia non è una buona pratica ed è considerato scorretto. | E' possibile anche inserire immagini senza caricarle nel proprio sito ma "linkandole" da altri siti web, tuttavia non è una buona pratica ed è considerato scorretto. |
| |
Qualche raccomandazione tecnica sulle immagini che inseriremo (vedere anche le indicazioni di [[wp>Wikipedia:Preparing_images_for_upload|Wikipedia]]: | Qualche raccomandazione tecnica sulle immagini che inseriremo (vedere anche le indicazioni di [[wp>Wikipedia:Preparing_images_for_upload|Wikipedia]]): |
* usare il formato ''jpeg'' per le foto e il formato ''.png'' per diagrammi, schemi e simili | * usare il formato ''jpeg'' per le foto e il formato ''.png'' per diagrammi, schemi e simili |
* controllare sempre la **dimensione del file**, se è maggire di 1MB ridimensionare l'immagine (100KB è un valore adeguato) | * controllare sempre la **dimensione del file**, se è maggire di 1MB ridimensionare l'immagine (100KB è un valore adeguato) |
| |
Seguendo queste indicazioni si ottimizza la qualità dell'immagine per il web (per le foto da stampare è tutto un altro discorso) e il "traffico internet" (non vogliamo aspettare dei secondi o consumare dati del piano telefonico per scaricare un'immagine che sarà comunque ridimensionata per "entrare nello schermo"). | Seguendo queste indicazioni si ottimizza la qualità dell'immagine per il web (per le foto da stampare è tutto un altro discorso) e il "traffico internet" (non vogliamo aspettare dei secondi o consumare dati del piano telefonico per scaricare un'immagine che sarà comunque ridimensionata per "entrare nello schermo"). |
| |
| Circa il software (gratuito) da utilizzare posso segnalare: |
| * lo //Strumento di cattura// di Windows che permette di salvare schermate, finestre, ecc. in formato ''.png'' (ad esempio per salvare un immagine di un circuito simulato con Multisim) |
| * [[https://www.gimp.org/|Gimp]] per ridimensionare e ritoccare le immagini |
| * [[https://inkscape.org/it/|Inkscape]] per disegnare grafici, diagrammi, schemi (io lo uso per gli schemi, ad esempio in [[https://leonardocanducci.org/wiki/tp4/alimentatori_switching|questa pagina]]) |
| |
| |
===== Video ===== | ===== Video ===== |
La soluzione migliore per inserire formule in DokuWiki è usare il plugin [[doku>plugin:mathjax|mathjax]]. | La soluzione migliore per inserire formule in DokuWiki è usare il plugin [[doku>plugin:mathjax|mathjax]]. |
| |
Una volta installato il plugin permette di inserire delle formule, seguendo una particolare sintassi, contenute tra due simboli ''$''. Quando la pagina viene generata DokuWiki trasforma il testo inserito in una formula. | Una volta installato il plugin permette di inserire delle formule, seguendo una particolare sintassi, contenute tra due simboli ''$''. Quando la pagina viene generata DokuWiki trasforma il testo inserito in una formula. La sintassi predefinita è quella Tex (LaTex) per la matematica (vedi [[https://en.wikibooks.org/wiki/LaTeX/Mathematics|questo manuale]] o questo {{ ::latexsheet-a4.pdf |PDF}} riassuntivo)((in alternativa è possibile utilizzare la sintassi molto più semplice di [[http://asciimath.org/|asciimath]] usando il simbolo '''%%`%%'' al posto del dollaro e modificando la configurazione del plugin come spiegato [[doku>plugin:mathjax#asciimath|qui]])). |
| |
| |
===== URL rewrite ===== | ===== URL rewrite ===== |
| |
FIXME | E' una scelta delicata ed è descritta in [[doku>rewrite|questa pagina]] della documentazione ufficiale. |
| |
| I risultati migliori si ottengono impostando l'opzione ''.htaccess'' nella configurazione del wiki, ma **prima bisogna modificare** il file ''.htaccess'' nella cartella ''dokuwiki'' del server secondo le indicazioni riportate [[doku>rewrite#apache|qui]]. |
| ===== Vuotare la cache ===== |
| |
| Certe volte capita che qualche operazione di amministrazione/configurazione non vada a buon fine nonostante si sia seguito scrupolosamente documentazione ufficiale. A volte è sufficiente vuotare la cache di DokuWiki per "sistemare tutto". Per farlo basta andare nella pagina di configurazione e salvare le impostazioni (anche senza aver fatto modifiche). |
| |
| ===== Interwiki personalizzati ===== |
| |
| Gli [[doku>it:interwiki]] sono collegamenti rapidi ad altri siti wiki. Ce ne sono di predefiniti, ad esempio per raggiungere la pagina su Pascal di Wikipedia (in inglese) basta scrivere ''%%[[wp>Blaise_Pascal]]%%''. Per aggiungere altri collegamenti interwiki bisogna definirli nel file ''conf/interwiki.local.conf''. La procedura è descritta chiaramente nella [[doku>it:interwiki|pagina sugli interwiki]] ma, ad esempio, se volessimo aggiungere un collegamento rapido alle pagine Wikipedia in italiano potremmo creare il file ''dokuwiki/conf/interwiki.local.conf'' e aggiungere la linea: |
| |
| wpi http://it.wikipedia.org/wiki/{NAME} |
| |
Se serve lo spiego... | |
===== Altro ===== | |
| |
* Strani problemi: provare a svuotare la cache (salvare le impostazioni) | |
* interwiki (local e lib/images/interwiki wpi.gif) | |
| |
| |
| |