There's a lot of open issues
No release in over a year
An asciidoctor extension that adds a list of figures, a list of tables, or a list of anything you want!
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
 Dependencies

Runtime

 Project Readme

asciidoctor-lists

Gem Test Build Latest Release Stars

An asciidoctor extension that adds a list of figures, a list of tables, or a list of anything you want!

Pull Requests are always welcome! :)

Important
With version 1.0.6 the syntax was changed from element_list::[element=image] to list-of::image[] to make it more intuitive.

Install

gem install asciidoctor-lists

Sample

Code

...

=== List of figures
list-of::image[]

=== List of tables
list-of::table[]

=== List of code snippets
list-of::listing[]

Rendered

Sample

Parameters

element

Specifies the element to be listed

enhanced_rendering (experimental)

Allows rendering links in the caption

hide_empty_section

Removes the section when no elements are found

Docker

# Build container
docker build -t asciidoctor-lists .
# Run Docker
docker run -it --rm -v $(pwd):/work asciidoctor-lists
# Build sample
asciidoctor-pdf -r asciidoctor-lists samples/list-sample.adoc

Dev setup

Run

asciidoctor -r ./lib/asciidoctor-lists.rb samples/list-sample.adoc

Install Gem

gem build asciidoctor-lists.gemspec
gem install asciidoctor-lists-x.x.x.gem

Docker Image