Script • Python drift og automatisering

Doctype-konverter for enkeltsider

Python-snutt som bytter XHTML-doctype til HTML5 for lokale filer.

from pathlib import Path

def convert_doctype(path: str) -> None:
    file = Path(path)
    text = file.read_text(encoding='utf-8')
    text = text.replace('<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http:
Weboracle
18.07.20260 visningerPYTHON

Python-snutt som bytter XHTML-doctype til HTML5 for lokale filer.

Doctype-konverter for enkeltsider er laget for praktisk bruk i et innholdsdrevet nettsted. Målet er å gi en liten, forståelig byggestein som kan testes lokalt før den settes inn i en større arbeidsflyt.

Illustrasjon til Doctype-konverter for enkeltsider
Scriptet bør brukes sammen med logging, testdata og tydelig feilhåndtering.

Bruksområde

Python-snutt som bytter XHTML-doctype til HTML5 for lokale filer. Scriptet passer best når redaktør eller utvikler trenger en avgrenset kontroll, ikke et stort rammeverk. Det er skrevet for å være lett å lese, lett å endre og enkelt å feilsøke.

Slik bør du bruke det

Kjør scriptet mot et lite datasett først. Les resultatet, kontroller feilmeldinger og legg deretter inn egne grenser for produksjonsdata. For XHTML er det spesielt viktig å skille mellom eksempeldata, testmiljø og faktisk publisering.

  • Start med en kopi av data eller filer.
  • Logg hva som kontrolleres.
  • Stopp trygt ved uventet format.
  • Dokumenter endringen før publisering.

Vedlikehold

Når scriptet tas i bruk over tid bør du knytte det til en enkel sjekkliste: hvem kjørte kontrollen, hvilket område ble kontrollert, og hvilke funn ble rettet. Da blir scriptet en del av redaksjonell kvalitetssikring, ikke bare en løs kodebit.

Når dette scriptet passer

Doctype-konverter for enkeltsider passer når du trenger en liten og avgrenset byggestein i XHTML-arbeidet ditt. Scriptet er ment å være lett å lese, lett å teste og lett å flytte inn i et større prosjekt uten at du må endre resten av systemet først.

Bruk det først i et testmiljø. Kontroller input, forventet output og feilhåndtering før du lar det bli en del av en publiseringsflyt. Små scripts er ofte mest nyttige når de gjør én ting tydelig og rapporterer feil på en måte som kan forstås senere.

Illustrasjon til Doctype-konverter for enkeltsider
Figuren viser scriptet som en liten komponent mellom input, validering og kontrollert resultat.

Bruksmåte

Start med å lese koden fra topp til bunn og noter hvilke verdier som kommer utenfra. Deretter tester du med normal input, tom input og én feilaktig verdi. Denne enkle tredelingen fanger mange problemer før scriptet havner på en offentlig side eller i en automatisert jobb.

Tilpasning: behold funksjonsnavn og returformat stabile dersom scriptet brukes av andre deler av prosjektet. Endre heller tekst, grenseverdier og stioppsett rundt scriptet enn å gjøre kjernelogikken vanskeligere å følge.

Sikkerhet og vedlikehold

Scriptet bør ikke stole blindt på filstier, skjema-data eller nettverksrespons. Legg inn tydelige sjekker, korte feilmeldinger og trygg escaping når resultatet skal vises i nettleseren. For databasebruk bør prepared statements og transaksjoner vurderes.

Dokumenter til slutt hva scriptet forventer og hva det returnerer. En kort kravtekst gjør scriptbiblioteket mer nyttig for lesere, og den gjør det lettere å finne riktig script senere.