WvdS.DokuWiki.Flat Predloga

Predloga: flat
Verzija: 1.1.0 (WvdS razširitve)
Imenski prostor: lib/tpl/flat/
Original: beemoon contact@beemoon.fr
Razširitve: Wolfgang van der Stille zeljko.petrusic@outlook.de
Licenca: GPL 2

Flat predloga je minimalistična, odzivna DokuWiki predloga z WvdS razširitvami za večjezičnost, preklopnik jezika, nastavljive stranske vrstice, sistem logotipa z base64 upodobitvijo in brezhibno integracijo z WvdS vtičniki.

• Večjezična dokumentacija - Samodejni preklopnik jezika in zaznava
• Baze znanja - Čista navigacija z harmonika meniji
• Projektna dokumentacija - Hierarhična struktura stranske vrstice
• Podjetniški wikiji - Profesionalen, prilagodljiv dizajn
• Optimizirana zmogljivost - Vgrajene base64 slike, upravljanje stanja s piškotki

Zahteva: Wiki z nemščino, angleščino in slovenščino.

conf/local.php:

$conf['tpl']['flat']['enableLangSwitcher'] = 1;
$conf['tpl']['flat']['languages'] = 'de,en,sl';
$conf['tpl']['flat']['langPosition'] = 0;
$conf['tpl']['flat']['defaultLanguage'] = 'de';

start.txt (za samodejno preusmeritev):

{{wvds:redirect target="{lang}:start"}}

Rezultat:

• Preklopnik jezika prikaze DE/EN/SL moznosti
• Samodejna preusmeritev preko vticnika wvdscond

Zahteva: Glavni meni zgoraj, harmonika navigacija spodaj.

Struktura datotek:

data/pages/
├── sidebar.txt          → Glavni meni
├── sidebar1.txt         → Prazna datoteka (nadomestek)
├── de/
│   └── sidebar1.txt     → {{wvds:snippet>go_back}}
│                           {{wvds:acmenu dynamic="2"}}
├── en/
│   └── sidebar1.txt     → {{wvds:snippet>go_back}}
│                           {{wvds:acmenu dynamic="2"}}
└── sl/
    └── sidebar1.txt     → {{wvds:snippet>go_back}}
                            {{wvds:acmenu dynamic="2"}}

sidebar.txt (Koren):

~~NOCACHE~~
{{wvds:snippet>main_menu}}

sl/sidebar1.txt:

~~NOCACHE~~
{{wvds:snippet>go_back}}
{{wvds:acmenu dynamic="2"}}

Zahteva: Besedilo podnožja v različnih jezikih.

Konfiguracija:

footerText = de:© 2025 Meine Firma - Alle Rechte vorbehalten|en:© 2025 My Company - All rights reserved|sl:© 2025 Moje podjetje - Vse pravice pridržane

Rezultat:

• Nemške strani: „© 2025 Meine Firma - Alle Rechte vorbehalten“
• Angleške strani: „© 2025 My Company - All rights reserved“
• Slovenske strani: „© 2025 Moje podjetje - Vse pravice pridržane“

Zahteva: Logotip iz wiki medijev z optimalno prikazavo.

Skrbniška konfiguracija:

showLogo = 1
logoSource = wiki
logoPath = wiki:logo.png
logoContainerSize = 300
logoFit = contain
logoPosition = center
logoMaxWidth = 300
logoQuality = 90

Rezultat:

• Logotip je upodobljen kot vgrajena base64 slika (prek wvdsimage)
• Ni dodatne HTTP zahteve za logotip
• Slika je pomanjšana na maks. 300px in centrirana v 300x300px vsebniku
• object-fit: contain zagotavlja, da je celotna slika vidna

Alternativa: Logotip iz mape predloge:

showLogo = 1
logoSource = template
logoPath = logo.png        // nahaja se v lib/tpl/flat/images/logo.png

Alternativa: Zunanji logotip:

