Utseende

Publikasjon

Tema, fargemodus, aksentfarge, skrifter og selve leseflaten, slik de står under Utseende i Innstillinger. Verdiene er faste nøkler fra palettene våre. Hver av dem er målt mot WCAG AA før den ble lagt til, og det er derfor ruta ikke tar imot en fargekode. Egne farger setter du under Finjustering, der vi kan måle dem mens du velger.

Alle sidene

Kom i gang

Guider

Referanse

Referanse

Plattform

Publikasjon

Nettsted

Nettbutikk

Videre

Kodeeksemplene kaller en skribb-funksjon du setter opp selv. Hent klienten for språket ditt og lim den inn én gang, så kan eksemplene under limes rett etter.

GET/v1/style

style:read

Hent utseendet

Tema, fargemodus, aksent og skrifter gjelder alt publikasjonen viser leserne: bloggen, nettstedet og butikken. Resten former lesesidene. skribbs egne sider er monokrome uansett hva publikasjonen velger.

Svaret · 200

stylePublicationStyle: Utseendet.

Svar

{
  "style": {
    "theme": "warm",
    "color_mode": "auto",
    "accent": "rust",
    "font": "literata",
    "heading_font": "default",
    "link_style": "default",
    "home_layout": "posts-first",
    "header_style": "default",
    "cover_style": "default",
    "reader_width": "default",
    "reader_size": "default",
    "reader_leading": "default",
    "syntax_highlight": false,
    "recipe_mode": false
  }
}

# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
skribb "/style"

PATCH/v1/style

style:write

Endre en eller flere av dem

Send de feltene du vil endre. Resten står. Sender du ingen av dem, svarer vi 422 empty-update. En verdi utenfor paletten blir avvist med en kode som navngir feltet, og svaret lister i allowed alt ruta ville tatt imot, så du kan rette den uten å slå opp. Det nye utseendet går ut til publikasjonen med en gang. Skulle vi ikke nå fram akkurat da, ligger det lagret her og går ut ved neste lagring.

Bodyen du sender

themestring: Fargetemaet. Det tinter hele flaten og bestemmer om siden starter lys eller mørk. default er den nøytrale flaten uten farge. Bytter du tema, nullstiller vi fargene publikasjonen har satt selv under Finjustering, og svaret sier fra med custom_colors_cleared.defaultwarmwhimsicalsobermidnightforesteditorialclinicalmonosandhigh-contrastduskslateocean
color_modestring: Lys eller mørk som utgangspunkt. auto følger temaets egen standard og deretter leserens system. Leserens egen bryter vinner uansett.autolightdark
accentstring: Aksentfargen: lenker, knapper og de små detaljene som skal skille seg ut. default er monokrom. En aksent du velger her, overstyrer den temaet kommer med.defaultbluegreenrustplumcrimsontealamberindigo
fontstring: Brødtekstskriften. default er Georgia. custom er skriftfilen publikasjonen har lastet opp selv, og den kan bare velges når det ligger en der.defaultserifwarm-serifsansmonoliteratanewsreaderfraunceswork-sanscustom
heading_fontstring: Overskriftsskriften. default lar overskriftene følge brødteksten.defaultserifwarm-serifsansmonoliteratanewsreaderfraunceswork-sanscustom
link_stylestring: Hvordan lenker i teksten ser ut.defaultsubtlebold
home_layoutstring: Hvordan forsiden settes sammen av innlegg og notater. Med notes-only står bare notatstrømmen på forsiden. Innleggene ligger fortsatt under Innlegg.posts-firstmixnotes-firstnotes-only
header_stylestring: Toppen av siden: logo til venstre, eller logo over en sentrert menyrad.defaultcentered
cover_stylestring: Hvordan forsidebildet vises øverst i et innlegg.defaultcompacthidden
reader_widthstring: Bredden på tekstspalten. default er 680 px.defaultnarrowwide
reader_sizestring: Størrelsen på brødteksten. default er 18 px.defaultsmalllarge
reader_leadingstring: Linjeavstanden i brødteksten.defaulttightairy
syntax_highlightboolean: Fargelegging av kodeblokker. Den laster et bibliotek hos leseren, og er derfor av som standard.
recipe_modeboolean: Oppskriftsmodus: ingredienslister og trinn blir avkryssbare. Vi utleder dem fra teksten, så oppskriften skrives som vanlig.

Svaret · 200

stylePublicationStyle: Utseendet slik det nå er.
custom_colors_clearedbooleanikke alltid med: Med når et nytt tema nullstilte fargene publikasjonen hadde satt selv. De var valgt mot paletten som gjaldt da, og målt mot den, så vi tar dem heller enn å blande to temaer. Skriftene, formene og tettheten står.

# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
skribb "/style" \
  -X PATCH \
  -H "content-type: application/json" \
  -d '{
    "theme": "warm",
    "accent": "rust"
  }'

Objekter

PublicationStyle

Utseendet på leserbloggen. Hver verdi er en fast nøkkel, aldri en farge.

Felter

themestring: Fargetemaet. Det tinter hele flaten og bestemmer om siden starter lys eller mørk. default er den nøytrale flaten uten farge. Bytter du tema, nullstiller vi fargene publikasjonen har satt selv under Finjustering, og svaret sier fra med custom_colors_cleared.defaultwarmwhimsicalsobermidnightforesteditorialclinicalmonosandhigh-contrastduskslateocean
color_modestring: Lys eller mørk som utgangspunkt. auto følger temaets egen standard og deretter leserens system. Leserens egen bryter vinner uansett.autolightdark
accentstring: Aksentfargen: lenker, knapper og de små detaljene som skal skille seg ut. default er monokrom. En aksent du velger her, overstyrer den temaet kommer med.defaultbluegreenrustplumcrimsontealamberindigo
fontstring: Brødtekstskriften. default er Georgia. custom er skriftfilen publikasjonen har lastet opp selv, og den kan bare velges når det ligger en der.defaultserifwarm-serifsansmonoliteratanewsreaderfraunceswork-sanscustom
heading_fontstring: Overskriftsskriften. default lar overskriftene følge brødteksten.defaultserifwarm-serifsansmonoliteratanewsreaderfraunceswork-sanscustom
link_stylestring: Hvordan lenker i teksten ser ut.defaultsubtlebold
home_layoutstring: Hvordan forsiden settes sammen av innlegg og notater. Med notes-only står bare notatstrømmen på forsiden. Innleggene ligger fortsatt under Innlegg.posts-firstmixnotes-firstnotes-only
header_stylestring: Toppen av siden: logo til venstre, eller logo over en sentrert menyrad.defaultcentered
cover_stylestring: Hvordan forsidebildet vises øverst i et innlegg.defaultcompacthidden
reader_widthstring: Bredden på tekstspalten. default er 680 px.defaultnarrowwide
reader_sizestring: Størrelsen på brødteksten. default er 18 px.defaultsmalllarge
reader_leadingstring: Linjeavstanden i brødteksten.defaulttightairy
syntax_highlightboolean: Fargelegging av kodeblokker. Den laster et bibliotek hos leseren, og er derfor av som standard.
recipe_modeboolean: Oppskriftsmodus: ingredienslister og trinn blir avkryssbare. Vi utleder dem fra teksten, så oppskriften skrives som vanlig.

← Alle rutene