Kom i gang som ny redaktør i Aksel
Hvordan skrive og publisere innhold i Aksel.
Aksel er nå live og vi ønsker alle som føler de har noe å bidra med får muligheten til det. Målet til Aksel er å være en åpen platform der alle som ha tanker, ideer eller erfaringer får muligheten til å dele dem med resten av organisasjonen eller utenfor. Lurer du på om ditt innhold eller dine erfaringer passer inn i Aksel? Send oss en melding på slack #aksel så finner vi ut av det sammen! Anbefaler også å se raskt over FAQ lengre ned på siden før du publiserer noe innhold.
Tilgang til studio/redaktørverktøy
Redaktørverktøyet til Aksel er i dag bygd med Sanity, et headless CMS som har gjort redaktøropplevelsen til Aksel og Designsystemet mye bedre.
Alle NAV IT ansatte skal ha muligheten til å kunne logge inn i studioet til Aksel ved hjelp av SSO. For å kunne gjøre dette må man først gi seg selv de rette tilgangene nevnt under.
Skaffe tilgang til SSO
Gå til MyApps(myapplications.microsoft) og velg "Legg til nye apper/Request new apps" øverst til høyre. Der bør man da kunne se Sanity som et valg. Hvis sanity ikke dukker opp kan det hende du må oppdatere siden noen ganger da det er en kjent feil. Velg "legg til/add". Du skal da i løpet av ~5 minutter ha fått de riktige tilgangene for logge inn med SSO.
Logge inn
Neste steg da er å logge inn i studioet/redaktørverktøyet vårt.
Studioet kan nås via nettsiden vår på url aksel.nav.no/studio , eller direkte på verktoykasse.sanity.studio . Her vil man får en prompt som spør deg om å logge inn. Velg "NAV SSO" og hvis du er alt stemmer kommer du rett inn. Her kan det hende du blir spurt om hvilken organisasjon du tilhører, og da må man skrive "navikt" før du logger inn.
Tilganger
Studioet har muligheten til å styre tilganger og regler for hvem som kan se, redigere og publisere innhold. Vi ønsker å holde redaktøropplevelsen så lett og åpen som mulig, så vi forholder oss til relativt enkelt oppsett av tilganger. Dette kan selvfølgelig justeres etterhvert som behovet oppstår.
Som standard har alle ny-innloggede bare lese-tilgang. Dette gir deg mulighetene til å se alt innholdet i studioet, men ikke redigere eller publisere noe. Hvis du trenger mulighet til redigering/publisering så kan du ta kontakt med personene nevnt nederst i artikkelen. Du kan se tilgangene dine ved å åpne dashboard -> project-users
inne i sanity.
Lag en "profil" (valgfritt)
For å lettere holde oversikt over de artiklene du selv jobber eller bidrar til kan man lage en "profil" som man kan linke til dokumentene. Trykk på "Create new document" øverst til venstre og så "Bruker/Redaktør". Fyll inn nødvendig informasjon for så å publisere profilen.
Hvis du så oppdaterer siden vil du forhåpentligvis ha et nytt menypunkt "Profil". Her vi du kunne se dine roller/tilganger og sider du jobber med. Alle artikkel-dokumenter har et eget felt under Innstillinger som heter "Redaktører". Der man må legge seg selv til for å linke siden til din profil.
Vi oppfordrer også alle til å sjekke at de ikke har noen "Utdaterte sider" der. Hvis du har det så kan det være lurt å lese gjennom de relevante sidene for å se om innholdet fortsatt er relevant.
Skrive og publisere innhold
Det er relativt lett å opprette, redigere og publisere artikler i studioet. Vi anbefaler alle å teste seg litt frem, da studioet vil være et nytt og ukjent arbeidsverktøy for de fleste. Det er lov å gjøre feil her! Vi kjører daglig backup på alt og studioet har versjonskontroll på alle endringer som blir gjort. Publiserte du en noe med en feil eller redigerte noe som du ikke skulle så er det lett å reversere endringen.
Når man publiserer en artikkel eller blogg vil den etter kort tid bli tilgjengelig på nettsiden, det samme gjelder når man har publisert nye endringer.
Tips
Forhåndsvisningen for siden du jobber med blir automatisk oppdatert når du redigerer innholdet i Sanity. Anbefales derfor å åpne forhåndsvisning og editor side om side for en bedre redaktøropplevelse.
Alle redaktører som er innlogget i sanity vil ha en "Rediger side" knapp rett over footer på publiserte sider. Bruk denne for å lett finne siden og redigere den.
Legg til de som jobber med siden under "Redaktører"-feltet. Vil da være lettere for alle å se hvem som jobber med de forskjellige sidene.
Bruk en kort tittel om mulig, eks "Testing i NAV", ikke "Hvordan bør man jobbe med Testing i NAV". La hovedpunktet, her "Testing" komme frem så tidlig som mulig. Dette gjør siden lettere å finne i søk og når ved rask skanning.
URL blir generert basert på tittel som standard, men vi anbefaler å forkorte den/gjøre den mer lesbar om mulig. Anbefaler også å ikke bruke æøå i url.
FAQ
Jeg vil ikke at noen utenfor NAV skal kunne lese artikkelen min
Aksel er i grunn ment til å være en åpen side der alt er tilgjengelig for alle, men som alt annet finnes det selvfølgelig unntak! Det er ikke mulig akkurat nå å publisere innhold bare for NAV-ansatte, men det jobbes med en løsning der vi har innlogging for ansatte og kan da gjemme artikkel-innhold bak innlogging. Dette vil si at du må regne alle publiserte artikler som åpne for personer utenfor NAV.
Hva med ikke publisert innhold?
Datasettet er privat og forhåndsvisning/preview er bare tilgjengelig for innloggde brukere her i Sanity. Dette vil si at alt ikke-publisert innhold ikke er tigjengelig for alle før det blir publisert. Med en gang man trykker publiser vil artikkelen bli tilgjengelig for alle.
Viktig! Studioet/Aksel skal ikke forvalte/inneholde "sikker" data som bare ansatte skal ha tilgang til. Trenger du den muligheten anbefaler vi å heller linke til dataen på eks sharepoint.
Panikk, jeg publiserte noe som jeg ikke skulle 😱
Frykt ikke, det fikses lett! Her kan du enten avpublisere ("unpublish") artikkelen om den ikke tidligere var publisert. Eller hvis artikkelen allerede var publisert og du publiserte en uønsket endring kan du velge en tidligere versjon, publisere den versjonen og så velge den "nye" versjonen som du jobbet med for å fortsette redigeringen før publisering.
Noe som mangler her?
Send oss en melding eller legg til feedback så fikser vi!
Kontakt
Aksel nettside og studio er forvaltet av Aksel/Designsystem teamet. Ta kontakt på direktemelding, eller mer generelt i slack-kanalen vår #aksel .
Moderatorer
- Eidar Grande Vollan, Kontorsjef
- Ken Aleksander Johansen, Utvikler
- Sjur Grønningsæter, Produktdesigner