Passa al contenuto principale

Z401-missing-directory-index — Directory Senza Indice

Z-Code: Z401 MISSING_DIRECTORY_INDEX · Engine: zensical · Exit: 0

zenzic check all --show-info
zensical - 1 file (1 docs, 0 assets) - 0.0s - 68 files/s
docs/guide
💡[Z401]Directory contains Markdown files but has no index page — the directory URL may return a 404.
────────────────────────────────────────────────────────────────────────────────
Summary:✘ 0 errors⚠ 0 warnings💡 1 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/z401-missing-directory-index/ nel repository Zenzic. Utilizza l'engine Zensical (richiede zensical.toml).

La directory docs/guide/ contiene page.md ma non ha index.md:

docs/
  guide/
    page.md   ✓ esiste
    index.md  ✘ mancante

Quando il sito viene costruito, visitare /guide/ restituisce un 404 perché nessuna pagina corrisponde a quell'URL di directory:

examples/z401-missing-directory-index/.zenzic.toml
docs_dir = "docs"
fail_under = 0

[build_context]
engine = "zensical"

Eseguire l'Esempio​

# Clona il repository Zenzic — nessuna installazione richiesta
cd examples/z401-missing-directory-index
uvx zenzic check all --show-info
informazioni

Z401 è un finding di tipo info — è soppresso di default per mantenere l'output CI conciso. Usa --show-info per renderlo visibile.

Output atteso:

zensical · 1 file (1 docs, 0 assets) · 0.0s · 68 files/s

docs/guide  i  [Z401]  Directory contains Markdown files but has no index page
— the directory URL may return a 404.

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

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

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

Exit code: 0

Interpretare l'Output​

Il finding Z401 indica un problema MISSING_DIRECTORY_INDEX.

I motori di documentazione che usano URL in stile directory (es. /guide/ invece di /guide.html) richiedono che ogni directory navigabile abbia un index.md (o index.mdx) come pagina di atterraggio. Senza di esso, il motore di build può silenziosamente omettere l'URL della directory o restituire un 404:

  • Tipo di scansione: Structure Validator (engine zensical)
  • Severità: Info
  • Impatto: Deduce 2.0 punti DQS (categoria navigazione, peso 0.25).

Risolvere il Problema​

Creare docs/guide/index.md come pagina di atterraggio per la sezione:

touch docs/guide/index.md

Oppure rinominare page.md in index.md se è l'unica pagina nella directory:

mv docs/guide/page.md docs/guide/index.md

Vedi Anche​