Batch 10: Filnavn normalisering

Batch 10: Filnavn normalisering

Denne tutorialen viser en kontrollert måte å arbeide med filnavn normalisering i WEBoracle.

Mål

Målet er å gi et praktisk mønster som kan brukes igjen når innholdsbiblioteket vokser. Eksempelet er laget for Python drift og automatisering og legger vekt på lesbarhet, kontroll og vedlikehold.

Forberedelse

Start med å skrive hva som skal sjekkes, hvor dataene ligger, hvilke felter som er påkrevd, og hvilke avvik som skal stoppe publisering. Denne avgrensningen gjør CHECK tydeligere.

Gjennomføring

Bygg løsningen i små steg. Kontroller først navn og plassering, deretter innhold, og til slutt hvordan resultatet vises for en vanlig leser. Ikke bland designendringer og dataimport uten at det er nødvendig.

Testpunkter

Test med et normalt eksempel, et mangelfullt eksempel og et langt eksempel. Det avslører ofte feil i tekstflyt, validering, filnavn og rapportering.

Vanlige feil

Typiske feil er korte forklaringer, feil kategori, manglende bilde, ZIP-filer uten dokumentasjon og slugs som ligner for mye på hverandre. Disse må oppdages før APPLY.

Videre arbeid

Når mønsteret fungerer, kan det brukes i flere batcher. Da bygger WEBoracle et større bibliotek med samme struktur, i stedet for mange små ressurser som må tolkes på nytt hver gang.

Sjekkliste

• Kontroller kategori og tags.
• Kontroller at lokal illustrasjon finnes.
• Kontroller at tekst og kode forklarer bruken.
• Kontroller at rapporten viser null feil før APPLY.

Ved større innholdsvekst bør denne kontrollen gjentas konsekvent. Det gir mindre risiko og bedre verdi for leserne.

Utvidet kontroll i Batch 10

Når flere tutorials publiseres i samme omgang, bør strukturen være så lik at leseren raskt forstår oppsettet. Bruk samme rekkefølge for mål, forberedelse, gjennomføring, testpunkter og videre arbeid.

Dette gjør det enklere å sammenligne ressurser på tvers av Python, CSS3, HTML5 og XHTML, og det gjør senere vedlikehold mer presist.