Passa al contenuto principale

Z104-file-not-found — Destinazione del Link Mancante

Z-Code: Z104 FILE_NOT_FOUND · Engine: standalone · Exit: 1

zenzic check all
standalone - 1 file (1 docs, 0 assets) - 0.0s - 67 files/s
docs/index.md:11:44
✘[Z104]'api/reference.md' not found in docs
9│ ## API Reference
10│
11❱For the complete API specification, see the [API Reference](api/refer…
12│ The API reference contains all endpoints, request formats, and respo…
13│
────────────────────────────────────────────────────────────────────────────────
Summary:✘ 1 error⚠ 0 warningsℹ 0 info- 1 file with findings
FAILED: Hard errors detected. Exit code 1 is mandatory.
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 1

Il Fixture​

Il fixture si trova in examples/z104-file-not-found/ nel repository Zenzic. Il documento sorgente è docs/index.md, che contiene un link verso api/reference.md — un file inesistente su disco:

RigaLinkDestinazioneEsiste?
11[API Reference](api/reference.md)docs/api/reference.md✘
examples/z104-file-not-found/.zenzic.toml
docs_dir = "docs"
fail_under = 0

[build_context]
engine = "standalone"

Eseguire l'Esempio​

# Clona il repository Zenzic — nessuna installazione richiesta
cd examples/z104-file-not-found
uvx zenzic check all

Output atteso:

standalone · 1 file (1 docs, 0 assets) · 0.0s · 67 files/s

docs/index.md:11:44  x  [Z104]  'api/reference.md' not found in docs

     9  │  ## API Reference
    10  │
    11  ❱  For the complete API specification, see the [API Reference](api/refer…
    12  │  The API reference contains all endpoints, request formats, and respo…
    13  │

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

Summary:  x 1 error  ! 0 warnings  i 0 info  · 1 file with findings

FAILED: Hard errors detected. Exit code 1 is mandatory.

Exit code: 1

Interpretare l'Output​

Il finding Z104 indica un problema FILE_NOT_FOUND.

Questo errore viene sollevato quando un link relativo in una pagina Markdown punta a un percorso che non esiste nell'albero docs_dir. A differenza di Z101 LINK_BROKEN (che copre problemi di routing strutturale), Z104 è il segnale preciso per un file system mancante:

  • Tipo di scansione: Link Validator
  • Severità: Error
  • Impatto: I link a file mancanti rompono la navigazione e deducono 8.0 punti DQS — la penalità più alta del gruppo Z1xx.

Risolvere il Problema​

  1. Creare il file mancante in docs/api/reference.md.
  2. Oppure correggere la destinazione del link in docs/index.md.
- For the complete API specification, see the [API Reference](api/reference.md).
+ For the complete API specification, see the [API Reference](api/index.md).

Vedi Anche​