WvdS.DokuWiki.AcMenu Vticnik

Vticnik: wvdsacmenu
Verzija: 1.0.0
Imenski prostor: lib/plugins/wvdsacmenu/
Osnova: AcMenu avtorja Torpedo
Razsiritve: Wolfgang van der Stille zeljko.petrusic@outlook.de
Licenca: GPL 2

Vticnik wvdsacmenu prikazuje harmonika meni za imenske prostore in strani. Razsirja originalni AcMenu z wiki sintakso, dinamicnim zaznavanjem imenskega prostora in vecjezicno podporo.

• Navigacija imenskega prostora - Samodejni meni za strukturo dokumentacije
• Vecjezicni wikiji - Loceni meniji za vsak jezikovni imenski prostor
• Projektna dokumentacija - Hierarhicna navigacija v pod-imenskih prostorih
• Integracija stranske vrstice - Kompaktna navigacija v stranski vrstici

{{wvds:acmenu}}
{{wvds:acmenu ns="namespace"}}
{{wvds:acmenu dynamic="N"}}

Prikaze dolocen imenski prostor ne glede na trenutno stran:

{{wvds:acmenu ns="sl:crypto"}}
{{wvds:acmenu ns="sl:docs:api"}}

Izracuna imenski prostor glede na trenutno stran:

Vticnik zaznava meje imenskega prostora preko sidebar* datotek:

• sidebar.txt
• sidebar1.txt
• sidebar2.txt
• sidebar_ime.txt

Ce imenski prostor vsebuje eno od teh datotek, se obravnava kot samostojno podrocje.

1. Brez parametrov
   └── Išce navzgor sidebar* datoteko
   └── Zacne meni od tega imenskega prostora

2. Z ns="..."
   └── Uporabi navedeni imenski prostor neposredno

3. Z dynamic="N"
   └── Izracuna: trenutni_imenski_prostor - N ravni
   └── Prikaze od te tocke

Zahteva: Meni naj samodejno prikaze trenutno podrocje imenskega prostora.

sidebar1.txt:

~~NOCACHE~~
{{wvds:snippet>go_back}}
{{wvds:acmenu}}

Rezultat:

• Vticnik išce navzgor sidebar* datoteko
• Zacne meni od najdenega imenskega prostora
• Prikaze vse pod-imenske prostore in strani

Zahteva: Meni za slovensko dokumentacijsko podrocje.

sl/sidebar1.txt:

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

Rezultat pri sl:crypto:openssl:start:

• dynamic=„2“ gre 2 ravni gor
• Zacne pri sl:crypto
• Prikaze vso crypto dokumentacijo

Zahteva: Vedno prikazi isti imenski prostor.

{{wvds:acmenu ns="sl:api"}}

Rezultat:

• Vedno prikaze sl:api ne glede na trenutno stran
• Uporabno za fiksne navigacijske bloke

Struktura:

/
├── sidebar.txt          (Glavni meni)
├── de/
│   ├── sidebar1.txt     ({{wvds:acmenu dynamic="2"}})
│   ├── crypto/
│   │   ├── sidebar1.txt ({{wvds:acmenu dynamic="1"}})
│   │   └── openssl/
│   └── docs/
├── en/
│   ├── sidebar1.txt
│   └── ...
└── sl/
    ├── sidebar1.txt
    └── ...

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

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

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

1. Ovrednotenje parametrov
   ├── ns="" → Uporabi eksplicitni imenski prostor
   ├── dynamic="N" → Izracunaj imenski prostor
   └── (prazno) → Išci sidebar* navzgor

2. Razresitev imenskega prostora
   └── Doloci zacetni imenski prostor za meni
   └── Preveri pravice dostopa

3. Gradnja drevesa
   └── Preberi vse strani in pod-imenske prostore
   └── Filtriraj po pravicah dostopa
   └── Razvrsti po abecedi

4. Generiranje HTML
   └── Ustvari ugnezdeno <ul>/<li> strukturo
   └── Oznaci trenutno stran (.curid)
   └── Oznaci odprte poti (.open)

5. Integracija JavaScript
   └── Vedenje harmonike
   └── Shranjevanje piskotkov za odprte mape

Preko Skrbnik → Konfiguracija → wvdsacmenu:

Odprte mape so shranjene v brskalniku:

• Preusmeritev - HTML bloki za menije
• WvdS.DokuWiki.Lang Vticnik - Vecjezicna besedila menijev
• WvdS.DokuWiki.Flat Predloga - Predloga s podporo za stransko vrstico

Datoteka: lib/plugins/wvdsacmenu/syntax.php

Datoteka: lib/plugins/wvdsacmenu/script.js

• Upravljalnik klikov harmonike
• Upravljanje piskotkov
• Gladko drsenje do trenutnega elementa