showLogo = 1
logoSource = url
logoPath = https://example.com/logo.png

1. Analiza imenskega prostora
   └── Izvleče jezik iz položaja langPosition
   └── Primer: sl:crypto:openssl → "sl"

2. Preklop jezika
   └── Zamenja jezikovni segment v imenskem prostoru
   └── sl:crypto:openssl → en:crypto:openssl

3. Preverjanje strani
   └── Preveri ali ciljna stran obstaja
   └── Če ne: Preusmeritev na začetno stran jezika

1. Specifično za imenski prostor
   └── Išče sidebar/sidebar1 v trenutnem imenskem prostoru

2. Starševski imenski prostor
   └── Išče navzgor v starševskih imenskih prostorih

3. Korenska nadomestna možnost
   └── Uporabi korensko stransko vrstico če nič ni najdeno

1. Zaznaj jezik brskalnika
   └── Razčleni glavo Accept-Language

2. Jezik razpoložljiv?
   ├── Da: Preusmeri na imenski prostor jezika
   └── Ne: Preusmeri na defaultLanguage

Predloga deluje brezhibno z WvdS vtičniki:

// V datotekah predloge
$helper = plugin_load('helper', 'wvdsi18n');
$lang = $helper->getLang();
$text = $helper->get('menu_home');

Uporaba:

• Lokalizacija besedil podnožja
• Prevod oznak menija
• Razčlenjevanje konfiguracijskih vrednosti

sidebar.txt:

{{wvds:snippet>main_menu}}

Uporaba:

• Večkrat uporabne menijske strukture
• HTML komponente v stranskih vrsticah
• Skupni elementi preko imenskih prostorov

sidebar1.txt:

{{wvds:acmenu dynamic="2"}}

Uporaba:

• Harmonika navigacija v stranskih vrsticah
• Dinamična zaznava imenskega prostora
• Samodejno odpiranje/zapiranje

Ustvarite conf/userstyle.css za prilagoditve:

/* Prilagoditev preklopnika jezika */
.lang-switcher {
    position: fixed;
    top: 10px;
    right: 10px;
}
 
/* Širina stranske vrstice */
.sidebar {
    width: 280px;
}
 
/* Oblikovanje podnožja */
.footer {
    background: #333;
    color: #fff;
    padding: 20px;
}

• v vseh stranskih vrsticah z dinamično vsebino
• langPosition pravilno nastavite za strukturo imenskega prostora
• sidebar1.txt ustvarite v vsakem jezikovnem imenskem prostoru
• wvdschunk uporabljajte za večkrat uporabne menijske elemente
• Nadomestni jezik vedno konfigurirajte

• WvdS.DokuWiki.i18n Plugin - Internacionalizacija (prevodi)
• WvdS.DokuWiki.Cond Plugin - Pogojna vsebina + Preusmeritve
• WvdS.DokuWiki.Snippet Vticnik - Veckrat uporabne HTML komponente
• WvdS.DokuWiki.AcMenu Vticnik - Harmonika meni
• WvdS.DokuWiki.Image Vticnik - Obdelava slik z base64 izhodom
• Originalna Flat predloga

lib/tpl/flat/
├── main.php            → Glavna predloga
├── detail.php          → Pogled podrobnosti medijev
├── mediamanager.php    → Upravljalnik medijev
├── conf/
│   ├── default.php     → Privzeta konfiguracija
│   └── metadata.php    → Metapodatki konfiguracije
├── lang/
│   ├── de/lang.php     → Nemški prevodi
│   ├── en/lang.php     → Angleški prevodi
│   └── sl/lang.php     → Slovenski prevodi
├── lang_helper.php     → Jezikovne in logo pomožne funkcije
├── css/
│   ├── style.css       → Slogi predloge
│   └── logo.css        → Slogi logotipa
├── js/
│   └── script.js       → Skripte predloge (vklj. TOC piškotek)
└── images/
    └── flags/          → Jezikovne zastave