Innebygd redigering i nettleseren

Du redigerer innhold direkte i nettleseren i et visuelt tekstverktøy – ingen Markdown- eller Git-kunnskap nødvendig. Alle vanlige redaktøroppgaver er tilgjengelige fra «Endre»-menyen øverst til høyre i headeren.

Hva du trenger

• En GitHub-konto (opprett gratis på github.com) – det er alt som trengs

Skrivetilgang er ikke nødvendig. Uten skrivetilgang sendes endringene dine som et endringsforslag (pull request) som en redaktør ser over og godkjenner. Med skrivetilgang publiseres endringen direkte. I begge tilfeller brukes nøyaktig samme grensesnitt – menynavnene tilpasses automatisk.

Om GitHub-autorisasjonen

Første gang du bruker redigeringsfunksjonene, ber SAMT-BU Docs om tilgang til GitHub-kontoen din via en innloggingspopup. Du vil se at appen ber om tilgang til offentlige repositorier («public repositories») som du har rettigheter til.

Det betyr at SAMT-BU Docs teknisk sett kan lese og skrive til alle offentlige GitHub-repositorier kontoen din har tilgang til – ikke bare de repoene SAMT-BU Docs faktisk bruker. Tilgangen brukes utelukkende til å lagre innhold i SAMT-BU-repoene.

Under arbeid: Vi jobber med å sette opp en GitHub App som begrenser autorisasjonen til kun de spesifikke repoene SAMT-BU Docs bruker. Inntil videre gjelder den bredere tilgangen beskrevet over.

Trekke tilbake autorisasjonen

Du kan når som helst trekke tilbake tilgangen:

1. Logg inn på github.com
2. Gå til Innstillinger (klikk på profilbildet øverst til høyre → Settings)
3. Velg Applications i venstremenyen
4. Klikk på fanen Authorized OAuth Apps
5. Finn SAMT-BU Docs i listen og klikk Revoke

Etter at du har tilbakekalt tilgangen, vil du bli bedt om å logge inn på nytt neste gang du bruker redigeringsfunksjonene.

Redigere en eksisterende side

1. Gå til siden du vil redigere
2. Klikk «Endre»-menyen øverst til høyre i headeren
3. Velg «Rediger denne siden»
4. Logg inn med GitHub-kontoen din hvis du ikke allerede er innlogget (popup-vindu)
5. Gjør endringene dine i det visuelle tekstverktøyet
6. Klikk «Lagre»

Tips: Bilder kan limes direkte inn i tekstfeltet (Ctrl+V eller høyreklikk → Lim inn).

Skrivetilgang: Endringen publiseres direkte. Uten skrivetilgang: Det opprettes automatisk et endringsforslag (pull request). Du ser «Foreslå endring av dette kapitlet» i stedet for «Rediger denne siden» i menyen, og etter lagring vises en lenke til forslaget. En redaktør ser over og godkjenner.

Nettstedet oppdateres automatisk etter lagring. En statusindikator nede til venstre i skjermen holder deg oppdatert underveis.

Opprette en ny side

1. Gå til siden du vil plassere den nye siden ved siden av (søsken) eller under (underkapittel)
2. Klikk «Endre» og velg:
   • «Nytt kapittel etter dette» – ny side på samme nivå som den du er på
   • «Nytt underkapittel» – ny side ett nivå ned under den du er på
3. Fyll inn tittel og eventuelt innhold i dialogen
4. Klikk «Lagre»

Uten skrivetilgang vises «Foreslå nytt kapittel etter dette» / «Foreslå nytt underkapittel» i stedet. Forslaget sendes som en pull request og en lenke vises etter at du har klikket «Lagre».

Flytte et kapittel

1. Gå til siden du vil flytte
2. Klikk «Endre»-menyen øverst til høyre
3. Velg «Flytt dette kapitlet» – en dialog åpnes og Endre-menyen grås ut
4. Naviger i menyen til stedet du ønsker
5. Klikk «Flytt hit (før)» for å plassere det før valgt side, eller «Flytt hit (etter)» for å plassere det etter

Klikk «Avbryt» i dialogen for å avbryte uten å gjøre endringer. Nettstedet oppdateres automatisk etter at flyttingen er fullført.

Merk: Flytt-funksjonen krever skrivetilgang og støtter ikke forslagsflyt (pull request).

Slette en side

1. Gå til siden du vil slette
2. Klikk «Endre»-menyen øverst til høyre
3. Velg «Slett denne siden»
4. Bekreft i dialogen

Siden og begge språkversjoner (norsk og engelsk) slettes i ett og samme trinn. Nettstedet oppdateres automatisk etter sletting.

Uten skrivetilgang vises «Foreslå sletting av denne siden» i stedet. Forslaget sendes som en pull request og en lenke vises etter bekreftelse.

Merk: Sletting er ikke umiddelbart reverserbart via grensesnittet. Kontakt en administrator dersom du har slettet en side ved en feil.

Gi tilbakemelding

Har du et innspill, en feil å melde eller et spørsmål til innholdet på en side – uten at du vil redigere direkte – kan du bruke «Gi kommentar»-funksjonen:

1. Gå til siden det gjelder
2. Klikk «Endre»-menyen og velg «Gi kommentar»
3. Logg inn med GitHub-kontoen din hvis du ikke allerede er innlogget
4. Fyll inn tittel (forhåndsutfylt med sidenavn) og skriv kommentaren din
5. Legg eventuelt til lenke til et spesifikt avsnitt i feltet «Spesifikk del av siden»
6. Klikk «Send»

Kommentaren registreres som en GitHub Issue knyttet til siden. Du får en lenke til issuen etter innsending, og kan følge den videre der.

Alternativt kan du bruke «Kommentarer»-knappen i bunnlinjen for å se eksisterende kommentarer på siden og åpne en ny kommentardialog derfra.

Statusindikator og jobbhistorikk

Indikatoren nede til venstre er alltid synlig og viser gjeldende tilstand:

Klikker du på indikatoren åpnes en jobbhistorikk-dialog som viser de siste byggejobber med status, tidspunkt og lenke til GitHub Actions. Her kan du se:

• 🔄 Kjørende jobb – med antall sekunder siden den startet
• 🕐 Jobb i kø – venter på tur
• ✅ Fullført
• ✅ (grå) Avløst av nyere bygg – se forklaring under

Om byggetid og køer

Nettstedet bygges av GitHub Actions. Normalt tar et bygg ca. 1 minutt. Hvis du eller andre lagrer flere sider raskt etter hverandre, kan ventetiden bli lengre fordi byggejobber kjøres én om gangen:

• 2 lagringer etter hverandre: andre jobb venter til første er ferdig – totaltid ca. 2 min
• 3 eller flere raske lagringer: GitHub kan avløse eldre jobber i kø med den nyeste. Det betyr at en jobb i historikken kan vises som «Avløst» i stedet for fullført – dette er normalt og betyr ikke at noe gikk galt. Alle lagrede endringer er registrert i Git og vil bli publisert av den siste jobben som kjøres.

Kort sagt: Ser du grå hake og teksten «Avløst» i jobbhistorikken, er ikke endringen tapt – den ble publisert av en nyere jobb.