Passa al contenuto principale

Z404-config-asset-missing — Asset di Infrastruttura Non Trovato

Z-Code: Z404 CONFIG_ASSET_MISSING · Engine: mkdocs · Exit: 0

zenzic check all
mkdocs - 2 files (2 docs, 0 assets) - 0.0s - 116 files/s
docs/docs/assets/logo.svg
⚠[Z404]logo asset not found on disk: 'docs/assets/logo.svg' (declared as theme.logo: 'assets/logo.svg' in mkdocs.yml) [Z404]
────────────────────────────────────────────────────────────────────────────────
Summary:✘ 0 errors⚠ 1 warningℹ 0 info- 1 file with findings
✨ Analysis complete: All statically-detectable links, credentials, and references verified.
Refer to https://zenzic.dev/docs/reference/finding-codes for remediation · Try
'zenzic check --help' for options.
🔒 Suppression Audit: 0/30 (inline: 0, per-file: 0)
exit 0

Il Fixture​

Il fixture si trova in examples/z404-config-asset-missing/ nel repository Zenzic. Utilizza l'engine MkDocs.

mkdocs.yml dichiara theme.logo: assets/logo.svg ma docs/assets/logo.svg non esiste su disco:

examples/z404-config-asset-missing/mkdocs.yml
site_name: My Project
theme:
  name: material
  logo: assets/logo.svg
examples/z404-config-asset-missing/.zenzic.toml
docs_dir = "docs"
fail_under = 0

[build_context]
engine = "mkdocs"

Eseguire l'Esempio​

# Clona il repository Zenzic — nessuna installazione richiesta
cd examples/z404-config-asset-missing
uvx zenzic check all

Output atteso:

mkdocs · 2 files (2 docs, 0 assets) · 0.0s · 116 files/s

docs/docs/assets/logo.svg  !  [Z404]  logo asset not found on disk:
'docs/assets/logo.svg' (declared as theme.logo: 'assets/logo.svg' in mkdocs.yml)
[Z404]

────────────────────────────────────────────────────────────────────────────────

Summary:  x 0 errors  ! 1 warning  i 0 info  · 1 file with findings

Analysis complete: All statically-detectable links, credentials, and references
verified.

Exit code: 0

Interpretare l'Output​

Il finding Z404 indica un problema CONFIG_ASSET_MISSING.

Questo avviso viene sollevato quando la configurazione del motore di build (es. mkdocs.yml, docusaurus.config.ts, o zensical.toml) fa riferimento a un asset locale tramite percorso, ma il file non esiste su disco:

  • Tipo di scansione: Config Asset Checker (specifico per engine)
  • Severità: Warning
  • Impatto: Deduce 3.0 punti DQS (categoria brand governance, peso 0.25).

Campi verificati in MkDocs Material:

  • theme.logo — risolto relativo a docs_dir
  • theme.favicon — risolto relativo a docs_dir

Risolvere il Problema​

Creare il file asset mancante:

mkdir -p docs/assets
# Aggiungere il logo SVG:
cp my-logo.svg docs/assets/logo.svg

Oppure aggiornare mkdocs.yml per puntare a un file esistente:

theme:
  name: material
- logo: assets/logo.svg
+ logo: assets/brand-icon.png

Vedi Anche​