Timeline

Share via

Use the timeline shortcode to show tems ordered on a vertical timelime.

Overview

Use the timeline shortcode to show tems ordered on a vertical timelime.

July 1, 2023

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Cupiditate ducimus officiis quod! Aperiam eveniet nam nostrum odit quasi ullam voluptatum. Lorem ipsum dolor sit amet, consectetur adipisicing elit. Cupiditate ducimus officiis quod! Aperiam eveniet nam nostrum odit quasi ullam voluptatum.

May 6, 2023

Lorem ipsum dolor sit amet.

February 4, 2023

Cupiditate ducimus officiis quod!

Beta release

November 30, 2022

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Cupiditate ducimus officiis quod! Aperiam eveniet nam nostrum odit quasi ullam voluptatum. Lorem ipsum dolor sit amet, consectetur adipisicing elit. Cupiditate ducimus officiis quod! Aperiam eveniet nam nostrum odit quasi ullam voluptatum.

July 1, 2023

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Cupiditate ducimus officiis quod! Aperiam eveniet nam nostrum odit quasi ullam voluptatum. Lorem ipsum dolor sit amet, consectetur adipisicing elit. Cupiditate ducimus officiis quod! Aperiam eveniet nam nostrum odit quasi ullam voluptatum.

May 6, 2023

Lorem ipsum dolor sit amet.

February 4, 2023

Cupiditate ducimus officiis quod!

Beta release

November 30, 2022

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Cupiditate ducimus officiis quod! Aperiam eveniet nam nostrum odit quasi ullam voluptatum. Lorem ipsum dolor sit amet, consectetur adipisicing elit. Cupiditate ducimus officiis quod! Aperiam eveniet nam nostrum odit quasi ullam voluptatum.

markdown
{{< timeline data="timeline-example" background="dark" >}}

Arguments

The shortcode supports the following arguments:

ArgumentRequiredDescription
dataYesRequired filename of the timeline input. See data format for the file requirements. You can omit the file extension. The file should reside in the data folder.
backgroundNoOptional border color of the connector dots, defaults to the body background color. If set, uses a subtle background color that is adaptive to the current color mode.

Data format

Define a file in the data folder that contains the timeline data. The format supports the following attributes:

AttributeRequiredDescription
titleYesRequired title of the timeline element.
iconYesRequired class and name of a Font Awesome icon to include. The icons use the icon shorthand notation.
colorNoOptional theme color of the timeline element, defaults to primary.
dateNoOptional date of the timeline element, placed below the title.
badgeNoOptional label of a pill badge placed next to the title.
urlNoOptional url of the timeline element, added as link to the title when set. The url is joined with the release attribute of the documentation configuration, unless the url is abolute (e.g. starts with http).
contentNoOptional content of the timeline element, supports markdown.

The following snippet defines a single timeline element in yml format.

- title: Product launch
  icon: fas rocket
  color: primary
  date: 2023-07-03
  badge: v0.15.3
  url: https://github.com/gethinode/hinode/releases/tag/v0.15.3
  content:
    Lorem ipsum dolor sit amet, consectetur adipisicing elit.
Last updated: July 4, 2023 • Rephrase background color (d2ba272)