Document list and card blocks

Lists the active documents the reader may open, paged, as cards. The cards are in the page's HTML, so a crawler is served them. With live_visit on, a reader who arrives by a live navigation sees skeleton cards first, and the cards stream in behind them. A document locked to permissions the reader does not hold is left out. The block declares no page_source and always reads for itself. Give the block an id. The sample pages show it in use. See Show documents on your site.

With show_details, the version shown is the one a reader lands on: the one marked latest, else the newest published. The page count is the pages the reader may read there, with groups that have no page of their own left out. The last change is the latest of the document, that version and those pages.

The words of the list are attributes:

Draws the pages filed under one page as cards, two a row from the sm breakpoint and one under it. Each card holds the page's title, any badges a plugin puts on it, its summary and a link. The summary is the description the page's own SEO gives it, else the start of its text. The block lists the version's approved pages the reader may read, under the parent the contents draw each one under and in their order. A group with no page of its own gives up its pages in its place.

An author places it in a page's text or in one of its notes, and doc-section fills in placed_in, doc_base, lang_param and version_param for it. A marker written inside a code block is shown as text and not drawn.

The Mishka Chelekom documentation uses it on the pages of its groups, such as Navigations, to list the components under each.

Draws one document as a card: its tile, its name, its summary, the version, pages and last change when handed them, the languages it is published in, and the way into it. The languages are plain badges, drawn only when the document is published in two or more of them on this site. A badge is not a link, because the site's header is where a reader changes language. doc-workspace-list draws each document with the card unless card names another component.

The card also takes read_text, featured_text, locked_text, unlisted_text, version_text, pages_text, one_page_text and updated_text, with the same defaults as in doc-workspace-list.

Draws the pager under a list: first, previous, where the reader is, next and last. With a base it writes links. Without one it writes buttons aimed at the block above it.

The four steps are first_text, previous_text, next_text and last_text, which default to "First", "Previous", "Next" and "Last".

Draws the box a block shows in place of its rows: a pulsing skeleton while it loads, a dashed box when there is nothing, and a red box with a way to ask again when a read failed. Five of the six live blocks draw their states with it. doc-switcher draws a small skeleton and error of its own, to fit the bar it sits in.

• Callouts, examples and the version placeholder.
• Plugin events: the badges on a card.