WvdS Audit Dodatak
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)
S problemima (Narančasto)
Kritično (Crveno)
Sigurnost *- ✗ Validacija unosa
- ✓ Rukovanje greškama
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