MuninMunin
Log indKom gratis i gang
Home/Journal/Komponentgalleriet i Journal
Engineering · 6 min read

Komponentgalleriet i Journal

Én enkelt artikel, der bruger hver eneste typede blok, journalrendereren understøtter — manchet, prosa, infobokse, citater, redaktionelle lister, definitioner, figurer, nøgletal, hovedpointer og mere. Brug den på dev til at løbe renderingen igennem med øjnene efter en ændring.

Abstract placeholder cover image for the component demo article
Et pladsholderbillede i manchetten — beviser, at cover_image + billedtekst renderes.

Dette er manchetblokken. Den sætter tonen i en anelse større skrift, og den understøtter fremhævelse inline og links tilbage i journalen via referencer.

Prosablok

Prosablokken er ren markdown. Den renderer overskrifter, fremhævelse, inline-kode, eksterne links og lister:

  • Første punkt, med lidt længde på sig, så linjeombrydningen kan ses.
  • Andet punkt, der nævner snake_case_identifikatorer inline.
  • Tredje punkt.
  1. Nummereret én.
  2. Nummereret to.
  3. Nummereret tre.

Et andet afsnit følger, så afstanden mellem afsnit kan ses.

Notebox

Tonen note bruger infoikonet. Brødteksten er markdown, så kode og links virker også her.

Tipboks

Tonen tip bruger pæreikonet.

Advarselsboks

Tonen warn bruger advarselstrekantikonet. God til faldgruber.

Et udtrækscitat løfter en linje ud i visningsstørrelse for at bryde spalten op.Blokken pull_quote

Det tilskrevne citat renderer en avatar med initialer og tilskrivningslinjen nedenunder.

ALAda Lovelace · Ingeniør

Mørk aside

Aside-blokken er en mørk, indrammet note med valgfri kicker og tilskrivning — visuelt forskellig fra infoboksene.

Sidebemærkning

To nøgle/værdi-lister

editorial_list og definitions er begge rækker med nøgle og værdi. De adskiller sig i, hvor meget vægt nøglen kan bære. Læs nøglen højt: et ord eller et tal er en redaktionel liste, en frase er en definitionsliste. Hvis værdierne strækker sig forbi fire linjer, så brug ingen af dem — h3-mellemrubrikker med afsnit, eller en rigtig tabel.

Den redaktionelle liste kommer først: en smal spalte med spærret monoskrift, nøgler på ét ord, én eller to linjer værdi. Nøglen er ramme, ikke indhold.

  • TypetHver blok valideres mod skemaet, før den renderes.
  • HeadlessIndholdet hentes fra leverings-API'et på byggetidspunktet.
  • PortabeltDe samme blokke renderes på marketingsitet og i forhåndsvisningen.

Nu samme form med en frase som nøgle. Spalten på 196px giver den plads, nøglen sættes i halvfed med stort begyndelsesbogstav, og hver værdi kan strække sig til et kort afsnit. Dette er en taksonomi — navngivne kategorier, som læseren sammenligner ned gennem spalten.

  • Per handlingSalesforce. Flex Credits måler agentens indsats — 20 kreditter for en Agentforce-handling, 30 for Voice. Ærligt om, hvad der koster leverandøren penge, og en løkke, der prøver igen to gange, fakturerer dig tre gange.
  • Per verificeret løsningZendesk, til en offentliggjort pris på 1,50 dollar. To af de tre niveauer er gratis — kun en verificeret løsning trækkes. Mest ingeniørarbejde nogen har lagt i at definere det, de fakturerer for.
  • Per udfaldIntercom, til 0,99 dollar, opkrævet højst én gang per samtale. Forsøg faktureres ikke, og en løsning trækkes fra, hvis kunden vender tilbage.

To slags fremhævelse bor inde i en definitionsværdi. **Dobbelte stjerner** renderes som .term — blækfarvet kursiv, til et begreb, der defineres. *Enkelte stjerner* renderes som <em> i koboltblå antikva, forbeholdt den ene frase per post, der bærer argumentet. Koboltindekset over hver nøgle er en CSS-tæller, så nummerér aldrig nøglerne i hånden.

Placeholder figure A
Én figur i spaltebredde med billedtekst.
Placeholder figure B
En figur i fuld bredde, der bryder ud forbi tekstspalten.
Placeholder figure APlaceholder figure B
Et figurpar renderet side om side.
typescriptrender.ts
export function render(blocks: Block[]) {
  return blocks.map((b) => renderers[b.type]?.(b.props));
}
15
bloktyper
99,9 %
oppetid
1 t
levetid for forhåndsvisningstoken

Gitteret med nøgletal er en flexrække, der ombrydes, så en kort sidste række strækker sig for at fylde bredden i stedet for at efterlade døde celler. Fire elementer lægges ud som 2×2 frem for 3 + 1; fem giver tre og derefter to i halv bredde; syv giver tre, tre og derefter én i fuld bredde.

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

Hovedpointer

  • Hver typet blok har en tilsvarende renderer.
  • Inline-markdown virker inde i de fleste blokke.
  • Figurer slår asset-id'er op til offentlige URL'er via leverings-API'et.

Notes

  1. Første fodnote, med et link og lidt kode.
  2. Anden fodnote for at vise nummereret rækkefølge.
— Genereret fixture, kun til dev