Article listings

The cn:articles directive puts a live listing of a site’s published articles on a page, newest first. Use it on a landing page, a collection page or a news page. The listing is fetched when the page is served, so new articles appear without redeploying the page.

:::{cn:articles}
:layout: magazine
:title: Latest articles
:show-thumbnails: true
:show-authors: true
:show-date: true
:show-count: true
:::

While you work locally with curvenote start, the directive shows a placeholder that lists its options. The articles appear once the page is deployed with curvenote deploy.

Layouts

Choose a layout with :layout:. The default list sits in the body column like the rest of the page. cards, masonry and magazine span almost the full width of the screen, and start with a rule in the site’s primary color, set under Website & Design in Curvenote Sites. A site with no colors set shows the rule in the text color.

List

The default. Each article is a row with its title, description and the details you turn on, separated by a thin rule.

The list layout: one row per article in the body column, here with thumbnails, authors and dates.

Figure 1:The list layout: one row per article in the body column, here with thumbnails, authors and dates.

Cards

Equal-height cards in a grid, with the thumbnail on top. The grid drops a column at a time as the screen narrows.

The cards layout with a title and count, the collection above each title, and the date and DOI at the foot of each card.

Figure 2:The cards layout with a title and count, the collection above each title, and the date and DOI at the foot of each card.

Masonry

Up to four columns of articles that keep their thumbnail’s shape and show the start of the description, so the items vary in height. The columns reduce to one as the screen narrows.

The masonry layout: thumbnails at their own shape and descriptions of up to five lines, in columns separated by rules.

Figure 3:The masonry layout: thumbnails at their own shape and descriptions of up to five lines, in columns separated by rules.

Magazine

A front page: the newest article as a large lead with its description, the next four beside it, and the rest as a compact More latest list. With five articles or fewer there is no list.

The magazine layout: a large lead, four medium articles and a compact list of the rest, newest first.

Figure 4:The magazine layout: a large lead, four medium articles and a compact list of the rest, newest first.

Choosing the articles

These options decide which articles are listed. Without any of them, the listing shows the latest published articles from the site the page belongs to.

venue
The site to list articles from, by its name. Defaults to the current site.
collection
Only list articles in this collection, by its name.
status
published (the default) or in-review. Only applies together with collection.
submission-kind
Only list articles of this kind, by its name.
limit
The most articles to show. Defaults to 100, and can be up to 500.

Layout and heading

layout
list (the default), cards, masonry or magazine, described in Layouts.
title
A heading above the listing. Shown by cards, masonry and magazine.
show-count
When true, how many articles the listing holds, such as “Showing 12 of 407” or “12 articles”. Shown by cards, masonry and magazine.

Showing details

Each detail is off unless you set it to true.

show-thumbnails
Each article’s thumbnail image.
show-authors
The authors. Up to three names, then “et al.”.
show-date
The publication date.
show-doi
The article’s DOI.
show-collection
The collection name, above the title. Shown by cards, masonry and magazine.
show-kind
The kind of article, above the title. Shown by cards, masonry and magazine.

The directive renders as a curvenoteArticles node, so a site can restyle a layout with its own render plugin; Override and extend shows how to replace a built-in renderer.

Abbreviations
DOI
Digital Object Identifier
Previous
Site templates
Next
Overview
PrivacyGive Feedback