---
title: "Migrering av Look Scanneds How-To-dokumentasjon til VitePress med forbedret sikkerhet"
description: "Se hvordan Look Scanned oppgraderte dokumentasjonsinfrastrukturen sin ved å migrere fra Vue + Vite til VitePress, samtidig som npm Trusted Publishers med OIDC ble innført for sikre, tokenfrie pakkeutgivelser."
date: 2025-12-19T07:55:33.000Z
lang: no
source: https://lookscanned.io/no/blog/migrating-look-scanned-how-to-to-vitepress
tags: ["vitepress", "dokumentasjon", "sikkerhet", "cicd", "npm"]
---

# Migrering av Look Scanneds How-To-dokumentasjon til VitePress med forbedret sikkerhet

Hos [Look Scanned](https://lookscanned.io) forbedrer vi kontinuerlig infrastrukturen vår for å tilby bedre dokumentasjon og sikrere utviklingspraksis. I dag er vi glade for å dele detaljer om en betydelig oppgradering av How-To-dokumentasjonssiden vår: migrering fra en tilpasset Vue + Vite-applikasjon til VitePress, samtidig som vi styrker CI/CD-sikkerheten vår med npm Trusted Publishers.

## 📚 Hvorfor vi migrerte til VitePress

How-To-dokumentasjonssiden vår ([github.com/lookscanned/how-to](https://github.com/lookscanned/how-to)) fungerer som den omfattende bruksguiden for Look Scanned. Selv om det tidligere Vue + Vite-oppsettet vårt fungerte bra, innså vi at VitePress ville være et bedre valg for en innholdsdrevet dokumentasjonsside.

### Hva er VitePress?

VitePress er en statisk nettstedgenerator spesielt laget for dokumentasjon. Bygget oppå Vite og Vue 3 kombinerer den det beste fra begge verdener: lynrask utvikleropplevelse med kraftige dokumentasjonsfunksjoner rett ut av boksen.

### Sentrale fordeler ved migreringen

**🎯 Bedre arkitektur for dokumentasjon**
- **Filbasert routing**: Hver markdown-fil blir automatisk en side, noe som gjør innholdsorganisering intuitiv
- **Innebygde dokumentasjonsfunksjoner**: Innholdsfortegnelse, søk, internasjonalisering og mer kommer ferdig konfigurert
- **Statisk nettstedgenerering**: Forhåndsrendret HTML gir utmerket SEO og øyeblikkelig sidelasting

**⚡ Forbedret utvikleropplevelse**
- **Umiddelbar varm omlasting**: Endringer vises umiddelbart under utvikling
- **Markdown først**: Fokus på innhold, ikke komponentoppsett
- **Støtte for Vue-komponenter**: Ved behov kan vi fortsatt bruke tilpassede Vue-komponenter inne i markdown

**🔧 Enklere vedlikehold**
- **Klarere struktur**: Dokumentasjonen følger konvensjoner, noe som reduserer kognitiv belastning for bidragsytere
- **Mer stabile bygg**: VitePress' meningssterke struktur gir mer reproduserbare bygg
- **Bedre samarbeid**: Teammedlemmer kan bidra med dokumentasjon uten dyp Vue-kunnskap

## 🔒 Forbedret sikkerhet med npm Trusted Publishers

Sammen med VitePress-migreringen innførte vi en kritisk sikkerhetsforbedring: **npm Trusted Publishers med OIDC-autentisering**.

### Problemet med tradisjonelle npm-tokener

Tidligere krevde publisering av pakker til npm at man lagret en langlevd `NPM_TOKEN` i repository-hemmeligheter. Denne fremgangsmåten har flere ulemper:

- **Sikkerhetsrisiko**: Tokener kan ved et uhell bli eksponert eller kompromittert
- **Forvaltningskostnad**: Tokener krever manuell rotasjon og oppdateringer
- **Revisjonsutfordringer**: Vanskelig å spore hvem som publiserte hva og når

### Løsningen: OIDC-basert betrodd publisering

[npm Trusted Publishers](https://docs.npmjs.com/trusted-publishers/) utnytter OpenID Connect (OIDC) for å muliggjøre sikker, tokenfri publisering direkte fra GitHub Actions. Slik fungerer det:

1. **Ingen lagrede hemmeligheter**: I stedet for å lagre tokener ber GitHub Actions om kortlevde legitimasjoner fra npm
2. **Identitetsverifisering**: npm bekrefter at publiseringsforespørselen kom fra det autoriserte GitHub-repositoriet
3. **Automatisk legitimasjonshåndtering**: Legitimasjoner utstedes automatisk og utløper raskt

### Fordeler i praksis

Denne endringen gir umiddelbare forbedringer i utviklingsarbeidsflyten vår:

- ✅ **Ingen mer tokenforvaltning**: Ikke lenger behov for å opprette, lagre eller rotere npm-tokener
- ✅ **Redusert angrepsflate**: Kortlevde legitimasjoner minimerer eksponeringsrisikoen
- ✅ **Bedre sporbarhet**: Hver publiseringshandling er koblet til en spesifikk GitHub Actions-kjøring
- ✅ **Moderne beste praksis**: I tråd med prinsippene for nulltillit-sikkerhet

**Teknisk merknad**: For å støtte npm Trusted Publishers oppdaterte vi CI-konfigurasjonen vår til å bruke Node.js `lts/*`, slik at vi har den nyeste npm-versjonen som kreves for OIDC-autentisering.

## 📦 Tidslinje for utgivelser

Migreringen ble fullført gjennom tre utgivelser 19. desember 2025:

- **v2.0.0**: Kjernemigrering fra Vue + Vite til VitePress (brytende endring)
- **v2.0.1**: CI-fiks for å støtte npm Trusted Publishers med riktig Node.js-versjon
- **v2.0.2**: Ytelsesforbedring ved å flytte `@fontsource/noto-mono` til devDependencies

## 🌍 Fortsatt flerspråklig støtte

En viktig merknad: How-To-dokumentasjonen vår genererer flerspråklige PDF-er som alltid har blitt brukt som eksempelfiler i hovedapplikasjonen Look Scanned (tilgjengelig på [lookscanned.io/en/scan](https://lookscanned.io/en/scan)). Denne VitePress-migreringen endrer ikke den funksjonaliteten — den gir rett og slett et bedre fundament for å vedlikeholde og forbedre dokumentasjonsinfrastrukturen vår.

## 💡 Hva dette betyr for brukere

Hvis du bruker Look Scanneds dokumentasjon:

- **Samme tilgang, bedre opplevelse**: Dokumentasjonen ligger fortsatt på samme URL, med forbedret lasting og navigering
- **Mer pålitelig**: Statisk nettstedgenerering betyr raskere lasting og bedre stabilitet
- **Bedre søk og oppdagelse**: VitePress' innebygde søk hjelper deg å finne svar raskere
- **Fortsatt PDF-støtte**: Flerspråklig PDF-generering fortsetter som før

## 🚀 Hva som kommer videre

Med infrastrukturoppgraderingen fullført, retter vi nå fokus mot innholdsforbedringer:

- **Utvidede bruksområder**: Flere praktiske eksempler og steg-for-steg-guider
- **Konsistensforbedringer**: Forfining av flerspråklig terminologi for klarhet
- **Forbedret PDF-eksport**: Bedre PDF-genereringsopplevelse på tvers av nettlesere

## Prøv Look Scanned i dag

Look Scanned tilbyr nettleserbaserte, personvernsfokuserte PDF-skanneeffekter uten å laste opp filene dine noe sted. Den forbedrede dokumentasjonen gjør det enklere enn noensinne å komme i gang.

👉 **Besøk [lookscanned.io](https://lookscanned.io) for å oppleve rask, sikker dokumentskanning i nettleseren din.**