Last ned NTNU-malverk for DokuWiki

• Gjeldende versjon (DokuWiki 2008-05-05): ntnu-2008-06-02.zip

Tidligere versjoner

• DokuWiki 2007-06-26b: ntnu-2008-04-10.zip

Noe av funksjonaliteten som beskrives på denne siden kan mangle i gamle maler, bruk derfor siste versjon hvis du kan.

Stikkord

• Validerende XHTML 1.0 Transitional
• WCAG AAA, WAI AAA, Section 508 godkjent
  (med unntak av kontrastproblemene i NTNU-fargene)
• Utskrifts- og mobil/PDA-vennlig CSS
• Tabellfri design
• Vesentlige størrelser satt i EM
• Testet og fungerer i en rekke nettlesere.

Pakk ut i tpl-mappa, og velg NTNU som layout i Configuration Manager. Malen har noen innstillinger for tekst i footer, denne kan også justeres i Configuration Manager.

Malen støtter både norsk og engelsk, forutsatt at den engelske grenen av nettstedet finnes med url

<installasjonssted>/english

Post gjerne (frivillig selvsagt) URL'en din på referanselista hvis du bruker templaten.

Hvis du gjør endringer som kan være interessante for andre ved NTNU er det fint om du gir oss et vink, så kan endringen kanskje bakes inn i denne layouten.

Bruksanvisning: Installere templates.

• Man kan ha én global meny for hele nettstedet: mainmenu. Denne filen må ligge på øverste nivå.
• Man kan ha undermenyer hvor som helst i systemet. Menyfilene antas å hete menu, og må være lagres med URL <sidenavn>/menu. Eks: filen til DokuWiki-menyen til venstre har URL: www.ime.ntnu.no/dokuwiki/menu.
• En meny arves til undersider, helt til man finner en annen menyfil som overtar.

Fra versjon 2007-10-22 støttes ekspanderende menyer på inntil tre nivåer. Syntaks følger punktlistesyntaksen i DokuWiki.

Eksempel:

  * [[:studier|Studier]]
    * [[:studier:teknologi|Teknologi/sivilingeniør]]
    * [[:studier:realfag]]
    * [[:studier:plu|Lærerutdanning]]
    * [[:studier:internasjonal|Internasjonal MSc]]
    * [[:forskning:phd]]

Når et menypunkts pageID/sideID matcher URL-en som besøkes vil punktet (og overpunkter) åpnes. For å lage nye “topp-punkter” bruker man vanlig menyarv og starter der den forrige slapp.

• Hver side kan ha sin egen sidebar, filen antas å hete sidebar og må ligge på URL <sidenavn>/sidebar. Denne er sidespesifikk og arves ikke.
• Arvende sidebars oppfører seg på samme måte som menyer, filen antas å hete mainsidebar og må ligge på URL <sidenavn>/mainsidebar. Denne arves til undersider, helt til man finner en annen mainsidebar som overtar.
• For å lage infobokser i sidebar trenger du infoboks-plugin.

Navnene mainmenu, menu, mainsidebar og sidebar kan endres i Configuration manager.

Tips: hvis man vil ha en side uten menyer lager man en fil <navn på side uten meny>/menu, legger et par linjeskift i fila og lagrer. (Helt tomme filer fjernes automatisk av DokuWiki).

Gjennom “Configuration manager” er det mulig å legge til egendefinert brødsmulesti foran den stien wikien genererer selv. Det gjør det mulig å vise hele strukturen opp til www.ntnu.no. Lenkene skrives inn på wikisyntaks, med én lenke på hver linje i tekstboksen.

Eksempel:

[[http://www.ntnu.no|NTNU]]
[[http://www.ntnu.no/omntnu|Om NTNU]]
[[http://www.ntnu.no/faksent|Fakulteter og institutter]]
[[http://www.ntnu.no/ime|IME-fakultetet]]

I tillegg er det mulig å skjule ett eller flere nivåer av den autogenererte stien. Det er nyttig hvis førstesiden har veldig lang tittel, eller man jobber på et nivå som visuelt (i brødsmulestien) skal fremstå som høyere opp i strukturen.

Eksempel: IME skjuler 1 nivå i norsk brødsmulesti. Det er for å unngå den lange “Fakultet for informasjonsteknologi, matematikk og elektroteknikk”. I stedet har vi angitt “IME-fakultetet” som del av den tilpassede brøsmulestien.

På engelsk utgave av nettstedet skjuler vi 2 nivåer, samtidig som vi bruker følgende tilpassede versjon:

[[http://www.ntnu.no/english|NTNU]]
[[http://www.ntnu.no/aboutntnu|About NTNU]]
[[http://www.ntnu.no/faculties|Faculties and departments]]
[[http://www.ntnu.no/ime/english|IME Faculty]]

Dermed skjules det at engelske sider ligger ett nivå lavere ned enn de norske.

Malen ser etter og inkluderer tpl_functions.local.php hvis den finnes i mal-mappa. Der kan du legge egendefinerte funksjoner, include's og andre ting du ønsker å ha tilgjengelig for malen. Denne fila blir ikke overskrevet ved oppgradering, og er dermed en trygg måte å ta med seg sine egne “hack”.

DokuWiki tillater installering av svært mange nyttige plugins. Den har også en åpen API som gjør det mulig å skrive sine egne. Under følger IMEs egenskrevne plugins. Alle kan installeres vha. DokuWikis Plugin manager.