Inhaltsverzeichnis
WvdS Audit Dodatak
Verzija: 1.0
Autor: Wolfgang van der Stille zeljko.petrusic@outlook.de
Licenca: GPL 2
Opis
Dodatak wvdsaudit omogućuje ugrađivanje revizijskih oznaka na wiki stranice s automatskim izračunom statusa na temelju sintakse potvrdnih okvira.
Značajke:
- Automatski izračun statusa (passed/issues/critical)
- Kritične sekcije mogu se označiti
- Moguće ručno nadjačavanje
- Fluent Design shema boja (kompatibilno s Note dodatkom)
- Višejezično (DE, EN, SL, HR)
Sintaksa
Varijanta 1: Eksplicitne sekcije
<wvds:audit stack="stack-name" title="Naslov-modula"> <wvds:audit:result value="passed|issues|critical" /> <!-- Opcionalno: Nadjačavanje --> <wvds:section title="Naslov-sekcije" ref="wiki:poveznica" critical="true"> [x] Prošlo [ ] Nije prošlo [-] Nije primjenjivo </wvds:section> </wvds:audit>
Varijanta 2: Include (preporučeno)
Automatski učitava naslov sekcije s referencirane wiki stranice:
<wvds:audit stack="vsix" title="FPC Solution Explorer 2"> <!-- S punim tekstom --> <wvds:include ref="code:qualitaet" critical="true"> [ ] Bez TODO komentara (22 pronađeno) [x] Bez stub funkcija </wvds:include> <!-- Način predloška: horizontalno (kompaktno) --> <wvds:include ref="stacks:vscode-extension">[x][x][ ][x][x]</wvds:include> <!-- Način predloška: vertikalno --> <wvds:include ref="sicherheit:kritis"> [x] [x] [-] </wvds:include> </wvds:audit>
Prednosti Include:
- Naslov sekcije se automatski učitava sa stranice s popisom za provjeru
- Poveznica na popis za provjeru se automatski postavlja
- Kraća sintaksa, manje sklonost greškama
- Višejezično: Naslov se učitava s jezično specifične stranice
- Način predloška: Tekstovi stavki sa stranica za pregled (naveden je samo status)
Atributi
<wvds:audit>
| Atribut | Obavezno | Opis |
|---|---|---|
stack | Ne | Identifikator stacka (vsix, doku, fpc, itd.) |
title | Da | Prikazni naslov revizije |
<wvds:audit:result>
| Atribut | Opis |
|---|---|
value | Nadjačavanje: passed, issues, critical ili auto |
<wvds:section>
| Atribut | Obavezno | Opis |
|---|---|---|
title | Da | Naslov sekcije |
ref | Ne | Wiki poveznica na popis za provjeru (bez jezičnog prefiksa) |
critical | Ne | Ako true, [ ] rezultira u CRITICAL umjesto ISSUES |
<wvds:include> (NOVO)
| Atribut | Obavezno | Opis |
|---|---|---|
ref | Da | Wiki poveznica na popis za provjeru (npr. code:qualitaet, stacks:vscode-extension) |
critical | Ne | Ako true, [ ] rezultira u CRITICAL umjesto ISSUES |
Napomena: Naslov sekcije se automatski učitava iz prvog naslova (====== Naslov ======) referencirane stranice.
Sintaksa potvrdnih okvira
| Sintaksa | Status | Značenje |
|---|---|---|
[x] | passed | Kontrolna točka prošla |
[ ] | failed | Kontrolna točka nije prošla |
[-] | na | Nije primjenjivo (zanemareno) |
Izračun statusa
| Uvjet | Status | Boja |
|---|---|---|
Sve [x] | passed | Zelena (#dff6dd) |
Najmanje jedan [ ] (nekritično) | issues | Narančasta (#fff4ce) |
[ ] u critical=„true“ sekciji | critical | Crvena (#fde7e9) |
Primjeri
Sve prošlo (Zeleno)
Savršen modulAudit bestanden • 2026-03-30▾
Kvaliteta koda
- ✓ Bez TODO komentara
- ✓ Bez FIXME komentara
S problemima (Narančasto)
Modul s problemimaAudit: Anmerkungen • 2026-03-30▾
Dokumentacija
- ✓ README prisutan
- ✗ API dokumentiran
Kritično (Crveno)
Kritičan modulAudit: Kritisch • 2026-03-30▾
Datoteke
lib/plugins/wvdsaudit/
├── plugin.info.txt # Metapodaci dodatka
├── syntax.php # Parser sintakse
├── helper.php # Izračun statusa i renderiranje
├── style.css # Fluent Design stilizacija
├── conf/
│ ├── default.php # Zadane postavke
│ └── metadata.php # Admin UI
└── lang/
├── de/lang.php # Njemački
├── en/lang.php # Engleski
└── sl/lang.php # Slovenski
CSS klase
| Klasa | Opis |
|---|---|
.wvds-audit | Spremnik |
.wvds-audit-passed | Zeleni status |
.wvds-audit-issues | Narančasti status |
.wvds-audit-critical | Crveni status |
.wvds-audit-header | Područje zaglavlja |
.wvds-audit-body | Tijelo sa sekcijama |
.wvds-audit-section | Pojedinačna sekcija |
.wvds-audit-item-passed | Prošla stavka |
.wvds-audit-item-failed | Neuspješna stavka |
.wvds-audit-item-na | N/A stavka |
Vidi također
wvdsaudit DodatakAudit bestanden • 2026-03-30▾
Zuletzt geändert: 29.01.2026. u 19:55