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:


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:

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
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


wvdsaudit DodatakAudit bestanden • 2026-03-30