DokuWiki

It's better when it's simple

Strumenti Utente

Strumenti Sito


it:devel:templates

Sviluppo Template DokuWiki

È possibile personalizzare il design di DokuWiki creando un nuovo modello di template. Un template è determinato da alcuni file PHP e CSS memorizzati in una directory nella directory di <dokuwiki>/lib/tpl/ (in realtà, il modello è realizzato in HTML, il PHP viene utilizzato per inserire il contenuto.).

Guida introduttiva

Il modo più semplice per creare un nuovo modello è quello di prendere uno uno già esistente come punto di partenza. E 'una buona idea di usare il template starter perché è pulito e rispetta gli standard del modello di DokuWiki standard. I nomi dei modelli e le (directories) devono essere in minuscolo, e “.” o “_” non sono ammessi.

  1. Copiare il lib/tpl/default directory nel lib/tpl/yourname
  2. Selezionare il nuovo modello nella gestione di configurazione (configuration manager
  3. Poi uno sguardo ai file del template (si veda Directory Layout)
  4. Dai un’occhiata come DokuWiki usa i CSS utilizzando il pulsante CSS dispatcher.
  5. La gestione delle impostazioni di configurazione è analoga a plugins. Use tpl_getConf(<setting>) per recuperare le impostazioni di modelli personalizzati.

Directory Layout

I template devono seguire la seguente struttura di directory (tutti i percorsi sono relativi alla directory dei template). I file CSS sono specificati nella' style.ini ma si dovrebbe cercare di scrivere almeno un file CSS per la presentazione nello schermo e uno per la stampa.

  • <dokuwiki>/lib/tpl/<template>/
    • <filename>.css
    • main.php – layout generale DokuWiki
    • detail.php – immagine della pagina dettagli
    • mediamanager.php – la media-selezione popup
    • images/ – tutte le immagini utilizzate nel template
    • conf/
    • lang/ – lang i file delle lingue
      • <lang code>/lang.php – stringhe di localizzazione utilizzati nel modello (template)
      • <lang code>/settings.php – stringhe di localizzazione usati nella gestione della configurazione (configuration manager)
    • style.ini – vedi Style.ini
    • favicon.ico – saranno utilizzati se non esiste nella media-directory (see tpl_getFavicon())
it/devel/templates.txt · Ultima modifica: 2012-03-18 01:29 da 151.42.179.18

Ad eccezione da dove è diversamente indicato, il contenuto di questo wiki è soggetto alla seguente licenza: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki