MuninMunin
Logg innKom i gang gratis
Home/Journal/Komponentgalleriet i Journal
Engineering · 6 min read

Komponentgalleriet i Journal

Én enkelt artikkel som bruker hver eneste typede blokk journalgjengiveren støtter — ingress, prosa, framhevingsbokser, sitater, redaksjonelle lister, definisjoner, figurer, nøkkeltall, hovedpunkter og mer. Bruk den på dev til å øyne gjengivelsen etter en endring.

Abstract placeholder cover image for the component demo article
Et plassholderbilde i ingressen — beviser at cover_image + bildetekst gjengis.

Dette er ingressblokken. Den setter tonen i litt større skrift, og den støtter utheving inline og lenker tilbake i journalen via referanser.

Prosablokk

Prosablokken er ren markdown. Den gjengir overskrifter, utheving, inline-kode, eksterne lenker og lister:

  • Første punkt, med litt lengde på seg så linjebrytingen blir synlig.
  • Andre punkt som nevner snake_case_identifikatorer inline.
  • Tredje punkt.
  1. Nummerert én.
  2. Nummerert to.
  3. Nummerert tre.

Et andre avsnitt følger, så avstanden mellom avsnitt blir synlig.

Merknadsboks

Tonen note bruker infoikonet. Brødteksten er markdown, så kode og lenker fungerer her også.

Tipsboks

Tonen tip bruker lyspæreikonet.

Advarselsboks

Tonen warn bruker varseltrekantikonet. Bra for fallgruver.

Et uttrekkssitat løfter en linje ut i visningsstørrelse for å bryte opp spalten.Blokken pull_quote

Det attributterte sitatet gjengir en avatar med initialer og attribusjonslinjen under.

ALAda Lovelace · Ingeniør

Mørk aside

Aside-blokken er en mørk, innrammet merknad med valgfri kicker og attribusjon — visuelt forskjellig fra framhevingsbokser.

Sidebemerkning

To nøkkel/verdi-lister

editorial_list og definitions er begge rader med nøkkel og verdi. De skiller seg i hvor mye vekt nøkkelen kan bære. Les nøkkelen høyt: et ord eller et tall er en redaksjonell liste, en frase er en definisjonsliste. Hvis verdiene strekker seg forbi fire linjer, bruk ingen av dem — h3-mellomtitler med avsnitt, eller en ekte tabell.

Den redaksjonelle listen kommer først: en smal spalte med sperret monoskrift, nøkler på ett ord, én eller to linjer verdi. Nøkkelen er ramme, ikke innhold.

  • TypetHver blokk valideres mot skjemaet før den gjengis.
  • HeadlessInnholdet hentes fra leverings-API-et på byggetidspunktet.
  • PortabeltDe samme blokkene gjengis på markedssiden og i forhåndsvisning.

Nå samme form med en frase som nøkkel. Spalten på 196px gir den plass, nøkkelen settes i halvfet med stor forbokstav, og hver verdi kan strekke seg til et kort avsnitt. Dette er en taksonomi — navngitte kategorier leseren sammenligner nedover spalten.

  • Per handlingSalesforce. Flex Credits måler agentens innsats — 20 kreditter for en Agentforce-handling, 30 for Voice. Ærlig om hva som koster leverandøren penger, og en løkke som prøver på nytt to ganger fakturerer deg tre ganger.
  • Per verifisert løsningZendesk, til en publisert pris på 1,50 dollar. To av de tre trinnene er gratis — bare en verifisert løsning trekkes. Mest ingeniørarbeid noen har lagt i å definere det de fakturerer for.
  • Per utfallIntercom, til 0,99 dollar, belastet høyst én gang per samtale. Forsøk faktureres ikke, og en løsning trekkes fra hvis kunden kommer tilbake.

To typer utheving lever inne i en definisjonsverdi. **Doble stjerner** gjengis som .term — blekkfarget kursiv, for et begrep som blir definert. *Enkle stjerner* gjengis som <em> i koboltblå antikva, forbeholdt den ene frasen per oppføring som bærer argumentet. Koboltindeksen over hver nøkkel er en CSS-teller, så nummerer aldri nøklene for hånd.

Placeholder figure A
Én figur i spaltebredde med bildetekst.
Placeholder figure B
En figur i full bredde som bryter ut forbi tekstspalten.
Placeholder figure APlaceholder figure B
Et figurpar gjengitt side ved side.
typescriptrender.ts
export function render(blocks: Block[]) {
  return blocks.map((b) => renderers[b.type]?.(b.props));
}
15
blokktyper
99,9 %
oppetid
1 t
levetid for forhåndsvisningstoken

Rutenettet med nøkkeltall er en flex-rad som brytes, så en kort siste rad strekker seg for å fylle bredden i stedet for å etterlate døde celler. Fire elementer legges ut som 2×2 i stedet for 3 + 1; fem gir tre og så to i halv bredde; sju gir tre, tre og så én i full bredde.

15
blokktyper
99,9 %
oppetid
1 t
levetid for forhåndsvisningstoken
2×2
fire elementer, ingen foreldreløs celle

Hovedpunkter

  • Hver typede blokk har en tilhørende gjengiver.
  • Markdown inline fungerer inne i de fleste blokker.
  • Figurer slår opp asset-ID-er til offentlige URL-er via leverings-API-et.

Notes

  1. Første fotnote, med en lenke og litt kode.
  2. Andre fotnote for å vise nummerert rekkefølge.
— Generert fixture, kun for dev