Basel Standard

Basel Standard / Docs

Editorial Resource List

Structured editorial links block for references, citations, and further reading.

Block / Resources

Curated links with the same editorial discipline.

Useful when a journal page or docs article needs source material without falling back to a generic list.

EditorialResourceList turns the tail end of an article into a deliberate references section. Instead of falling back to a plain unordered list, it gives each link a category, title, and note so source material and follow-up reading stay readable and consistent with the journal system.

Installation

Install
Purchase access, then open /account/install to issue a registry token.

Usage

import { EditorialResourceList } from "@/registry/swiss/blocks/editorial-resource-list"
<EditorialResourceList
  eyebrow="Further reading"
  title="Curated links with editorial discipline."
  resources={[
    {
      title: "Swiss layout reference",
      href: "https://example.com",
      category: "Reference",
      note: "Why this source matters to the article.",
    },
  ]}
/>

Why This Block Exists

References are often the last thing added to an article and the first thing to lose structure. This block keeps source material readable, categorized, and visually aligned with the rest of the page.

  • Use it for citations, follow-up reading, design references, or implementation notes.
  • Prefer it over a raw markdown list when the links need explanation.
  • Avoid it when the page only needs one inline source or a single CTA.

Examples

Standard Closing List

The default pattern is a small set of supporting links with a short explanation for each destination.

Block / Resources

Curated links with the same editorial discipline.

Useful when a journal page or docs article needs source material without falling back to a generic list.

Longer Source Section

The block also works for more substantial source lists, as long as each entry still earns its own note.

Sources

Longer reading lists still keep category and note structure.

A four-item version works well when the article closes with citations and implementation references.

<EditorialResourceList
  eyebrow="Sources"
  title="Longer reading lists still keep category and note structure."
  resources={resources.slice(0, 4)}
/>

In Context

Place the resource list after the article's main argument is complete. It should read as a postscript or appendix, not as a competing content section in the middle of the narrative.

Resource lists are most useful at the end of an article, where the main narrative is finished and the reader needs a clear postscript.

Further reading

A resource tail section for the journal.

Guidance

  • title should identify the destination clearly.
  • note should tell the reader what they gain from opening it.
  • category should help the reader scan by source type, not duplicate the title.

Keep The Tail Section Curated

  • Include the links that materially support the article.
  • If the list becomes long and repetitive, the section loses authority.
  • Group similar resources by category before adding more formatting.

Preserve The End-Of-Article Rhythm

  • Use this block near the close of a journal or docs page.
  • Pair it with prose sections and figure strips that precede it in the same editorial system.
  • If the links are operational actions rather than references, another list or card pattern will usually fit better.

API Reference

EditorialResourceList Props

PropTypeRequiredNotes
eyebrowstringyesSmall section label.
titlestringyesMain heading for the resources section.
descriptionstringnoOptional explanatory copy above the list.
resourcesEditorialResourceListItem[]yesArray of reference entries.

EditorialResourceListItem

FieldTypeRequiredNotes
titlestringyesHuman-readable destination title.
hrefstringyesLink target.
categorystringyesSmall uppercase source type label.
notestringyesSupporting explanation for the destination.

Internally the block uses ProseSection, ProseResources, and ProseBody, so it keeps the same spacing and typography rules as the surrounding editorial article.